RtlFindLastBackwardRunClear-Funktion (wdm.h)

Artikel
02/26/2024

Die RtlFindLastBackwardRunClear-Routine durchsucht ab der angegebenen Indexposition eine bestimmte Bitmap nach der vorherigen Clear Run von Bits.

Syntax

NTSYSAPI ULONG RtlFindLastBackwardRunClear(
  [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 klaren 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 clear-Bits in der Ausführung vor dem angegebenen FromIndex angibt. Sein Wert ist bedeutungslos, wenn RtlFindLastBackwardRunClear keine Ausführung von clear Bits finden kann.

Rückgabewert

RtlFindLastBackwardRunClear gibt die Anzahl der Bits in der Ausführung ab StartingRunIndex zurück, oder null, wenn keine Ausführung von klaren Bits vor FromIndex in der Bitmap gefunden werden kann.

Hinweise

Aufrufer von RtlFindLastBackwardRunClear müssen unter IRQL <= APC_LEVEL ausgeführt werden, wenn der Speicher, der die Bitmapvariable enthält, ausgelagert oder der Arbeitsspeicher bei BitMapHeader ausgelagert werden kann. Andernfalls kann RtlFindLastBackwardRunClear an einem beliebigen 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)