DOT11EXT_ALLOCATE_BUFFER Rückruffunktion (wlanihv.h)

Artikel
02/27/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 DLL für IHV-Erweiterungen ruft die Dot11ExtAllocateBuffer-Funktion auf, um Speicher für Puffer mit variabler Länge zuzuweisen.

Syntax

DOT11EXT_ALLOCATE_BUFFER Dot11extAllocateBuffer;

DWORD Dot11extAllocateBuffer(
  [in]  DWORD dwByteCount,
  [out] LPVOID *ppvBuffer
)
{...}

Parameter

[in] dwByteCount

Größe des zu zuordnenden Puffers in Bytes.

[out] ppvBuffer

Ein Zeiger auf eine vom Aufrufer bereitgestellte Variable, die die Adresse des zugeordneten Puffers speichert. Der ppvBuffer-Parameter hat einen gültigen Wert ungleich NULL, wenn der Rückgabewert ERROR_SUCCESS ist.

Rückgabewert

Der Aufruf gibt einen in Winerror.h definierten ERROR_xxxx Code zurück. Die folgenden ERROR_xxxx-Codes werden häufig von der Dot11ExtAllocateBuffer-Funktion zurückgegeben.

Rückgabecode	Beschreibung
ERROR_SUCCESS	Der Aufruf war ohne Fehler erfolgreich.
ERROR_OUTOFMEMORY	Das Betriebssystem konnte den Arbeitsspeicher aufgrund eines Ressourcenmangels nicht zuordnen.

Hinweise

Die DLL für IHV-Erweiterungen muss diese Richtlinien befolgen, wenn die Dot11ExtAllocateBuffer-Funktion aufgerufen wird.

Die DLL für IHV-Erweiterungen muss diese Funktion aufrufen, wenn ein puffer variabler Länge von einer IHV-Handlerfunktion zurückgegeben wird. In dieser Situation ist das Betriebssystem für das Freigeben des Puffers nach der Rückgabe der IHV-Handlerfunktion verantwortlich.
Weitere Informationen zu den IHV-Handlerfunktionen finden Sie unter Native 802.11 IHV-Handlerfunktionen.
Die DLL für IHV-Erweiterungen ruft diese Funktion möglicherweise auf, um Speicher zuzuweisen, auf den die DLL selbst verweist.
In dieser Situation muss die DLL den Speicherpuffer durch Aufrufen von Dot11ExtFreeBuffer freigeben.

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

Native 802.11 IHV-Handlerfunktionen

Dot11ExtIhvCreateDiscoveryProfiles

Dot11ExtFreeBuffer

Freigeben über