Freigeben über


VideoPortAllocateCommonBuffer-Funktion (video.h)

Die VideoPortAllocateCommonBuffer--Funktion weist den 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 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

Zeigen Sie auf die Geräteerweiterung des Miniporttreibers.

[in] VpDmaAdapter

Zeigen Sie auf die VP_DMA_ADAPTER Struktur, die den Busmasteradapter darstellt. Diese Struktur wurde von einem vorherigen Aufruf von VideoPortGetDmaAdapterzurückgegeben.

[in] DesiredLength

Gibt die angeforderte Anzahl von Bytes an.

[out] LogicalAddress

Zeigen Sie auf einen Speicherspeicherort, der die logische Adresse empfängt, die vom Adapter für den Zugriff auf den zugewiesenen 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 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

Wenn der Puffer nicht mehr benötigt wird, sollte der Video-Miniporttreiber ihn freigeben, indem er VideoPortReleaseCommonBufferaufruft.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Verfügbar in Windows XP 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

AllocateCommonBuffer

VP_DMA_ADAPTER

VideoPortGetDmaAdapter-

VideoPortReleaseCommonBuffer