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

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 maître de bus. Cette structure a été retournée par un appel précédent à VideoPortGetDmaAdapter.

[in] DesiredLength

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

[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 être défini sur NULL .

Valeur de retour

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 le libérer en appelant VideoPortReleaseCommonBuffer.

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible dans Windows XP et versions ultérieures des systèmes d’exploitation Windows.
plateforme cible	Bureau
d’en-tête	video.h (include Video.h)
bibliothèque	Videoprt.lib
DLL	Videoprt.sys
IRQL	PASSIVE_LEVEL

Voir aussi

AllocateCommonBuffer

VP_DMA_ADAPTER

VideoPortGetDmaAdapter

VideoPortReleaseCommonBuffer