Funzione VideoPortAllocatePool (video.h)

La funzione VideoPortAllocatePool alloca un blocco di memoria del pool, inserendo un tag fornito dal chiamante all'inizio della memoria.

Sintassi

VIDEOPORT_API PVOID VideoPortAllocatePool(
  [in] IN PVOID        HwDeviceExtension,
  [in] IN VP_POOL_TYPE PoolType,
  [in] IN SIZE_T       NumberOfBytes,
  [in] IN ULONG        Tag
);

Parametri

[in] HwDeviceExtension

Puntatore all'estensione del dispositivo del driver miniport.

[in] PoolType

Specifica il tipo di pool di memoria da allocare. Questo parametro può essere impostato su uno dei seguenti:

[in] NumberOfBytes

Specifica il numero di byte di memoria da allocare.

[in] Tag

Specifica un tag di allocazione a quattro byte, costituito da un massimo di quattro caratteri ASCII, che identifica in modo univoco il driver che alloca la memoria. La stringa di tag è delimitata da virgolette singole.

Valore restituito

Al termine dell'allocazione del pool di memoria, VideoPortAllocatePool restituisce l'indirizzo del pool di memoria allocato. In caso contrario, questa funzione restituisce NULL.

Commenti

VideoPortAllocatePool è progettato per sostituire VideoPortAllocateBuffer, obsoleto.

La stringa tag deve essere specificata nell'ordine inverso dei byte. È consigliabile che la prima lettera nella stringa (prima che venga invertita) sia 'D' per indicare un driver di visualizzazione; gli altri tre byte devono essere indicativi del nome del driver. Ad esempio, la stringa tag 'zyxD' viene visualizzata come "Dxyz" se il pool viene sottoposto a dump. Il tag viene visualizzato in qualsiasi dump di arresto anomalo del sistema che si verifica.

I chiamanti di VideoPortAllocatePool possono essere eseguiti in IRQL = DISPATCH_LEVEL solo se poolType richiesto è uno dei tipi VpNonPagedXxx . In caso contrario, i chiamanti devono essere in esecuzione nel DISPATCH_LEVEL IRQL < .

Requisiti

Vedi anche

VideoPortFreePool