DOT11EXT_ALLOCATE_BUFFER funzione di callback (wlanihv.h)

  • Articolo
Importante L'interfaccia LAN wireless nativa 802.11 è deprecata in Windows 10 e versioni successive. Usare invece l'interfaccia WDI (WLAN Device Driver Interface). Per altre informazioni su WDI, vedere Modello di driver windows universale WLAN.
 
La DLL delle estensioni IHV chiama la funzione Dot11ExtAllocateBuffer per allocare la memoria per i buffer a lunghezza variabile.

Sintassi

DOT11EXT_ALLOCATE_BUFFER Dot11extAllocateBuffer;

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

Parametri

[in] dwByteCount

Dimensioni, in byte, del buffer da allocare.

[out] ppvBuffer

Puntatore a una variabile fornita dal chiamante che archivia l'indirizzo del buffer allocato. Il parametro ppvBuffer ha un valore non null valido se il valore restituito è ERROR_SUCCESS.

Valore restituito

La chiamata restituisce un codice ERROR_xxxx definito in Winerror.h. I codici di ERROR_xxxx seguenti vengono comunemente restituiti dalla funzione Dot11ExtAllocateBuffer .

Codice restituito Descrizione
ERROR_SUCCESS
 La chiamata ha avuto esito positivo senza un errore.
ERROR_OUTOFMEMORY
 Il sistema operativo non è riuscito a allocare la memoria a causa di una mancanza di risorse.

Commenti

La DLL delle estensioni IHV deve seguire queste linee guida quando si chiama la funzione Dot11ExtAllocateBuffer .

  • La DLL delle estensioni IHV deve chiamare questa funzione quando restituisce qualsiasi buffer a lunghezza variabile da una funzione gestore IHV. In questa situazione, il sistema operativo è responsabile della liberazione del buffer dopo la restituzione della funzione gestore IHV.

    Per altre informazioni sulle funzioni del gestore IHV, vedere Funzioni del gestore IHV native 802.11.

  • La DLL delle estensioni IHV potrebbe chiamare questa funzione per allocare la memoria a cui fa riferimento la DLL stessa.

    In questa situazione, la DLL deve liberare il buffer di memoria chiamando Dot11ExtFreeBuffer.

Requisiti

Requisito Valore
Client minimo supportato Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
Piattaforma di destinazione Desktop
Intestazione wlanihv.h (include Wlanihv.h)

Vedi anche

Funzioni del gestore IHV nativo 802.11

Dot11ExtIhvCreateDiscoveryProfiles

Dot11ExtFreeBuffer