Función RtlFindNextForwardRunClear (wdm.h)
La rutina RtlFindNextForwardRunClear busca una variable de mapa de bits determinada para la siguiente ejecución clara de bits, empezando por la posición de índice especificada.
Sintaxis
NTSYSAPI ULONG RtlFindNextForwardRunClear(
[in] PRTL_BITMAP BitMapHeader,
[in] ULONG FromIndex,
[out] PULONG StartingRunIndex
);
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 .
[in] FromIndex
Especifica una posición de bit de base cero en la que empezar a buscar una ejecución clara de bits.
[out] StartingRunIndex
Puntero a una variable en la que se devuelve el índice inicial de la ejecución desactivada que se encuentra en el mapa de bits. Se trata de un valor de base cero que indica la posición de bits del primer bit claro de la ejecución. Su valor no tiene sentido si RtlFindNextForwardRunClear no encuentra una ejecución de bits claros.
Valor devuelto
RtlFindNextForwardRunClear devuelve el número de bits de la ejecución que comienza en StartingRunIndex o cero si no encuentra una ejecución de bits claros después de FromIndex en el mapa de bits.
Comentarios
Los autores de llamadas de RtlFindNextForwardRunClear deben ejecutarse en IRQL <= APC_LEVEL si la memoria que contiene la variable de mapa de bits es paginable o la memoria en BitMapHeader es paginable. De lo contrario, se puede llamar a RtlFindNextForwardRunClear 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) |