Funzione VideoPortAllocatePool (video.h)

Articolo
02/07/2025

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:

Valore	Significato
VpNonPagedPool	Il pool proviene da memoria non di paging.
VpPagedPool	Il pool proviene dalla memoria di paging.
VpNonPagedPoolCacheAligned	Il pool proviene dalla memoria non di paging allineata alla cache.
VpPagedPoolCacheAligned	Il pool proviene dalla memoria di paging allineata alla cache.

[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.

Osservazioni

VideoPortAllocatePool è progettato per sostituire VideoPortAllocateBuffer, obsoleto.

La stringa tag deve essere specificata in ordine inverso di 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, il tag stringa 'zyxD' viene visualizzato come "Dxyz" se viene eseguito il dump del pool. 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 il poolType richiesto è uno dei tipi VpNonPagedXxx. In caso contrario, i chiamanti devono essere in esecuzione in irQL < DISPATCH_LEVEL.

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile in Windows XP e versioni successive dei sistemi operativi Windows.
piattaforma di destinazione	Desktop
intestazione	video.h (includere Video.h)
libreria	Videoprt.lib
dll	Videoprt.sys
IRQL	Vedere la sezione Osservazioni.

Vedere anche

VideoPortFreePool

Condividi tramite