Partager via


Fonction VideoPortAllocatePool (video.h)

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