Função RtlSetBits (wdm.h)

Artigo
02/29/2024

A rotina RtlSetBits define todos os bits em um determinado intervalo de uma determinada variável bitmap.

Sintaxe

NTSYSAPI VOID RtlSetBits(
  [in] PRTL_BITMAP BitMapHeader,
  [in] ULONG       StartingIndex,
  [in] ULONG       NumberToSet
);

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 definido. Esse é um valor baseado em zero que indica a posição do primeiro bit no intervalo.

[in] NumberToSet

Especifica quantos bits devem ser definidos.

Retornar valor

Nenhum

Comentários

RtlSetBits simplesmente retornará o controle se a entrada NumberToSet for zero. StartingIndex mais NumberToSet deve ser menor ou igual a BitMapHeader-SizeOfBitMap>.

Os chamadores de RtlSetBits 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, RtlSetBits 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 (modo kernel); Ntdll.dll (modo de usuário)
IRQL	<= APC_LEVEL (seção Consulte Comentários)