Função RtlFindSetBits (wdm.h)

Artigo
03/05/2024

A rotina RtlFindSetBits procura um intervalo de bits definidos de um tamanho solicitado em um bitmap.

Sintaxe

NTSYSAPI ULONG RtlFindSetBits(
  [in] PRTL_BITMAP BitMapHeader,
  [in] ULONG       NumberToFind,
  [in] ULONG       HintIndex
);

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] NumberToFind

Especifica quantos bits de conjunto contíguo atenderão a essa solicitação.

[in] HintIndex

Especifica uma posição de bit baseada em zero em torno da qual começar a procurar um intervalo de bits definido do tamanho especificado.

Retornar valor

RtlFindSetBits retorna o índice de bit inicial baseado em zero para um intervalo de bits definido do tamanho solicitado ou retorna 0xFFFFFFFF se não encontrar esse intervalo dentro da variável bitmap fornecida.

Comentários

Para uma chamada bem-sucedida, a posição de bit retornada não é necessariamente equivalente ao HintIndex especificado. Se necessário, RtlFindSetBits pesquisa todo o bitmap para localizar um intervalo de bits definido do tamanho solicitado. No entanto, ele começa a pesquisar o intervalo solicitado perto de HintIndex, para que os chamadores possam encontrar esse intervalo mais rapidamente quando puderem fornecer dicas apropriadas sobre onde começar a procurar.

Os chamadores de RtlFindSetBits 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, RtlFindSetBits 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)