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

Статья
08/08/2023

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

Библиотека DLL расширений IHV вызывает функцию Dot11ExtNicSpecificExtension для выдачи собственных запросов метода NDIS 6.0 драйверу мини-порта Native 802.11, который управляет адаптером беспроводной локальной сети (WLAN).

Синтаксис

DOT11EXT_NIC_SPECIFIC_EXTENSION Dot11extNicSpecificExtension;

DWORD Dot11extNicSpecificExtension(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           DWORD dwInBufferSize,
  [in]           LPVOID pvInBuffer,
  [in, out]      DWORD *pdwOutBufferSize,
  [out]          LPVOID pvOutBuffer
)
{...}

Параметры

[in, optional] hDot11SvcHandle

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

[in] dwInBufferSize

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

[in] pvInBuffer

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

[in, out] pdwOutBufferSize

Указатель на переменную DWORD, выделенную вызывающим объектом. При вызове функции Dot11ExtNicSpecificExtension библиотека DLL расширений IHV должна задать для этой переменной размер в байтах выделенного вызывающим объектом буфера данных, на который ссылается параметр pvOutBuffer . Когда функция возвращает значение, операционная система задает для переменной фактическое количество байтов, возвращаемых в буфере данных, на который ссылается параметр pvOutBuffer .

[out] pvOutBuffer

Указатель на буфер, выделенный вызывающим объектом, который содержит данные, возвращенные драйвером мини-порта native 802.11 для указанного запроса. Формат этих данных определяется IHV. Этот параметр может иметь значение NULL , если драйвер минипорта native 802.11 не должен возвращать данные.

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

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

Функция Dot11ExtNicSpecificExtension позволяет библиотеке DLL расширений IHV передавать запросы к собственному драйверу минипорта 802.11, на который ссылается параметр hDot11SvcHandle . Операционная система отправляет запрос метода через native 802.11 OID_DOT11_NIC_SPECIFIC_EXTENSION идентификатор объекта (OID).

Примечание OID_DOT11_NIC_SPECIFIC_EXTENSION является необязательным идентификатором OID для поддержки драйвера мини-порта native 802.11. Если драйвер не поддерживает этот OID, Dot11ExtNicSpecificExtension вернет значение ERROR_NOT_SUPPORTED.

Требования

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

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

OID_DOT11_NIC_SPECIFIC_EXTENSION

Dot11ExtIhvInitAdapter