DOT11EXT_NIC_SPECIFIC_EXTENSION função de retorno de chamada (wlanihv.h)

Artigo
02/07/2025

Importante A interface de lan sem fio do Nativo 802.11 é preterida no Windows 10 e posterior. Em vez disso, use a WDI (Interface de Driver de Dispositivo) WLAN. Para obter mais informações sobre o WDI, consulte do modelo de driver Universal do Windows da WLAN.

A DLL de Extensões IHV chama a função Dot11ExtNicSpecificExtension para emitir solicitações de método NDIS 6.0 proprietárias para o driver de miniporto Nativo 802.11 que gerencia um adaptador WLAN (LAN sem fio).

Sintaxe

DOT11EXT_NIC_SPECIFIC_EXTENSION Dot11extNicSpecificExtension;

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

Parâmetros

[in, optional] hDot11SvcHandle

O identificador usado pelo sistema operacional para fazer referência ao adaptador WLAN. Esse valor de identificador foi especificado por meio de uma chamada anterior para a função Dot11ExtIhvInitAdapter manipulador IHV.

[in] dwInBufferSize

O tamanho, em bytes, do buffer de dados alocado pelo chamador referenciado pelo parâmetro pvInBuffer.

[in] pvInBuffer

Um ponteiro para um buffer de entrada alocado pelo chamador que contém os dados necessários para executar a operação. O formato desses dados é definido pelo IHV.

[in, out] pdwOutBufferSize

Um ponteiro para uma variável DWORD alocada por chamador. Quando a função Dot11ExtNicSpecificExtension é chamada, a DLL de Extensões IHV deve definir essa variável para o tamanho, em bytes, do buffer de dados alocado pelo chamador referenciado pelo parâmetro pvOutBuffer. Quando a função retorna, o sistema operacional define a variável como o número real de bytes retornados no buffer de dados referenciado pelo parâmetro pvOutBuffer.

[out] pvOutBuffer

Um ponteiro para um buffer alocado pelo chamador que contém dados retornados do driver de miniporto Native 802.11 para a solicitação especificada. O formato desses dados é definido pelo IHV. Esse parâmetro poderá ser NULL se os dados não forem retornados pelo driver de miniporto Nativo 802.11.

Valor de retorno

Se a chamada for bem-sucedida, a função retornará ERROR_SUCCESS. Caso contrário, ele retornará um código de erro definido em Winerror.h.

Observações

A função Dot11ExtNicSpecificExtension permite que a DLL de Extensões IHV passe solicitações de método proprietário para o driver de miniporto Native 802.11, que é referenciado pelo parâmetro hDot11SvcHandle. O sistema operacional emite a solicitação de método por meio do Native 802.11 OID_DOT11_NIC_SPECIFIC_EXTENSION OID (identificador de objeto).

Observação OID_DOT11_NIC_SPECIFIC_EXTENSION é uma OID opcional para suporte do driver de miniporto Nativo 802.11. Se o driver não der suporte a esse OID, Dot11ExtNicSpecificExtension retornará um valor de ERROR_NOT_SUPPORTED.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
da Plataforma de Destino	Área de trabalho
cabeçalho	wlanihv.h (inclua Wlanihv.h)

Consulte também

OID_DOT11_NIC_SPECIFIC_EXTENSION

Dot11ExtIhvInitAdapter

Partilhar via