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 courante.
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 master bus. Cette structure a été retournée par un appel précédent à VideoPortGetDmaAdapter.
[in] DesiredLength
Spécifie le nombre d’octets de mémoire demandé.
[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 avoir la valeur NULL.
Valeur retournée
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 la libérer en appelant VideoPortReleaseCommonBuffer.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans Windows XP 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 |