Fungsi RtlFindFirstRunClear (wdm.h)

Artikel
02/29/2024

Rutinitas RtlFindFirstRunClear mencari rentang awal bit yang jelas dalam bitmap tertentu.

Sintaks

NTSYSAPI ULONG RtlFindFirstRunClear(
  [in]  PRTL_BITMAP BitMapHeader,
  [out] PULONG      StartingIndex
);

Parameter

[in] BitMapHeader

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

[out] StartingIndex

Penunjuk ke variabel di mana indeks awal dari pengoperasian jelas awal dalam bitmap dikembalikan. Ini adalah nilai berbasis nol yang menunjukkan posisi bit bit jelas pertama dalam rentang yang dikembalikan. Nilainya tidak berarti jika RtlFindFirstRunClear tidak dapat menemukan eksekusi bit yang jelas.

Nilai kembali

RtlFindFirstRunClear mengembalikan jumlah bit dalam eksekusi yang dimulai di StartingIndex, atau nol jika tidak dapat menemukan eksekusi bit yang jelas dalam bitmap.

Keterangan

Eksekusi yang dikembalikan dapat memiliki satu bit yang jelas. Artinya, setelah bit yang jelas ditemukan, RtlFindFirstRunClear terus mencari sampai menemukan bit yang ditetapkan berikutnya, dan kemudian mengembalikan jumlah bit yang jelas dalam eksekusi yang ditemukannya.

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