Fungsi RtlInitializeBitMap (wdm.h)

Artikel
02/27/2024

Rutinitas RtlInitializeBitMap menginisialisasi header variabel bitmap.

Sintaks

NTSYSAPI VOID RtlInitializeBitMap(
  [out] PRTL_BITMAP             BitMapHeader,
  [in]  __drv_aliasesMem PULONG BitMapBuffer,
  [in]  ULONG                   SizeOfBitMap
);

Parameter

[out] BitMapHeader

Arahkan ke struktur RTL_BITMAP kosong.

[in] BitMapBuffer

Penunjuk ke memori yang dialokasikan pemanggil untuk bitmap itu sendiri. Alamat dasar buffer ini harus selaras dengan ULONG. Ukuran buffer yang dialokasikan harus berupa kelipatan bilangan bulat byte sizeof(ULONG).

[in] SizeOfBitMap

Menentukan jumlah bit dalam bitmap. Nilai ini dapat berupa sejumlah bit yang akan cocok dalam buffer yang dialokasikan untuk bitmap.

Nilai kembali

Tidak ada

Keterangan

Driver dapat menggunakan variabel bitmap sebagai cara ekonomis untuk melacak serangkaian item yang dapat digunakan kembali. Misalnya, sistem file menggunakan variabel bitmap untuk melacak kluster/sektor mana pada disk yang telah dialokasikan untuk menyimpan data file. Driver port SCSI yang disediakan sistem menggunakan variabel bitmap untuk melacak tag antrean mana yang telah ditetapkan ke blok permintaan SCSI (SRB).

RtlInitializeBitMap harus dipanggil sebelum rutinitas RtlXxx lainnya yang beroperasi pada variabel bitmap. Penunjuk BitMapHeader adalah parameter input dalam semua panggilan RtlXxx berikutnya yang beroperasi pada variabel bitmap pemanggil di BitMapBuffer. Pemanggil bertanggung jawab untuk menyinkronkan akses ke variabel bitmap.

RtlInitializeBitMap menginisialisasi struktur RTL_BITMAP yang disediakan penelepon dengan menyalin nilai BitMapBuffer dan SizeOfBitMap yang disediakan pemanggil ke dalamnya. Selanjutnya, struktur dapat diteruskan ke rutinitas lain untuk memanipulasi bitmap. RtlInitializeBitMap tidak mengubah konten bitmap.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia dimulai dengan Windows 2000.
Target Platform	Universal
Header	wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe (mode kernel); Ntdll.dll (mode pengguna)
IRQL	Setiap IRQL jika BitMapHeader adalah memory-resident; <= APC_LEVEL jika BitMapHeader dapat dipertanyakan atau pada Windows 7 dan yang lebih lama