VideoPortAllocateCommonBuffer, fonction (video.h)

La fonction VideoPortAllocateCommonBuffer alloue et mappe la mémoire système afin qu’elle soit simultanément accessible à partir du processeur et d’un appareil pour les opérations DMA de mémoire tampon courante.

Syntaxe

VIDEOPORT_DEPRECATED VIDEOPORT_API PVOID VideoPortAllocateCommonBuffer(
  [in]  IN PVOID              HwDeviceExtension,
  [in]  IN PVP_DMA_ADAPTER    VpDmaAdapter,
  [in]  IN ULONG              DesiredLength,
  [out] OUT PPHYSICAL_ADDRESS LogicalAddress,
  [in]  IN BOOLEAN            CacheEnabled,
  [out] OUT PVOID             Reserved
);

Paramètres

[in] HwDeviceExtension

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

[in] VpDmaAdapter

Pointeur vers la structure VP_DMA_ADAPTER qui représente l’adaptateur master bus. Cette structure a été retournée par un appel précédent à VideoPortGetDmaAdapter.

[in] DesiredLength

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

[out] LogicalAddress

Pointeur vers un emplacement de mémoire qui reçoit l’adresse logique à utiliser par l’adaptateur pour accéder à la mémoire tampon allouée.

[in] CacheEnabled

Spécifie si la mémoire allouée peut être mise en cache. Pour plus d’informations, consultez la description du paramètre CacheEnabled pour AllocateCommonBuffer.

[out] Reserved

Est actuellement ignoré par le pilote de port vidéo ; doit avoir la valeur NULL.

Valeur retournée

VideoPortAllocateCommonBuffer retourne l’adresse virtuelle de base de la mémoire tampon allouée en cas de réussite ; sinon, elle retourne NULL si la mémoire tampon ne peut pas être allouée.

Remarques

Lorsque la mémoire tampon n’est plus nécessaire, le pilote de miniport vidéo doit la libérer en appelant VideoPortReleaseCommonBuffer.

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	PASSIVE_LEVEL

Voir aussi

AllocateCommonBuffer

VP_DMA_ADAPTER

VideoPortGetDmaAdapter

VideoPortReleaseCommonBuffer