Função RtlAreBitsSet (wdm.h)

Artigo
02/27/2024

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

Sintaxe

NTSYSAPI BOOLEAN RtlAreBitsSet(
  [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

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

Comentários

Os chamadores de RtlAreBitsSet 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, RtlAreBitsSet poderá 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)