VideoPortGetCommonBuffer-Funktion (video.h)

  • Artikel

Die VideoPortGetCommonBuffer-Funktion ist in Windows XP und höher veraltet und wird nur aus Gründen der Abwärtskompatibilität mit vorhandenen Treibern unterstützt. Stattdessen sollten Treiberschreiber VideoPortAllocateCommonBuffer verwenden.

VideoPortGetCommonBuffer ordnet den Systemspeicher zu und ordnet ihn zu, sodass sowohl vom Prozessor als auch von einem Gerät aus für Common-Buffer-DMA-Vorgänge gleichzeitig 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

Zeiger auf die Geräteerweiterung des Miniporttreibers.

[in] DesiredLength

Gibt die angeforderte Anzahl von Bytes arbeitsspeicher an.

[in] Alignment

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

[out] LogicalAddress

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

[out] pActualLength

Zeiger 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 gibt bei erfolgreicher Ausführung die virtuelle Basisadresse des zugeordneten Puffers zurück. Andernfalls gibt NULL zurück, wenn der Puffer nicht zugeordnet werden kann.

Hinweise

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

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Windows 2000 und höheren Versionen der Windows-Betriebssysteme.
Zielplattform Desktop
Kopfzeile video.h (einschließen von Video.h)
Bibliothek Videoprt.lib
DLL Videoprt.sys
IRQL PASSIVE_LEVEL

Weitere Informationen

VideoPortAllocateCommonBuffer