Fonction VideoPortAllocatePool (video.h)

Article
02/26/2024

La fonction VideoPortAllocatePool alloue un bloc de mémoire de pool, en insérant une balise fournie par l’appelant au début de la mémoire.

Syntaxe

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

Paramètres

[in] HwDeviceExtension

Pointeur vers l’extension de périphérique du pilote miniport.

[in] PoolType

Spécifie le type de pool de mémoire à allouer. Ce paramètre peut être défini sur l’un des éléments suivants :

Valeur	Signification
VpNonPagedPool	Le pool provient de la mémoire non paginé.
VpPagedPool	Le pool est à partir de la mémoire paginée.
VpNonPagedPoolCacheAligned	Le pool provient de la mémoire non pagée alignée sur le cache.
VpPagedPoolCacheAligned	Le pool provient de la mémoire paginée alignée sur le cache.

[in] NumberOfBytes

Spécifie le nombre d’octets de mémoire à allouer.

[in] Tag

Spécifie une balise d’allocation de quatre octets, composée de quatre caractères ASCII maximum, qui identifie de manière unique le pilote qui alloue la mémoire. La chaîne de balise est délimitée par des guillemets simples.

Valeur retournée

En cas d’allocation réussie du pool de mémoire, VideoPortAllocatePool retourne l’adresse du pool de mémoire alloué. Sinon, cette fonction retourne NULL.

Remarques

VideoPortAllocatePool est destiné à remplacer VideoPortAllocateBuffer, qui est obsolète.

La chaîne de balise doit être spécifiée dans l’ordre inverse des octets. Il est recommandé que la première lettre de la chaîne (avant d’être inversée) soit « D » pour désigner un pilote d’affichage ; les trois autres octets doivent indiquer le nom du pilote. Par exemple, la chaîne de balise « zyxD » s’affiche sous la forme « Dxyz » si le pool est vidé. La balise apparaît dans n’importe quel vidage sur incident du système qui se produit.

Les appelants de VideoPortAllocatePool peuvent s’exécuter sur IRQL = DISPATCH_LEVEL uniquement si le poolType demandé est l’un des typesXxx VpNonPaged. Dans le cas contraire, les appelants doivent être en cours d’exécution à l’DISPATCH_LEVEL IRQL < .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows XP et versions ultérieures des systèmes d’exploitation Windows.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	video.h (incluez Video.h)
Bibliothèque	Videoprt.lib
DLL	Videoprt.sys
IRQL	Consultez la section Notes.

Voir aussi

VideoPortFreePool

Partager via