Compartilhar via


Função RtlAreBitsClear (wdm.h)

A rotina RtlAreBitsClear determina se um determinado intervalo de bits dentro de uma variável bitmap está claro.

Sintaxe

NTSYSAPI BOOLEAN RtlAreBitsClear(
  [in] PRTL_BITMAP BitMapHeader,
  [in] ULONG       StartingIndex,
  [in] ULONG       Length
);

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

Especifica o início do intervalo de bits a ser testado. Esse é um valor baseado em zero que indica a posição do primeiro bit no intervalo.

[in] Length

Especifica quantos bits testar.

Retornar valor

RtlAreBitsClear retornará TRUE se Length bits consecutivos começando em StartingIndex estiverem claros (ou seja, todos os bits de StartingIndex para (StartingIndex + Length) -1). Ele retornará FALSE se qualquer bit no intervalo especificado estiver definido, se o intervalo fornecido não for um subconjunto adequado do bitmap ou se o Comprimento fornecido for zero.

Comentários

Os chamadores de RtlAreBitsClear devem estar em execução em IRQL <= APC_LEVEL se a memória que contém a variável bitmap for paginável ou a memória em BitMapHeader for paginável. Caso contrário, RtlAreBitsClear 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 (seção Consulte Comentários)

Confira também

RTL_BITMAP

RtlAreBitsSet

RtlCheckBit

RtlClearAllBits

RtlFindClearBits

RtlFindFirstRunClear

RtlFindLastBackwardRunClear

RtlFindLongestRunClear

RtlFindNextForwardRunClear

RtlInitializeBitMap