Fungsi RtlSetBits (wdm.h)

Artikel
02/27/2024

Rutinitas RtlSetBits mengatur semua bit dalam rentang tertentu dari variabel bitmap tertentu.

Sintaks

NTSYSAPI VOID RtlSetBits(
  [in] PRTL_BITMAP BitMapHeader,
  [in] ULONG       StartingIndex,
  [in] ULONG       NumberToSet
);

Parameter

[in] BitMapHeader

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

[in] StartingIndex

Menentukan awal rentang bit yang akan diatur. Ini adalah nilai berbasis nol yang menunjukkan posisi bit pertama dalam rentang.

[in] NumberToSet

Menentukan berapa banyak bit yang akan diatur.

Nilai kembali

Tidak ada

Keterangan

RtlSetBits hanya mengembalikan kontrol jika input NumberToSet adalah nol. StartingIndex plus NumberToSet harus kurang dari atau sama dengan BitMapHeader-SizeOfBitMap>.

Pemanggil RtlSetBits harus berjalan di IRQL <= APC_LEVEL jika memori yang berisi variabel bitmap dapat dipaginasi atau memori di BitMapHeader dapat dipaginasi. Jika tidak, RtlSetBits 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 (mode kernel); Ntdll.dll (mode pengguna)
IRQL	<= APC_LEVEL (Lihat bagian Keterangan)