Fungsi VideoPortGetCommonBuffer (video.h)
Fungsi VideoPortGetCommonBufferusang di Windows XP dan yang lebih baru, dan hanya didukung untuk kompatibilitas mundur dengan driver yang ada. Sebagai gantinya, penulis driver harus menggunakan VideoPortAllocateCommonBuffer.
VideoPortGetCommonBuffer mengalokasikan dan memetakan memori sistem sehingga dapat diakses secara bersamaan dari prosesor dan perangkat untuk operasi DMA buffer umum.
Sintaks
VIDEOPORT_DEPRECATED VIDEOPORT_API PVOID VideoPortGetCommonBuffer(
[in] IN PVOID HwDeviceExtension,
[in] IN ULONG DesiredLength,
[in] IN ULONG Alignment,
[out] OUT PPHYSICAL_ADDRESS LogicalAddress,
[out] OUT PULONG pActualLength,
[in] IN BOOLEAN CacheEnabled
);
Parameter
[in] HwDeviceExtension
Arahkan ke ekstensi perangkat driver miniport.
[in] DesiredLength
Menentukan jumlah byte memori yang diminta.
[in] Alignment
Menentukan perataan buffer yang diminta. Driver port video saat ini mengabaikan parameter ini.
[out] LogicalAddress
Penunjuk ke variabel yang menerima alamat logis yang akan digunakan oleh adaptor untuk mengakses buffer yang dialokasikan.
[out] pActualLength
Pointer ke variabel yang menerima ukuran aktual, dalam byte, dari buffer yang dialokasikan untuk permintaan ini.
[in] CacheEnabled
Menentukan apakah memori yang dialokasikan dapat di-cache.
Nilai kembali
VideoPortGetCommonBuffer mengembalikan alamat virtual dasar buffer yang dialokasikan jika berhasil; jika tidak, mengembalikan NULL jika buffer tidak dapat dialokasikan.
Keterangan
Lihat DMA Bus-Master di Driver Miniport Video untuk informasi tentang transfer DMA berbasis paket dan buffer umum.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Tersedia di Windows 2000 dan versi yang lebih baru dari sistem operasi Windows. |
| Target Platform | Desktop |
| Header | video.h (sertakan Video.h) |
| Pustaka | Videoprt.lib |
| DLL | Videoprt.sys |
| IRQL | PASSIVE_LEVEL |