Fungsi VideoPortAllocateContiguousMemory (video.h)

Artikel
03/05/2024

Fungsi VideoPortAllocateContiguousMemory sudah usang di Windows 2000 dan yang lebih baru. Driver miniport video harus menggunakan VideoPortAllocateCommonBuffer sebagai gantinya.

VideoPortAllocateContiguousMemory mengalokasikan berbagai memori yang berdekatan secara fisik dan selaras dengan cache dari kumpulan yang tidak disejajarkan.

Sintaks

VIDEOPORT_DEPRECATED VIDEOPORT_API PVOID VideoPortAllocateContiguousMemory(
  [in] IN PVOID            HwDeviceExtension,
  [in] IN ULONG            NumberOfBytes,
  [in] IN PHYSICAL_ADDRESS HighestAcceptableAddress
);

Parameter

[in] HwDeviceExtension

Arahkan ke ekstensi perangkat driver miniport.

[in] NumberOfBytes

Menentukan ukuran dalam byte blok memori yang berdekatan yang akan dialokasikan.

[in] HighestAcceptableAddress

Menentukan alamat fisik valid tertinggi yang dapat digunakan driver miniport. Misalnya, jika perangkat hanya dapat mereferensikan memori fisik di 16MB yang lebih rendah, nilai ini akan diatur ke 0x00000000FFFFFF.

Nilai kembali

VideoPortAllocateContiguousMemory mengembalikan alamat virtual dasar untuk memori yang dialokasikan, jika panggilan berhasil. Jika permintaan tidak dapat dipenuhi, NULL dikembalikan.

Keterangan

VideoPortAllocateContiguousMemory dapat dipanggil untuk mengalokasikan blok memori fisik yang berdampingan untuk buffer internal jangka panjang.

Driver miniport yang harus menggunakan memori yang bersebelahan harus mengalokasikan hanya apa yang dibutuhkan selama inisialisasi driver karena kumpulan yang tidak disebarkan kemungkinan akan terfragmentasi saat sistem berjalan. Jika driver miniport dibongkar, driver harus membatalkan alokasi memori. Alokasi yang berdekatan diselaraskan pada kelipatan integral dari ukuran baris cache data prosesor untuk mencegah masalah cache dan koherensi.

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

Lihat juga

VideoPortAllocateBuffer

Bagikan melalui