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

  • Artigo
Importante A interface lan sem fio Native 802.11 foi preterida no Windows 10 e posterior. Em vez disso, use a WDI (Interface de Driver de Dispositivo) da WLAN. Para obter mais informações sobre o WDI, consulte 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 referenciar o adaptador WLAN. Esse valor de identificador foi especificado por meio de uma chamada anterior para a função manipulador IHV Dot11ExtIhvInitAdapter .

[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 pelo chamador. Quando a função Dot11ExtNicSpecificExtension é chamada, a DLL de Extensões IHV deve definir essa variável como 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 Nativo 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 miniporta Nativo 802.11.

Retornar valor

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.

Comentários

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).

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

Requisitos

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

Confira também

OID_DOT11_NIC_SPECIFIC_EXTENSION

Dot11ExtIhvInitAdapter