Fungsi RtlFindSetBits (wdm.h)

Artikel
08/08/2023

Rutinitas RtlFindSetBits mencari berbagai bit yang ditetapkan dengan ukuran yang diminta dalam bitmap.

Sintaks

NTSYSAPI ULONG RtlFindSetBits(
  [in] PRTL_BITMAP BitMapHeader,
  [in] ULONG       NumberToFind,
  [in] ULONG       HintIndex
);

Parameter

[in] BitMapHeader

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

[in] NumberToFind

Menentukan berapa banyak bit set yang berdampingan yang akan memenuhi permintaan ini.

[in] HintIndex

Menentukan posisi bit berbasis nol untuk mulai mencari rentang bit yang ditetapkan dari ukuran yang diberikan.

Nilai kembali

RtlFindSetBits mengembalikan indeks bit awal berbasis nol untuk rentang bit yang ditetapkan dari ukuran yang diminta, atau mengembalikan 0xFFFFFFFF jika tidak dapat menemukan rentang seperti itu dalam variabel bitmap yang diberikan.

Keterangan

Untuk panggilan yang berhasil, posisi bit yang dikembalikan belum tentu setara dengan HintIndex yang diberikan. Jika perlu, RtlFindSetBits mencari seluruh bitmap untuk menemukan rentang bit yang ditetapkan dari ukuran yang diminta. Namun, ia mulai mencari rentang yang diminta di dekat HintIndex, sehingga penelepon dapat menemukan rentang seperti itu lebih cepat ketika mereka dapat memberikan petunjuk yang sesuai tentang tempat untuk mulai mencari.

Penelepon RtlFindSetBits harus berjalan di IRQL <= APC_LEVEL jika memori yang berisi variabel bitmap dapat dipaginasi atau memori di BitMapHeader dapat dipaginasi. Jika tidak, RtlFindSetBits 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)