DOT11EXTIHV_QUERY_UI_REQUEST funzione di callback (wlanihv.h)

Articolo
02/07/2025

importante L'interfaccia LAN wireless 802.1 1 nativa è 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 di Windows universale WLAN.

Il sistema operativo chiama il Dot11ExtIhvQueryUIRequest funzione 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 utilizzato dalla DLL delle estensioni IHV per fare riferimento alla scheda 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 delle estensioni IHV avvii un'operazione di pre-associazione. Per altre informazioni sull'operazione di prea associazione, vedere operazioni di prea associazione.

connection_phase_post_l3_connection

Specifica la fase di connessione dopo che la DLL delle estensioni IHV ha completato 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.

Osservazioni

Quando viene chiamato Dot11ExtIhvQueryUIRequest, la DLL delle estensioni IHV deve allocare e restituire un buffer formattato come struttura DOT11EXT_IHV_UI_REQUEST. In questo caso, la DLL deve seguire queste linee guida:

La DLL delle estensioni IHV deve chiamare Dot11ExtAllocateBuffer per allocare il buffer. Dopo che la DLL viene restituita da Dot11ExtIhvQueryUIRequest, il sistema operativo è responsabile della chiamata di 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.

Fabbisogno

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)