RtlFindNextForwardRunClear-Funktion (wdm.h)
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") |