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

Lihat juga

AllocateCommonBuffer

VP_DMA_ADAPTER

VideoPortGetDmaAdapter

VideoPortReleaseCommonBuffer