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 |