VideoPortGetCommonBuffer, fonction (video.h)

Article
02/26/2024

La fonction VideoPortGetCommonBuffer est obsolète dans Windows XP et versions ultérieures, et n’est prise en charge que 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 à mémoire tampon courante.

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 d’octets de mémoire demandé.

[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 retournée

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

Remarques

Consultez Bus-Master DMA in Video Miniport Drivers pour plus d’informations sur les transferts DMA basés sur les paquets et les mémoires tampons communes.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows 2000 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

VideoPortAllocateCommonBuffer

Partager via