Función RtlFindClearBits (wdm.h)

Artículo
03/08/2023

La rutina RtlFindClearBits busca un intervalo de bits claros de un tamaño solicitado dentro de un mapa de bits.

Sintaxis

NTSYSAPI ULONG RtlFindClearBits(
  [in] PRTL_BITMAP BitMapHeader,
  [in] ULONG       NumberToFind,
  [in] ULONG       HintIndex
);

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

Especifica cuántos bits claros contiguos cumplirán esta solicitud.

[in] HintIndex

Especifica una posición de bit de base cero desde la que empezar a buscar un intervalo de bits claro del tamaño especificado.

Valor devuelto

RtlFindClearBits devuelve el índice de bits inicial de base cero para un intervalo de bits claro de al menos el tamaño solicitado, o devuelve 0xFFFFFFFF si no encuentra dicho intervalo dentro del mapa de bits especificado.

Comentarios

Para una llamada correcta, la posición de bits devuelta no es necesariamente equivalente a la hintIndex especificada. Si es necesario, RtlFindClearBits busca en todo el mapa de bits para buscar un intervalo de bits claro del tamaño solicitado. Los autores de llamadas pueden encontrar este rango más rápidamente cuando pueden proporcionar sugerencias adecuadas sobre dónde empezar a buscar.

Si no se encuentra un intervalo coincidente entre el índice de sugerencias y el final del mapa de bits, RtlFindClearBits continúa buscando desde el principio del mapa de bits hasta el índice de sugerencias.

Si solo desea que se devuelva un índice mayor o igual que algún valor, use RtlFindNextForwardRunClear en su lugar.

Los autores de llamadas de RtlFindClearBits 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 RtlFindClearBits en cualquier IRQL.

Requisitos

Requisito	Value
Plataforma de destino	Universal
Encabezado	wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)
Library	NtosKrnl.lib
Archivo DLL	NtosKrnl.exe
IRQL	IRQL <= APC_LEVEL (consulte la sección Comentarios)