VideoPortGetCommonBuffer, fonction (video.h)
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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour