VideoPortGetCommonBuffer-Funktion (video.h)

Artikel
02/07/2025

Die VideoPortGetCommonBuffer--Funktion ist veraltete in Windows XP und höher und wird nur aus Gründen der Abwärtskompatibilität mit vorhandenen Treibern unterstützt. An seinem Ort sollten Treiberautoren VideoPortAllocateCommonBufferverwenden.

VideoPortGetCommonBuffer Ordnet Systemspeicher zu und ordnet sie zu, sodass gleichzeitig über den Prozessor und ein Gerät für DMA-Vorgänge mit allgemeinen Puffern zugegriffen werden kann.

Syntax

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
);

Parameter

[in] HwDeviceExtension

Zeigen Sie auf die Geräteerweiterung des Miniporttreibers.

[in] DesiredLength

Gibt die angeforderte Anzahl von Bytes an.

[in] Alignment

Gibt die angeforderte Ausrichtung des Puffers an. Der Videoporttreiber ignoriert derzeit diesen Parameter.

[out] LogicalAddress

Zeiger auf eine Variable, die die logische Adresse empfängt, die vom Adapter für den Zugriff auf den zugewiesenen Puffer verwendet werden soll.

[out] pActualLength

Zeigen Sie auf eine Variable, die die tatsächliche Größe des für diese Anforderung zugewiesenen Puffers in Bytes empfängt.

[in] CacheEnabled

Gibt an, ob der zugeordnete Arbeitsspeicher zwischengespeichert werden kann.

Rückgabewert

VideoPortGetCommonBuffer die virtuelle Basisadresse des zugeordneten Puffers zurück, wenn dies erfolgreich ist; andernfalls wird NULL- zurückgegeben, wenn der Puffer nicht zugeordnet werden kann.

Bemerkungen

Informationen zu paketbasierten und allgemeinen DMA-Übertragungen finden Sie unter Bus-Master DMA in Video Miniport Drivers.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar in Windows 2000 und höheren Versionen von Windows-Betriebssystemen.
Zielplattform-	Desktop
Header-	video.h (video.h einschließen)
Library	Videoprt.lib
DLL-	Videoprt.sys
IRQL-	PASSIVE_LEVEL

Siehe auch

VideoPortAllocateCommonBuffer

Freigeben über