Fungsi RtlClearBits (wdm.h)

Artikel
02/29/2024

Rutinitas RtlClearBits mengatur semua bit dalam rentang bit yang ditentukan dalam bitmap ke nol.

Sintaks

NTSYSAPI VOID RtlClearBits(
  [in] PRTL_BITMAP BitMapHeader,
  [in] ULONG       StartingIndex,
  [in] ULONG       NumberToClear
);

Parameter

[in] BitMapHeader

Penunjuk ke struktur RTL_BITMAP yang menjelaskan bitmap. Struktur ini harus diinisialisasi oleh rutinitas RtlInitializeBitMap .

[in] StartingIndex

Indeks bit pertama dalam rentang bit yang akan dibersihkan. Jika bitmap berisi N bit, bit dinomor dari 0 hingga N-1.

[in] NumberToClear

Menentukan berapa banyak bit yang akan dihapus. Jika bitmap berisi bit N, parameter ini dapat menjadi nilai dalam rentang 1 hingga (N - StartingIndex).

Nilai kembali

Rutinitas ini tidak mengembalikan nilai.

Keterangan

Jika parameter NumberToClear adalah nol, RtlClearBits hanya mengembalikan kontrol tanpa menghapus bit apa pun.

Jumlah (StartingIndex + NumberToClear) tidak boleh melebihi nilai parameter SizeOfBitMap yang ditentukan dalam panggilan RtlInitializeBitMap yang menginisialisasi bitmap.

Pemanggil RtlClearBits harus berjalan di IRQL <= APC_LEVEL jika memori yang berisi bitmap dapat dipaginasi atau memori di BitMapHeader dapat dipaginasi. Jika tidak, RtlClearBits dapat dipanggil di IRQL apa pun.

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
IRQL	<= APC_LEVEL (Lihat bagian Keterangan.)