DOT11EXT_NIC_SPECIFIC_EXTENSION Rückruffunktion (wlanihv.h)

Artikel
03/01/2024

Wichtig Die Native 802.11 Wireless LAN-Schnittstelle ist in Windows 10 und höher veraltet. Verwenden Sie stattdessen die WLAN Device Driver Interface (WDI). Weitere Informationen zu WDI finden Sie unter Wlan Universal Windows-Treibermodell.

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).

Hinweis OID_DOT11_NIC_SPECIFIC_EXTENSION ist eine optionale OID zur Unterstützung durch den Native 802.11-Miniporttreiber. Wenn der Treiber diese OID nicht unterstützt, gibt Dot11ExtNicSpecificExtension den Wert ERROR_NOT_SUPPORTED zurück.

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)

Weitere Informationen

OID_DOT11_NIC_SPECIFIC_EXTENSION

Dot11ExtIhvInitAdapter

Freigeben über