DOT11EXTIHV_QUERY_UI_REQUEST función de devolución de llamada (wlanihv.h)

Artículo
08/08/2023

Importante La interfaz LAN inalámbrica nativa 802.11 está en desuso en Windows 10 y versiones posteriores. En su lugar, use la interfaz del controlador de dispositivos WLAN (WDI). Para obtener más información sobre WDI, consulta Modelo de controlador universal de Windows WLAN.

El sistema operativo llama a la función Dot11ExtIhvQueryUIRequest cada vez que cambia el estado de conexión. Cuando se llama a esta función, el archivo DLL de extensiones de IHV devuelve una estructura de DOT11EXT_IHV_UI_REQUEST que el sistema operativo puede usar para una solicitud de interfaz de usuario.

Sintaxis

DOT11EXTIHV_QUERY_UI_REQUEST Dot11extihvQueryUiRequest;

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

Parámetros

[in, optional] hIhvExtAdapter

Identificador utilizado por el archivo DLL de extensiones IHV para hacer referencia al adaptador LAN inalámbrico (WLAN). Este valor de identificador se especificó a través de una llamada anterior a la función Dot11ExtIhvInitAdapter IHV Handler.

[in] connectionPhase

Fase de conexión actual. El tipo de datos de este miembro es la enumeración DOT11EXT_IHV_CONNECTION_PHASE :

connection_phase_any

Especifica cualquier fase de conexión.

connection_phase_initial_connection

Especifica la fase de conexión antes de que el archivo DLL de extensiones de IHV inicie una operación de asociación previa. Para obtener más información sobre la operación previa a la asociación, vea Operaciones previas a la asociación.

connection_phase_post_l3_connection

Especifica la fase de conexión después de que el archivo DLL de extensiones de IHV complete una operación posterior a la asociación. Para obtener más información sobre la operación posterior a la asociación, vea Operaciones posteriores a la asociación.

[out] ppIhvUIRequest

Dirección de un puntero a una estructura de DOT11EXT_IHV_UI_REQUEST . El archivo DLL de extensiones de IHV debe asignar un búfer para la estructura de DOT11EXT_IHV_UI_REQUEST llamando a Dot11ExtAllocateBuffer.

Valor devuelto

Si la llamada se realiza correctamente, la función devuelve ERROR_SUCCESS. De lo contrario, devuelve un código de error definido en Winerror.h.

Comentarios

Cuando se llama a Dot11ExtIhvQueryUIRequest , el archivo DLL de extensiones de IHV debe asignar y devolver un búfer con formato de estructura DOT11EXT_IHV_UI_REQUEST . En esta situación, el archivo DLL debe seguir estas directrices:

El archivo DLL de extensiones de IHV debe llamar a Dot11ExtAllocateBuffer para asignar el búfer. Después de que el archivo DLL vuelva de Dot11ExtIhvQueryUIRequest, el sistema operativo es responsable de llamar a Dot11ExtFreeBuffer para liberar el búfer.
El archivo DLL de extensiones de IHV da formato a la estructura de DOT11EXT_IHV_UI_REQUEST para una solicitud de interfaz de usuario adecuada para el cambio en el estado de conexión.
Por ejemplo, si connectionPhase está establecido en connection_phase_initial_connection, el archivo DLL de extensiones de IHV podría establecer los miembros de la estructura de DOT11EXT_IHV_UI_REQUEST para hacer referencia a una página de interfaz de usuario que notifica al usuario el inicio de la operación de conexión.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows.
Plataforma de destino	Escritorio
Encabezado	wlanihv.h (incluya Wlanihv.h)