VideoPortAllocateCommonBuffer-Funktion (video.h)

  • Artikel

Die VideoPortAllocateCommonBuffer-Funktion weist den Systemspeicher zu und ordnet ihn zu, sodass gleichzeitig vom Prozessor und einem Gerät aus für DMA-Vorgänge mit common-buffer zugegriffen werden kann.

Syntax

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

Parameter

[in] HwDeviceExtension

Zeiger auf die Geräteerweiterung des Miniporttreibers.

[in] VpDmaAdapter

Zeiger auf die VP_DMA_ADAPTER-Struktur, die den Bus-master-Adapter darstellt. Diese Struktur wurde durch einen vorherigen Aufruf von VideoPortGetDmaAdapter zurückgegeben.

[in] DesiredLength

Gibt die angeforderte Anzahl von Bytes arbeitsspeicher an.

[out] LogicalAddress

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

[in] CacheEnabled

Gibt an, ob der zugeordnete Arbeitsspeicher zwischengespeichert werden kann. Weitere Informationen finden Sie in der Beschreibung des CacheEnabled-Parameters für AllocateCommonBuffer.

[out] Reserved

Wird derzeit vom Videoporttreiber ignoriert. sollte auf NULL festgelegt werden.

Rückgabewert

VideoPortAllocateCommonBuffer gibt bei erfolgreicher Ausführung die virtuelle Basisadresse des zugeordneten Puffers zurück. Andernfalls wird NULL zurückgegeben, wenn der Puffer nicht zugeordnet werden kann.

Hinweise

Wenn der Puffer nicht mehr benötigt wird, sollte der Video-Miniporttreiber ihn durch Aufrufen von VideoPortReleaseCommonBuffer freigeben.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Windows XP 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

AllocateCommonBuffer

VP_DMA_ADAPTER

VideoPortGetDmaAdapter

VideoPortReleaseCommonBuffer