RtlFindLongestRunClear-Funktion (wdm.h)
Die RtlFindLongestRunClear-Routine sucht nach dem größten zusammenhängenden Bereich von klaren Bits innerhalb einer bestimmten Bitmap.
Syntax
NTSYSAPI ULONG RtlFindLongestRunClear(
[in] PRTL_BITMAP BitMapHeader,
[out] PULONG StartingIndex
);
Parameter
[in] BitMapHeader
Ein Zeiger auf die RTL_BITMAP-Struktur , die die Bitmap beschreibt. Diese Struktur muss von der RtlInitializeBitMap-Routine initialisiert worden sein.
[out] StartingIndex
Zeiger auf eine Variable, in der der Startindex der längsten leeren Ausführung in der Bitmap zurückgegeben wird. Dies ist ein nullbasierter Wert, der die Bitposition des ersten leeren Bits im zurückgegebenen Bereich angibt.
Rückgabewert
RtlFindLongestRunClear gibt entweder die Anzahl der Bits in der Ausführung ab StartingIndex zurück, oder null, wenn keine Ausführung von leeren Bits innerhalb der Bitmap gefunden werden kann.
Hinweise
Eine zurückgegebene Ausführung kann ein einzelnes Clear Bit aufweisen.
Aufrufer von RtlFindLongestRunClear müssen unter IRQL <= APC_LEVEL ausgeführt werden, wenn der Speicher, der die Bitmapvariable enthält, ausgelagert werden kann oder der Speicher in BitMapHeader ausgelagert werden kann. Andernfalls kann RtlFindLongestRunClear an 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") |