DOT11EXT_ALLOCATE_BUFFER funzione di callback (wlanihv.h)

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 .

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

Vedi anche

Funzioni del gestore IHV nativo 802.11

Dot11ExtFreeBuffer