Función RtlFindNextForwardRunClear (wdm.h)

Artículo
02/29/2024

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)