функция обратного вызова DOT11EXT_SEND_PACKET (wlanihv.h)

Статья
08/08/2023

ВажноСобственный интерфейс беспроводной локальной сети 802.11 не рекомендуется использовать в Windows 10 и более поздних версиях. Вместо этого используйте WLAN Device Driver Interface (WDI). Дополнительные сведения о WDI см. в статье Модель универсального драйвера WLAN для Windows.

Библиотека DLL расширений IHV вызывает функцию Dot11ExtSendPacket для передачи пакета через адаптер беспроводной локальной сети (WLAN).

Синтаксис

DOT11EXT_SEND_PACKET Dot11extSendPacket;

DWORD Dot11extSendPacket(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           ULONG uPacketLen,
  [in]           LPVOID pvPacket,
  [in, optional] HANDLE hSendCompletion
)
{...}

Параметры

[in, optional] hDot11SvcHandle

Дескриптор, используемый операционной системой для ссылки на адаптер WLAN. Это значение дескриптора было указано при предыдущем вызове функции IHV Handler Dot11ExtIhvInitAdapter .

[in] uPacketLen

Длина буфера, выделенного вызывающим объектом ,в байтах, на который ссылается параметр pvPacket .

[in] pvPacket

Указатель на буфер, выделенный вызывающим объектом, который содержит передаваемые данные, как описано в разделе Примечания.

[in, optional] hSendCompletion

Значение дескриптора, однозначно определяющее отправляемый пакет.

Когда адаптер WLAN завершает операцию отправки, операционная система уведомляет библиотеку DLL расширений IHV с помощью вызова Dot11ExtIhvSendPacketCompletion Функция обработчика IHV. При выполнении этого вызова операционная система передает значение дескриптора пакета через параметр hSendCompletion .

Возвращаемое значение

Если вызов выполнен успешно, функция возвращает ERROR_SUCCESS. В противном случае возвращается код ошибки, определенный в Winerror.h.

Пакет, отправленный с помощью вызова функции Dot11ExtSendPacket , завершится асинхронно. Библиотека DLL расширений IHV не должна освобождать память, на которую ссылается параметр pvPacket , пока Dot11ExtIhvSendPacketCompletion Функция IHV Handler вызывается с тем же значением дескриптора, что и параметр hSendCompletion .
Библиотека DLL расширений IHV должна задать для параметра hSendCompletion значение, однозначно определяющее данные пакета, на которые ссылается параметр pvPacket .

Дополнительные сведения о функциях обработчика IHV см. в статье Собственные функции обработчика IHV 802.11.

Буфер, на который указывает pvPacket , должен содержать следующие данные пакета, указанные в сетевом порядке байтов:

MAC-адрес назначения (6 байт), отформатированный в соответствии с рекомендациями, рассмотренными в разделе 802.11 Управление заголовками MAC
IEEE EtherType (2 байта)
Payload

Эти данные пакета передаются драйверу мини-порта.

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Windows Vista и более поздних версиях операционных систем Windows.
Целевая платформа	Персональный компьютер
Верхняя часть	wlanihv.h (включая Wlanihv.h)

См. также раздел

Собственные функции обработчика IHV 802.11

Dot11ExtIhvSendPacketCompletion

Dot11ExtIhvInitAdapter

802.11 Управление заголовками MAC