DOT11EXTIHV_QUERY_UI_REQUEST funzione di callback (wlanihv.h)

Articolo
03/05/2024

Importante L'interfaccia LAN wireless nativa 802.11 è deprecata in Windows 10 e versioni successive. Usare invece l'interfaccia WDI (WLAN Device Driver Interface). Per altre informazioni su WDI, vedere Modello di driver windows universale WLAN.

Il sistema operativo chiama la funzione Dot11ExtIhvQueryUIRequest ogni volta che lo stato della connessione cambia. Quando questa funzione viene chiamata, la DLL delle estensioni IHV restituisce una struttura DOT11EXT_IHV_UI_REQUEST che il sistema operativo può usare per una richiesta dell'interfaccia utente.

Sintassi

DOT11EXTIHV_QUERY_UI_REQUEST Dot11extihvQueryUiRequest;

DWORD Dot11extihvQueryUiRequest(
  [in, optional] HANDLE hIhvExtAdapter,
  [in]           DOT11EXT_IHV_CONNECTION_PHASE connectionPhase,
  [out]          PDOT11EXT_IHV_UI_REQUEST *ppIhvUIRequest
)
{...}

Parametri

[in, optional] hIhvExtAdapter

Handle usato dalla DLL delle estensioni IHV per fare riferimento all'adattatore LAN wireless (WLAN). Questo valore di handle è stato specificato tramite una chiamata precedente alla funzione Dot11ExtIhvInitAdapter IHV Handler.

[in] connectionPhase

Fase di connessione corrente. Il tipo di dati per questo membro è l'enumerazione DOT11EXT_IHV_CONNECTION_PHASE :

connection_phase_any

Specifica qualsiasi fase di connessione.

connection_phase_initial_connection

Specifica la fase di connessione prima che la DLL di estensioni IHV avvii un'operazione di pre-associazione. Per altre informazioni sull'operazione di pre-associazione, vedere Operazioni di pre-associazione.

connection_phase_post_l3_connection

Specifica la fase di connessione dopo che la DLL delle estensioni IHV completa un'operazione post-associazione. Per altre informazioni sull'operazione post-associazione, vedere Operazioni post-associazione.

[out] ppIhvUIRequest

Indirizzo di un puntatore a una struttura DOT11EXT_IHV_UI_REQUEST . La DLL delle estensioni IHV deve allocare un buffer per la struttura DOT11EXT_IHV_UI_REQUEST chiamando Dot11ExtAllocateBuffer.

Valore restituito

Se la chiamata ha esito positivo, la funzione restituisce ERROR_SUCCESS. In caso contrario, restituisce un codice di errore definito in Winerror.h.

Commenti

Quando si chiama Dot11ExtIhvQueryUIRequest , la DLL delle estensioni IHV deve allocare e restituire un buffer formattato come struttura DOT11EXT_IHV_UI_REQUEST . In questa situazione, la DLL deve seguire queste linee guida:

La DLL delle estensioni IHV deve chiamare Dot11ExtAllocateBuffer per allocare il buffer. Dopo aver restituito la DLL da Dot11ExtIhvQueryUIRequest, il sistema operativo è responsabile della chiamata a Dot11ExtFreeBuffer per liberare il buffer.
La DLL delle estensioni IHV formatta la struttura DOT11EXT_IHV_UI_REQUEST per una richiesta dell'interfaccia utente appropriata per la modifica dello stato della connessione.
Ad esempio, se connectionPhase è impostato su connection_phase_initial_connection, la DLL delle estensioni IHV potrebbe impostare i membri della struttura DOT11EXT_IHV_UI_REQUEST per fare riferimento a una pagina dell'interfaccia utente che informa l'utente dell'inizio dell'operazione di connessione.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
Piattaforma di destinazione	Desktop
Intestazione	wlanihv.h (include Wlanihv.h)