Función RtlFindClearBitsAndSet (wdm.h)

Artículo
02/29/2024

La rutina RtlFindClearBitsAndSet busca un intervalo de bits claros de un tamaño solicitado dentro de un mapa de bits y establece todos los bits del intervalo cuando se ha localizado.

Sintaxis

NTSYSAPI ULONG RtlFindClearBitsAndSet(
  [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 bits de base cero desde la que empezar a buscar un intervalo de bits claro del tamaño especificado.

Valor devuelto

RtlFindClearBitsAndSet devuelve el índice de bits inicial basado en cero para un intervalo de bits claro del tamaño solicitado que estableció o devuelve 0xFFFFFFFF si no encuentra este rango dentro de la variable de mapa de bits especificada.

Comentarios

Para una llamada correcta, la posición de bits devuelta no es necesariamente equivalente a la hintIndex especificada. Si es necesario, RtlFindClearBitsAndSet busca en todo el mapa de bits para buscar un intervalo de bits claro del tamaño solicitado. Sin embargo, comienza a buscar el intervalo solicitado desde HintIndex, por lo que los autores de llamadas pueden tener un restablecimiento de intervalo de este tipo más rápidamente cuando pueden proporcionar sugerencias adecuadas sobre dónde empezar a buscar.

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