Compartir a través de


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)

Consulte también

RTL_BITMAP

RtlAreBitsClear

RtlFindClearBits

RtlFindClearRuns

RtlFindFirstRunClear

RtlFindLastBackwardRunClear

RtlFindLongestRunClear

RtlInitializeBitMap