RtlFindNextForwardRunClear-Funktion (wdm.h)

Artikel
02/27/2024

Die RtlFindNextForwardRunClear-Routine durchsucht eine angegebene Bitmapvariable nach der nächsten Leeren Bitausführung, beginnend mit der angegebenen Indexposition.

Syntax

NTSYSAPI ULONG RtlFindNextForwardRunClear(
  [in]  PRTL_BITMAP BitMapHeader,
  [in]  ULONG       FromIndex,
  [out] PULONG      StartingRunIndex
);

Parameter

[in] BitMapHeader

Ein Zeiger auf die RTL_BITMAP-Struktur , die die Bitmap beschreibt. Diese Struktur muss von der RtlInitializeBitMap-Routine initialisiert worden sein.

[in] FromIndex

Gibt eine nullbasierte Bitposition an, an der nach einer eindeutigen Bitausführung gesucht werden soll.

[out] StartingRunIndex

Zeiger auf eine Variable, in der der Startindex der in der Bitmap gefundenen clear run zurückgegeben wird. Dies ist ein nullbasierter Wert, der die Bitposition des ersten leeren Bits in der Ausführung angibt. Sein Wert ist bedeutungslos, wenn RtlFindNextForwardRunClear keine Ausführung von clear Bits finden kann.

Rückgabewert

RtlFindNextForwardRunClear gibt entweder die Anzahl der Bits in der Ausführung ab StartingRunIndex zurück, oder null, wenn keine Ausführung von klaren Bits nach FromIndex in der Bitmap gefunden wird.

Hinweise

Aufrufer von RtlFindNextForwardRunClear müssen unter IRQL <= APC_LEVEL ausgeführt werden, wenn der Speicher, der die Bitmapvariable enthält, ausgelagert werden kann oder der Arbeitsspeicher bei BitMapHeader ausgelagert werden kann. Andernfalls kann RtlFindNextForwardRunClear in jedem IRQL aufgerufen werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar ab Windows 2000.
Zielplattform	Universell
Header	wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL (siehe Abschnitt "Hinweise")