Fungsi RtlFindClearBits (wdm.h)

Rutinitas RtlFindClearBits mencari berbagai bit yang jelas dari ukuran yang diminta dalam bitmap.

Sintaks

NTSYSAPI ULONG RtlFindClearBits(
  [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 yang jelas yang berdampingan akan memenuhi permintaan ini.

[in] HintIndex

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

Mengembalikan nilai

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

Keterangan

Untuk panggilan yang berhasil, posisi bit yang dikembalikan belum tentu setara dengan HintIndex yang diberikan. Jika perlu, RtlFindClearBits mencari seluruh bitmap untuk menemukan rentang bit yang jelas dari ukuran yang diminta. Penelepon dapat menemukan rentang seperti itu lebih cepat ketika mereka dapat memberikan petunjuk yang sesuai tentang tempat untuk mulai mencari.

Catatan

Jika rentang yang cocok tidak ditemukan antara indeks petunjuk dan akhir bitmap, RtlFindClearBits terus mencari dari awal bitmap kembali ke indeks petunjuk. Jika Anda hanya ingin indeks yang dikembalikan yang lebih besar dari atau sama dengan beberapa nilai, gunakan RtlFindNextForwardRunClear sebagai gantinya.

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

Persyaratan

   
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)

Lihat juga

RTL_BITMAP

RtlAreBitsClear

RtlFindClearBitsAndSet

RtlFindFirstRunClear

RtlFindLongestRunClear

RtlFindSetBits

RtlInitializeBitMap

RtlNumberOfClearBits