Função RtlInitializeBitMap (wdm.h)

Artigo
02/29/2024

A rotina RtlInitializeBitMap inicializa o cabeçalho de uma variável bitmap.

Sintaxe

NTSYSAPI VOID RtlInitializeBitMap(
  [out] PRTL_BITMAP             BitMapHeader,
  [in]  __drv_aliasesMem PULONG BitMapBuffer,
  [in]  ULONG                   SizeOfBitMap
);

Parâmetros

[out] BitMapHeader

Ponteiro para uma estrutura de RTL_BITMAP vazia.

[in] BitMapBuffer

Ponteiro para memória alocada pelo chamador para o bitmap em si. O endereço base desse buffer deve estar alinhado ao ULONG. O tamanho do buffer alocado deve ser um número inteiro múltiplo de bytes sizeof(ULONG).

[in] SizeOfBitMap

Especifica o número de bits no bitmap. Esse valor pode ser qualquer número de bits que caberá no buffer alocado para o bitmap.

Retornar valor

Nenhum

Comentários

Um driver pode usar uma variável bitmap como uma maneira econômica de acompanhar um conjunto de itens reutilizáveis. Por exemplo, os sistemas de arquivos usam uma variável bitmap para rastrear quais clusters/setores em um disco já foram alocados para armazenar dados de arquivo. O driver de porta SCSI fornecido pelo sistema usa uma variável bitmap para rastrear quais marcas de fila foram atribuídas a SRBs (blocos de solicitação SCSI).

RtlInitializeBitMap deve ser chamado antes de qualquer outra rotina RtlXxx que opere em uma variável bitmap. O ponteiro BitMapHeader é um parâmetro de entrada em todas as chamadas RtlXxx subsequentes que operam na variável bitmap do chamador no BitMapBuffer. O chamador é responsável por sincronizar o acesso à variável bitmap.

RtlInitializeBitMap inicializa a estrutura de RTL_BITMAP fornecida pelo chamador copiando os valores BitMapBuffer e SizeOfBitMap fornecidos pelo chamador nele. Posteriormente, a estrutura pode ser passada para outras rotinas para manipular o bitmap. RtlInitializeBitMap não modifica o conteúdo do bitmap.

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	Qualquer IRQL se BitMapHeader for residente em memória; <= APC_LEVEL se BitMapHeader for paginável ou no Windows 7 e anterior