Función RtlFindLastBackwardRunClear (wdm.h)

Artículo
08/08/2023

La rutina RtlFindLastBackwardRunClear busca un mapa de bits determinado para la ejecución clara anterior de bits, empezando por la posición de índice especificada.

Sintaxis

NTSYSAPI ULONG RtlFindLastBackwardRunClear(
  [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 sin cifrar 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 anterior a FromIndex dado. Su valor no tiene sentido si RtlFindLastBackwardRunClear no encuentra una ejecución de bits sin cifrar.

Valor devuelto

RtlFindLastBackwardRunClear devuelve el número de bits de la ejecución que comienza en StartingRunIndex o cero si no encuentra una ejecución de bits sin cifrar que precede a FromIndex en el mapa de bits.

Comentarios

Los autores de llamadas de RtlFindLastBackwardRunClear 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 RtlFindLastBackwardRunClear 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)