Función RtlFindClearRuns (wdm.h)

Artículo
02/27/2024

La rutina RtlFindClearRuns busca el número especificado de ejecuciones de bits claros dentro de un mapa de bits determinado.

Sintaxis

NTSYSAPI ULONG RtlFindClearRuns(
  [in]  PRTL_BITMAP     BitMapHeader,
  [out] PRTL_BITMAP_RUN RunArray,
  [in]  ULONG           SizeOfRunArray,
  [in]  BOOLEAN         LocateLongestRuns
);

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] RunArray

Puntero al primer elemento de una matriz asignada por el autor de la llamada para la posición de bits y la longitud de cada ejecución clara encontrada en la variable de mapa de bits especificada.

[in] SizeOfRunArray

Especifica el número máximo de ejecuciones claras para satisfacer esta solicitud.

[in] LocateLongestRuns

Si es TRUE, especifica que la rutina consiste en buscar en todo el mapa de bits las ejecuciones claras más largas que puede encontrar. De lo contrario, la rutina deja de buscar cuando ha encontrado el número de ejecuciones claras especificadas por SizeOfRunArray.

Valor devuelto

RtlFindClearRuns devuelve el número de ejecuciones claras encontradas.

Comentarios

Si LocateLongestRuns es TRUE, las ejecuciones claras indicadas en RunArray se ordenan de mayor a menor. Una ejecución clara puede constar de un solo bit.

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