VideoPortGetCommonBuffer, fonction (video.h)
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 |