Función RtlFindFirstRunClear (wdm.h)

Artículo
02/27/2024

La rutina RtlFindFirstRunClear busca el intervalo contiguo inicial de bits claros dentro de un mapa de bits determinado.

Sintaxis

NTSYSAPI ULONG RtlFindFirstRunClear(
  [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 inicial 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. Su valor no tiene sentido si RtlFindFirstRunClear no encuentra una ejecución de bits claros.

Valor devuelto

RtlFindFirstRunClear 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. Es decir, una vez que se encuentra un bit claro, RtlFindFirstRunClear continúa buscando hasta que encuentre el siguiente bit establecido y, a continuación, devuelve el número de bits claros en la ejecución que encontró.

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