Función RtlClearBits (wdm.h)

Artículo
08/08/2023

La rutina RtlClearBits establece todos los bits del intervalo de bits especificado en el mapa de bits en cero.

Sintaxis

NTSYSAPI VOID RtlClearBits(
  [in] PRTL_BITMAP BitMapHeader,
  [in] ULONG       StartingIndex,
  [in] ULONG       NumberToClear
);

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

Índice del primer bit del intervalo de bits que se va a borrar. Si el mapa de bits contiene N bits, los bits se numeran de 0 a N-1.

[in] NumberToClear

Especifica cuántos bits se van a borrar. Si el mapa de bits contiene N bits, este parámetro puede ser un valor del intervalo de 1 a (N - StartingIndex).

Valor devuelto

Esta rutina no devuelve un valor.

Comentarios

Si el parámetro NumberToClear es cero, RtlClearBits simplemente devuelve el control sin borrar ningún bits.

La suma (StartingIndex + NumberToClear) no debe superar el valor del parámetro SizeOfBitMap especificado en la llamada RtlInitializeBitMap que inicializó el mapa de bits.

Los autores de llamadas de RtlClearBits deben ejecutarse en IRQL <= APC_LEVEL si la memoria que contiene el mapa de bits es paginable o la memoria en BitMapHeader es paginable. De lo contrario, se puede llamar a RtlClearBits 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 (vea la sección Comentarios).