VideoPortAllocateCommonBuffer-Funktion (video.h)
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 |