Fungsi VideoPortAllocateCommonBuffer (video.h)
Fungsi VideoPortAllocateCommonBuffer 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 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
Arahkan ke ekstensi perangkat driver miniport.
[in] VpDmaAdapter
Penunjuk ke struktur VP_DMA_ADAPTER yang mewakili adaptor bus-master. Struktur ini dikembalikan oleh panggilan sebelumnya ke VideoPortGetDmaAdapter.
[in] DesiredLength
Menentukan jumlah byte memori yang diminta.
[out] LogicalAddress
Penunjuk ke lokasi memori yang menerima alamat logis yang akan digunakan oleh adaptor untuk mengakses buffer yang dialokasikan.
[in] CacheEnabled
Menentukan apakah memori yang dialokasikan dapat di-cache. Untuk informasi selengkapnya, lihat deskripsi parameter CacheEnabled untuk AllocateCommonBuffer.
[out] Reserved
Saat ini diabaikan oleh driver port video; harus diatur ke NULL.
Nilai kembali
VideoPortAllocateCommonBuffer mengembalikan alamat virtual dasar buffer yang dialokasikan jika berhasil; jika tidak, ia mengembalikan NULL jika buffer tidak dapat dialokasikan.
Keterangan
Ketika buffer tidak lagi diperlukan, driver miniport video harus merilisnya dengan memanggil VideoPortReleaseCommonBuffer.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Tersedia di Windows XP 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 |