DOT11EXTIHV_CONTROL Rückruffunktion (wlanihv.h)

Artikel
03/05/2024

Wichtig Die native WLAN-Schnittstelle 802.11 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 driver model.

Das Betriebssystem ruft die IHV Extensions DLL Dot11ExtIhvControl-Funktion auf, um die Steuerung von WLAN-Treibern oder -Diensten durch unabhängige Hardwarehersteller (IHV) zu ermöglichen.

Syntax

DOT11EXTIHV_CONTROL Dot11extihvControl;

DWORD Dot11extihvControl(
  [in, optional]  HANDLE hIhvExtAdapter,
  [in]            DWORD dwInBufferSize,
  [in, optional]  PBYTE pInBuffer,
  [in]            DWORD dwOutBufferSize,
  [out, optional] PBYTE pOutBuffer,
  [out]           PDWORD pdwBytesReturned
)
{...}

Parameter

[in, optional] hIhvExtAdapter

Das Handle, das von der DLL für IHV-Erweiterungen verwendet wird, um auf den WLAN-Adapter zu verweisen. Dieser Handlewert wurde durch einen vorherigen Aufruf der IHV-Handlerfunktion Dot11ExtIhvInitAdapter angegeben.

[in] dwInBufferSize

Die Größe des Eingabesteuerungspuffers in Byte, auf den der pInBuffer-Parameter verweist.

[in, optional] pInBuffer

Ein Zeiger auf den Eingabesteuerelementpuffer.

[in] dwOutBufferSize

Die Größe des Ausgabepuffers (sofern angegeben) in Byte, auf den der pOutBuffer-Parameter verweist.

[out, optional] pOutBuffer

Ein Zeiger auf den Ausgabepuffer, falls angegeben.

[out] pdwBytesReturned

Ein Zeiger auf eine Variable, die die Größe des Antwortein-/Ausgabepuffers in Byte enthält.

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 diese Funktion auf, wenn die WlanIhvControl-Funktion aufgerufen wird, wobei der Type-Parameter auf den Wert wlan_ihv_control_type_service festgelegt ist. Eine Beschreibung der WlanIhvControl-Funktion finden Sie in der Microsoft Windows SDK-Dokumentation.

Daten, die mit dieser Funktion übertragen werden, werden nicht überprüft, sodass die IHV für die korrekte Analyse des Eingabepuffers verantwortlich ist.

Der Datenpuffer, auf den der parameter pdwBytesReturned verweist, wird immer zurückgegeben. Der Puffer, auf den pOutBuffer verweist, wird jedoch nur kopiert, wenn ein gültiger Zeiger angegeben wird und der Wert, auf den pdwBytesReturned verweist, kleiner oder gleich dwOutBufferSize ist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Zielplattform	Desktop
Kopfzeile	wlanihv.h (wlanihv.h einschließen)

Weitere Informationen

Dot11ExtIhvInitAdapter

Freigeben über