Função RtlClearBits (wdm.h)

Artigo
02/27/2024

A rotina RtlClearBits define todos os bits no intervalo de bits especificado no bitmap como zero.

Sintaxe

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

Parâmetros

[in] BitMapHeader

Um ponteiro para a estrutura RTL_BITMAP que descreve o bitmap. Essa estrutura deve ter sido inicializada pela rotina RtlInitializeBitMap .

[in] StartingIndex

O índice do primeiro bit no intervalo de bits que deve ser limpo. Se o bitmap contiver N bits, os bits serão numerados de 0 a N-1.

[in] NumberToClear

Especifica quantos bits serão limpos. Se o bitmap contiver N bits, esse parâmetro poderá ser um valor no intervalo de 1 a (N – StartingIndex).

Retornar valor

Essa rotina não retorna um valor.

Comentários

Se o parâmetro NumberToClear for zero, RtlClearBits simplesmente retornará o controle sem limpar nenhum bit.

A soma (StartingIndex + NumberToClear) não deve exceder o valor do parâmetro SizeOfBitMap especificado na chamada RtlInitializeBitMap que inicializou o bitmap.

Os chamadores de RtlClearBits devem estar em execução em IRQL <= APC_LEVEL se a memória que contém o bitmap for paginável ou a memória em BitMapHeader for paginável. Caso contrário, RtlClearBits pode ser chamado em qualquer IRQL.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível a partir do Windows 2000.
Plataforma de Destino	Universal
Cabeçalho	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL (consulte a seção Comentários.)