Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |