DOT11EXT_NIC_SPECIFIC_EXTENSION Rückruffunktion (wlanihv.h)
Die IHV-Erweiterungen-DLL ruft die Dot11ExtNicSpecificExtension-Funktion auf, um proprietäre NDIS 6.0-Methodenanforderungen an den Native 802.11-Miniporttreiber auszusetzen, der einen WLAN-Adapter verwaltet.
Syntax
DOT11EXT_NIC_SPECIFIC_EXTENSION Dot11extNicSpecificExtension;
DWORD Dot11extNicSpecificExtension(
[in, optional] HANDLE hDot11SvcHandle,
[in] DWORD dwInBufferSize,
[in] LPVOID pvInBuffer,
[in, out] DWORD *pdwOutBufferSize,
[out] LPVOID pvOutBuffer
)
{...}
Parameter
[in, optional] hDot11SvcHandle
Das Handle, das vom Betriebssystem verwendet wird, um auf den WLAN-Adapter zu verweisen. Dieser Handle-Wert wurde durch einen vorherigen Aufruf der IHV-Handlerfunktion Dot11ExtIhvInitAdapter angegeben.
[in] dwInBufferSize
Die Größe des vom Aufrufer zugewiesenen Datenpuffers in Bytes, auf den der parameter pvInBuffer verweist.
[in] pvInBuffer
Ein Zeiger auf einen vom Aufrufer zugewiesenen Eingabepuffer, der die daten enthält, die zum Ausführen des Vorgangs erforderlich sind. Das Format dieser Daten wird vom IHV definiert.
[in, out] pdwOutBufferSize
Ein Zeiger auf eine vom Aufrufer zugewiesene DWORD-Variable. Wenn die Dot11ExtNicSpecificExtension-Funktion aufgerufen wird, muss die IHV-Erweiterungen-DLL diese Variable auf die Größe des vom Aufrufer zugewiesenen Datenpuffers in Bytes festlegen, auf den der parameter pvOutBuffer verweist. Wenn die Funktion zurückgibt, legt das Betriebssystem die Variable auf die tatsächliche Anzahl von Bytes fest, die im Datenpuffer zurückgegeben werden, auf den der parameter pvOutBuffer verweist.
[out] pvOutBuffer
Ein Zeiger auf einen vom Aufrufer zugewiesenen Puffer, der Daten enthält, die vom Native 802.11-Miniporttreiber für die angegebene Anforderung zurückgegeben wurden. Das Format dieser Daten wird vom IHV definiert. Dieser Parameter kann NULL sein, wenn keine Daten vom Native 802.11-Miniporttreiber zurückgegeben werden sollen.
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
Mit der Dot11ExtNicSpecificExtension-Funktion kann die IHV-Erweiterungen-DLL proprietäre Methodenanforderungen an den Native 802.11-Miniporttreiber übergeben, auf den der Parameter hDot11SvcHandle verweist. Das Betriebssystem stellt die Methodenanforderung über Native 802.11 aus. OID_DOT11_NIC_SPECIFIC_EXTENSION Objektbezeichner (OID).
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) |