Función RtlFindLongestRunClear (wdm.h)
La rutina RtlFindLongestRunClear busca el intervalo contiguo más grande de bits claros dentro de un mapa de bits determinado.
Sintaxis
NTSYSAPI ULONG RtlFindLongestRunClear(
[in] PRTL_BITMAP BitMapHeader,
[out] PULONG StartingIndex
);
Parámetros
[in] BitMapHeader
Puntero a la estructura RTL_BITMAP que describe el mapa de bits. Esta estructura debe haber sido inicializada por la rutina RtlInitializeBitMap .
[out] StartingIndex
Puntero a una variable en la que se devuelve el índice inicial de la ejecución clara más larga en el mapa de bits. Se trata de un valor de base cero que indica la posición de bits del primer bit claro del intervalo devuelto.
Valor devuelto
RtlFindLongestRunClear devuelve el número de bits de la ejecución que comienza en StartingIndex o cero si no encuentra una ejecución de bits sin cifrar dentro del mapa de bits.
Comentarios
Una ejecución devuelta puede tener un solo bit claro.
Los autores de llamadas de RtlFindLongestRunClear deben ejecutarse en IRQL <= APC_LEVEL si la memoria que contiene la variable de mapa de bits es paginable o la memoria de BitMapHeader es paginable. De lo contrario, se puede llamar a RtlFindLongestRunClear en cualquier IRQL.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible a partir de Windows 2000. |
| Plataforma de destino | Universal |
| Encabezado | wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| Archivo DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL (consulte la sección Comentarios) |