DOT11EXTIHV_INIT_SERVICE funzione di callback (wlanihv.h)

Articolo
08/08/2023

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 Dot11ExtIhvInitService per inizializzare la DLL delle estensioni IHV e l'interfaccia API tra il sistema operativo e la DLL.

Sintassi

DOT11EXTIHV_INIT_SERVICE Dot11extihvInitService;

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

Parametri

[in] dwVerNumUsed

Versione dell'interfaccia usata dal sistema operativo. Il valore di questo parametro deve essere compreso tra gli intervalli di numeri di versione restituiti nel parametro pDot11IHVVersionInfo dell'oggetto Dot11ExtIhvGetVersionInfo Funzione gestore IHV.

[in] pDot11ExtAPI

Puntatore a una struttura DOT11EXT_APIS , che contiene gli indirizzi delle funzioni di estendibilità IHV supportate dal sistema operativo. Il sistema operativo formatta questo parametro con gli indirizzi della funzione prima di effettuare la chiamata alla funzione Dot11ExtIhvInitService .

pvReserved

Questo parametro è riservato per l'uso dal sistema operativo.

[out] pDot11IHVHandlers

Puntatore a una struttura DOT11EXT_IHV_HANDLERS , che contiene gli indirizzi delle funzioni del gestore IHV supportate dalla DLL delle estensioni IHV. La DLL formatta questo parametro con gli indirizzi della funzione prima di restituire dalla chiamata alla funzione Dot11ExtIhvInitService .

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

Il sistema operativo chiama la funzione Dot11ExtIhvInitService immediatamente dopo la chiamata all'oggetto Funzione Dot11ExtIhvGetVersionInfo . Quando viene chiamato, Dot11ExtIhvInitService deve inizializzare la DLL delle estensioni IHV in base alle esigenze. Quando la funzione restituisce, la DLL deve essere preparata per accettare chiamate aggiuntive alla funzione gestore IHV.

A differenza di come tratta altre funzioni di estensione e gestore IHV i cui indirizzi vengono risolti tramite il parametro pDot11IHVHandlers , il sistema operativo risolve l'indirizzo della funzione Dot11ExtIhvInitService chiamando la funzione GetProcAddress . Di conseguenza, lo sviluppatore della DLL delle estensioni IHV deve seguire queste linee guida.

La DLL deve implementare una funzione denominata Dot11ExtIhvInitService, con il formato descritto in questo argomento.
L'istruzione EXPORT del file module-definition (.def) di origine, usata per compilare la DLL delle estensioni IHV, deve contenere una voce nome funzione per la funzione Dot11ExtIhvInitService .

Per altre informazioni su GetProcAddress, vedere la documentazione di Microsoft Windows SDK.

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)

Vedi anche

DOT11EXT_APIS

DOT11EXT_IHV_HANDLERS

Dot11ExtIhvGetVersionInfo

Condividi tramite