VideoPortGetCommonBuffer, fonction (video.h)

Article
02/07/2025

La fonction VideoPortGetCommonBuffer est obsolète dans Windows XP et versions ultérieures, et est prise en charge uniquement pour la compatibilité descendante avec les pilotes existants. À sa place, les enregistreurs de pilotes doivent utiliser VideoPortAllocateCommonBuffer.

VideoPortGetCommonBuffer 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 VideoPortGetCommonBuffer(
  [in]  IN PVOID              HwDeviceExtension,
  [in]  IN ULONG              DesiredLength,
  [in]  IN ULONG              Alignment,
  [out] OUT PPHYSICAL_ADDRESS LogicalAddress,
  [out] OUT PULONG            pActualLength,
  [in]  IN BOOLEAN            CacheEnabled
);

Paramètres

[in] HwDeviceExtension

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

[in] DesiredLength

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

[in] Alignment

Spécifie l’alignement demandé de la mémoire tampon. Le pilote de port vidéo ignore actuellement ce paramètre.

[out] LogicalAddress

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

[out] pActualLength

Pointeur vers une variable qui reçoit la taille réelle, en octets, de la mémoire tampon allouée pour cette requête.

[in] CacheEnabled

Spécifie si la mémoire allouée peut être mise en cache.

Valeur de retour

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

Remarques

Consultez Bus-Master DMA dans video Miniport Drivers pour plus d’informations sur les transferts DMA basés sur des paquets et des mémoires tampons courantes.

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible dans Windows 2000 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

VideoPortAllocateCommonBuffer

Partager via