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

Artigo
03/01/2024

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 Dot11ExtSendUIRequest para solicitar a notificação ou a entrada do usuário por meio da DLL de Extensões de Interface do Usuário do IHV Nativas 802.11.

Sintaxe

DOT11EXT_SEND_UI_REQUEST Dot11extSendUiRequest;

DWORD Dot11extSendUiRequest(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           PDOT11EXT_IHV_UI_REQUEST pIhvUIRequest
)
{...}

Parâmetros

[in, optional] hDot11SvcHandle

O identificador usado pelo sistema operacional para referenciar o adaptador WLAN (LAN sem fio). Esse valor de identificador foi especificado por meio de uma chamada anterior para a função manipulador IHV Dot11ExtIhvInitAdapter .

[in] pIhvUIRequest

Um ponteiro para um buffer alocado pelo chamador, formatado como um DOT11EXT_IHV_UI_REQUEST estrutura.

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 DLL de Extensões IHV deve seguir estas diretrizes ao chamar a função Dot11ExtSendUIRequest .

As solicitações de notificação de eventos pela DLL de Extensões de Interface do Usuário IHV do Native 802.11 são concluídas por meio de uma chamada para o Dot11ExtIhvProcessUIResponse Função manipulador IHV. A DLL de Extensões IHV não deve liberar a memória referenciada pelo parâmetro pIhvUIRequest até que a solicitação seja concluída.
Se o sistema operacional chamar as funções do manipulador IHV Dot11ExtIhvAdapterReset ou Dot11ExtIhvDeinitAdapter , a DLL de Extensões IHV poderá assumir que a solicitação de interface do usuário foi cancelada. Nessa situação, a DLL deve liberar a memória referenciada pelo parâmetro pIhvUIRequest .
O sistema operacional pode consultar o status de conclusão da solicitação por meio de uma chamada para o Dot11ExtIhvIsUIRequestPending Função manipulador IHV.

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)