Função RtlClearBits (wdm.h)
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.) |