DOT11EXTIHV_INIT_SERVICE funzione di callback (wlanihv.h)
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 utilizzata dal sistema operativo. Il valore di questo parametro deve essere compreso tra gli intervalli di numeri di versione restituiti nel parametro pDot11IHVVersionInfo del parametro funzione Del gestore IHV dot11ExtIhvGetVersionInfo.
[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 tornare 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.
Osservazioni
Il sistema operativo chiama la funzione Dot11ExtIhvInitService immediatamente dopo la chiamata a funzione Dot11ExtIhvGetVersionInfo. Quando viene chiamato, Dot11ExtIhvInitService deve inizializzare la DLL delle estensioni IHV in base alle esigenze. Al termine della funzione, la DLL deve essere preparata per accettare chiamate aggiuntive alla funzione del gestore IHV.
A differenza di come gestisce altre funzioni di estensione e gestore IHV i cui indirizzi vengono risolti tramite il parametro pDot11IHVHandlers, il sistema operativo risolve l'indirizzo del 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, che ha il formato descritto in questo argomento.
- L'istruzione EXPORTS del file di definizione del modulo di origine (con estensione def), usata per compilare la DLL delle estensioni IHV, deve contenere una voce del nome di funzione per la funzione dot11ExtIhvInitService.
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) |