DOT11EXTIHV_INIT_SERVICE Rückruffunktion (wlanihv.h)
Syntax
DOT11EXTIHV_INIT_SERVICE Dot11extihvInitService;
DWORD Dot11extihvInitService(
[in] DWORD dwVerNumUsed,
[in] PDOT11EXT_APIS pDot11ExtAPI,
LPVOID pvReserved,
[out] PDOT11EXT_IHV_HANDLERS pDot11IHVHandlers
)
{...}
Parameter
[in] dwVerNumUsed
Die vom Betriebssystem verwendete Schnittstellenversion. Der Wert dieses Parameters muss zwischen den Bereichen der Versionsnummern liegen, die im pDot11IHVVersionInfo-Parameter des Dot11ExtIhvGetVersionInfo IHV-Handlerfunktion.
[in] pDot11ExtAPI
Ein Zeiger auf eine DOT11EXT_APIS-Struktur , die die Adressen der IHV-Erweiterbarkeitsfunktionen enthält, die vom Betriebssystem unterstützt werden. Das Betriebssystem formatiert diesen Parameter mit den Funktionsadressen, bevor die Dot11ExtIhvInitService-Funktion aufgerufen wird.
pvReserved
Dieser Parameter ist für die Verwendung durch das Betriebssystem reserviert.
[out] pDot11IHVHandlers
Ein Zeiger auf eine DOT11EXT_IHV_HANDLERS-Struktur , die die Adressen der IHV-Handlerfunktionen enthält, die von der DLL für IHV-Erweiterungen unterstützt werden. Die DLL formatiert diesen Parameter mit den Funktionsadressen, bevor vom Aufruf der Dot11ExtIhvInitService-Funktion zurückgegeben wird.
Rückgabewert
Wenn der Aufruf erfolgreich ist, gibt die Funktion ERROR_SUCCESS zurück. Andernfalls wird ein in Winerror.h definierter Fehlercode zurückgegeben.
Hinweise
Das Betriebssystem ruft die Dot11ExtIhvInitService-Funktion unmittelbar nach dem Aufruf des Dot11ExtIhvGetVersionInfo-Funktion . Beim Aufruf muss Dot11ExtIhvInitService die IHV-Erweiterungen-DLL bei Bedarf initialisieren. Wenn die Funktion zurückgibt, muss die DLL vorbereitet sein, um zusätzliche Aufrufe der IHV-Handlerfunktion zu akzeptieren.
Im Gegensatz zur Behandlung anderer IHV-Erweiterungs- und Handlerfunktionen, deren Adressen über den pDot11IHVHandlers-Parameter aufgelöst werden, löst das Betriebssystem die Adresse der Dot11ExtIhvInitService-Funktion auf, indem die GetProcAddress-Funktion aufgerufen wird. Daher muss der Entwickler der IHV-Erweiterungen-DLL diese Richtlinien befolgen.
- Die DLL muss eine Funktion namens Dot11ExtIhvInitService implementieren, die das in diesem Thema beschriebene Format aufweist.
- Die EXPORTS-Anweisung der Quellmoduldefinitionsdatei (DEF), die zum Erstellen der IHV-Erweiterungen-DLL verwendet wird, muss einen Funktionsnameneintrag für die Dot11ExtIhvInitService-Funktion enthalten.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
| Zielplattform | Desktop |
| Kopfzeile | wlanihv.h (include Wlanihv.h) |