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

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 dispositivo WLAN (WDI). Para obtener más información sobre WDI, consulta Modelo de controlador de Windows universal WLAN.

 

El sistema operativo llama a la función Dot11ExtIhvInitService para inicializar el archivo DLL de extensiones de IHV, así como la interfaz de API entre el sistema operativo y el archivo DLL.

Sintaxis

DOT11EXTIHV_INIT_SERVICE Dot11extihvInitService;

DWORD Dot11extihvInitService(
  [in]  DWORD dwVerNumUsed,
  [in]  PDOT11EXT_APIS pDot11ExtAPI,
        LPVOID pvReserved,
  [out] PDOT11EXT_IHV_HANDLERS pDot11IHVHandlers
)
{...}

Parámetros

[in] dwVerNumUsed

La versión de la interfaz usada por el sistema operativo. El valor de este parámetro debe estar entre los intervalos de números de versión devueltos en el parámetro pDot11IHVVersionInfo del parámetro Dot11ExtIhvGetVersionInfo Función IHV Handler.

[in] pDot11ExtAPI

Puntero a una estructura de DOT11EXT_APIS , que contiene las direcciones de las funciones de extensibilidad de IHV compatibles con el sistema operativo. El sistema operativo da formato a este parámetro con las direcciones de función antes de realizar la llamada a la función Dot11ExtIhvInitService .

pvReserved

Este parámetro está reservado para que lo use el sistema operativo.

[out] pDot11IHVHandlers

Puntero a una estructura de DOT11EXT_IHV_HANDLERS , que contiene las direcciones de las funciones de controlador de IHV compatibles con el archivo DLL de extensiones de IHV. El archivo DLL da formato a este parámetro con las direcciones de función antes de volver de la llamada a la función Dot11ExtIhvInitService .

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

El sistema operativo llama a la función Dot11ExtIhvInitService inmediatamente después de la llamada a . Función Dot11ExtIhvGetVersionInfo . Cuando se llama a , Dot11ExtIhvInitService debe inicializar el archivo DLL de extensiones IHV según sea necesario. Cuando se devuelve la función, el archivo DLL debe estar preparado para aceptar llamadas adicionales a la función IHV Handler.

A diferencia de cómo trata otras funciones de extensión y controlador de IHV cuyas direcciones se resuelven a través del parámetro pDot11IHVHandlers , el sistema operativo resuelve la dirección de la función Dot11ExtIhvInitService llamando a la función GetProcAddress . Como resultado, el desarrollador del archivo DLL de extensiones de IHV debe seguir estas instrucciones.

• El archivo DLL debe implementar una función denominada Dot11ExtIhvInitService, que tiene el formato que se describe en este tema.
• La instrucción EXPORTS del archivo source module-definition (.def), que se usa para compilar el archivo DLL de extensiones IHV, debe contener una entrada de nombre de función para la función Dot11ExtIhvInitService .

Para obtener más información sobre GetProcAddress, consulte la documentación de Microsoft Windows SDK.

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 (incluye Wlanihv.h)

Consulte también

DOT11EXT_APIS

DOT11EXT_IHV_HANDLERS

Dot11ExtIhvGetVersionInfo