驅動開發：核心封裝WSK網絡通信接口

本章

LyShark

将帶大家學習如何在核心中使用标準的

Socket

套接字通信接口，我們都知道

Windows

應用層下可直接調用

WinSocket

來實作網絡通信，但在核心模式下應用層API接口無法使用，核心模式下有一套專有的

WSK

通信接口，我們對WSK進行封裝，讓其與應用層調用規範保持一緻，并實作核心與核心直接通過

Socket

通信的案例。

當然在早期如果需要實作網絡通信一般都會采用

TDI

架構，但在新版本

Windows10

系統上雖然依然可以使用TDI接口，但是

LyShark

并不推薦使用，因為微軟已經對接口擱置了，為了使WSK通信更加易用，我們需要封裝核心層中的通信API，建立

LySocket.hpp

頭檔案，該檔案中封裝了WSK通信API接口，其封裝格式與應用層接口保持了高度一緻，當需要在核心中使用Socket通信時可直接引入本檔案。

我們需要使用

WDM

驅動程式，并配置以下參數。

• 配置屬性 -> 連接配接器 -> 輸入-> 附加依賴 -> $(DDK_LIB_PATH)\Netio.lib
• 配置屬性 -> C/C++ -> 正常 -> 設定 警告等級2級 (警告視為錯誤關閉)

配置好以後，我們就開始吧，先來看看服務端如何實作！

對于

服務端

來說，驅動通信必須保證服務端開啟多線程來處理異步請求，不然驅動加載後系統會處于等待狀态，而一旦等待則系統将會卡死，那麼對于服務端

DriverEntry

入口說我們不能讓其等待，必須使用

PsCreateSystemThread

來啟用系統線程，該函數屬于WDM的一部分，官方定義如下；

NTSTATUS PsCreateSystemThread(
  [out]           PHANDLE            ThreadHandle,
  [in]            ULONG              DesiredAccess,
  [in, optional]  POBJECT_ATTRIBUTES ObjectAttributes,
  [in, optional]  HANDLE             ProcessHandle,
  [out, optional] PCLIENT_ID         ClientId,
  [in]            PKSTART_ROUTINE    StartRoutine,
  [in, optional]  PVOID              StartContext
);
           

我們使用

PsCreateSystemThread

函數開辟線程

TcpListenWorker

線上程内部執行如下流程啟動驅動服務端，由于我們自己封裝實作了标準接口組，是以使用起來幾乎與應用層無任何差異了。

• CreateSocket 建立套接字
• Bind 綁定套接字
• Accept 等待接收請求
• Receive 用于接收傳回值
• Send 用于發送傳回值

// 署名權
// right to sign one's name on a piece of work
// PowerBy: LyShark
// Email: [email protected]

#include "LySocket.hpp"

PETHREAD m_EThread = NULL;

// 線程函數
// PowerBy: LySHark
VOID TcpListenWorker(PVOID Context)
{
	WSK_SOCKET* paccept_socket = NULL;
	SOCKADDR_IN LocalAddress = { 0 };
	SOCKADDR_IN RemoteAddress = { 0 };
	NTSTATUS status = STATUS_UNSUCCESSFUL;

	// 建立套接字
	PWSK_SOCKET TcpSocket = CreateSocket(AF_INET, SOCK_STREAM, IPPROTO_TCP, WSK_FLAG_LISTEN_SOCKET);
	if (TcpSocket == NULL)
	{
		return;
	}

	// 設定綁定位址
	LocalAddress.sin_family = AF_INET;
	LocalAddress.sin_addr.s_addr = INADDR_ANY;
	LocalAddress.sin_port = HTON_SHORT(8888);

	status = Bind(TcpSocket, (PSOCKADDR)&LocalAddress);
	if (!NT_SUCCESS(status))
	{
		return;
	}

	// 循環接收
	while (1)
	{
		CHAR* read_buffer = (CHAR*)ExAllocatePoolWithTag(NonPagedPool, 2048, "read");
		paccept_socket = Accept(TcpSocket, (PSOCKADDR)&LocalAddress, (PSOCKADDR)&RemoteAddress);
		if (paccept_socket == NULL)
		{
			continue;
		}

		// 接收資料
		memset(read_buffer, 0, 2048);
		int read_len = Receive(paccept_socket, read_buffer, 2048, 0);
		if (read_len != 0)
		{
			DbgPrint("[核心A] => %s \n", read_buffer);

			// 發送資料
			char send_buffer[2048] = "Hi, lyshark.com B";
			Send(paccept_socket, send_buffer, strlen(send_buffer), 0);

			// 接收确認包
			memset(read_buffer, 0, 2048);
			Receive(paccept_socket, read_buffer, 2, 0);
		}

		// 清理堆
		if (read_buffer != NULL)
		{
			ExFreePool(read_buffer);
		}

		// 關閉目前套接字
		if (paccept_socket)
		{
			CloseSocket(paccept_socket);
		}
	}

	if (TcpSocket)
	{
		CloseSocket(TcpSocket);
	}
	PsTerminateSystemThread(STATUS_SUCCESS);
	return;
}

// 關閉套接字
VOID UnDriver(PDRIVER_OBJECT driver)
{
	WSKCleanup();
	KeWaitForSingleObject(m_EThread, Executive, KernelMode, FALSE, NULL);
	if (m_EThread != NULL)
	{
		ObDereferenceObject(m_EThread);
	}
}

NTSTATUS DriverEntry(IN PDRIVER_OBJECT Driver, PUNICODE_STRING RegistryPath)
{
	DbgPrint("hello lyshark.com \n");

	// 初始化
	WSKStartup();

	HANDLE hThread = NULL;
	NTSTATUS status = STATUS_UNSUCCESSFUL;

	// 建立系統線程
	status = PsCreateSystemThread(&hThread, THREAD_ALL_ACCESS, NULL, NULL, NULL, TcpListenWorker, NULL);
	if (!NT_SUCCESS(status))
	{
		return status;
	}

	// 擷取線程EProcess結構
	status = ObReferenceObjectByHandle(hThread, THREAD_ALL_ACCESS, NULL, KernelMode, (PVOID*)&m_EThread, NULL);
	if (NT_SUCCESS(status) == FALSE)
	{
		return status;
	}

	ZwClose(hThread);
	Driver->DriverUnload = UnDriver;
	return STATUS_SUCCESS;
}
           

• CreateSocket 建立套接字
• Bind 綁定套接字
• Connect 連結服務端驅動
• Send 發送資料到服務端
• Receive 接收資料到服務端

// 署名權
// right to sign one's name on a piece of work
// PowerBy: LyShark
// Email: [email protected]

#include "LySocket.hpp"

VOID UnDriver(PDRIVER_OBJECT driver)
{
	// 解除安裝并關閉Socket庫
	WSKCleanup();
}

NTSTATUS DriverEntry(IN PDRIVER_OBJECT Driver, PUNICODE_STRING RegistryPath)
{
	DbgPrint("hello lyshark.com \n");
	// 初始化
	WSKStartup();

	NTSTATUS      status = STATUS_SUCCESS;
	SOCKADDR_IN   LocalAddress = { 0, };
	SOCKADDR_IN   RemoteAddress = { 0, };

	// 建立套接字
	PWSK_SOCKET TcpSocket = CreateSocket(AF_INET, SOCK_STREAM, IPPROTO_TCP, WSK_FLAG_CONNECTION_SOCKET);
	if (TcpSocket == NULL)
	{
		Driver->DriverUnload = UnDriver;
		return STATUS_SUCCESS;
	}

	LocalAddress.sin_family = AF_INET;
	LocalAddress.sin_addr.s_addr = INADDR_ANY;
	status = Bind(TcpSocket, (PSOCKADDR)&LocalAddress);

	// 綁定失敗則關閉驅動
	if (!NT_SUCCESS(status))
	{
		CloseSocket(TcpSocket);

		Driver->DriverUnload = UnDriver;
		return STATUS_SUCCESS;
	}

	// 初始化服務端位址與端口資訊
	ULONG address[4] = { 127, 0, 0, 1 };

	RemoteAddress.sin_family = AF_INET;
	RemoteAddress.sin_addr.s_addr = change_uint(address[0], address[1], address[2], address[3]);
	RemoteAddress.sin_port = HTON_SHORT(8888);

	status = Connect(TcpSocket, (PSOCKADDR)&RemoteAddress);

	// 連接配接服務端,如果失敗則關閉驅動
	if (!NT_SUCCESS(status))
	{
		CloseSocket(TcpSocket);
		Driver->DriverUnload = UnDriver;
		return STATUS_SUCCESS;
	}

	// 發送資料
	char send_buffer[2048] = "hello lyshark.com A";
	Send(TcpSocket, send_buffer, strlen(send_buffer), 0);

	// 接收資料
	CHAR* read_buffer = (CHAR*)ExAllocatePoolWithTag(NonPagedPool, 2048, "read");

	memset(read_buffer, 0, 1024);
	Receive(TcpSocket, read_buffer, 2048, 0);
	DbgPrint("[核心B] => %s \n", read_buffer);

	// 發送确認包
	Send(TcpSocket, "ok", 2, 0);

	// 釋放記憶體
	ExFreePool(read_buffer);
	CloseSocket(TcpSocket);
	Driver->DriverUnload = UnDriver;
	return STATUS_SUCCESS;
}