Função RtlFindFirstRunClear (wdm.h)
A rotina RtlFindFirstRunClear pesquisa o intervalo contíguo inicial de bits claros em um determinado bitmap.
Sintaxe
NTSYSAPI ULONG RtlFindFirstRunClear(
[in] PRTL_BITMAP BitMapHeader,
[out] PULONG StartingIndex
);
Parâmetros
[in] BitMapHeader
Um ponteiro para a estrutura RTL_BITMAP que descreve o bitmap. Essa estrutura deve ter sido inicializada pela rotina RtlInitializeBitMap .
[out] StartingIndex
Ponteiro para uma variável na qual o índice inicial da execução clara inicial no bitmap é retornado. Esse é um valor baseado em zero que indica a posição do bit do primeiro bit claro no intervalo retornado. Seu valor não tem sentido se RtlFindFirstRunClear não conseguir encontrar uma execução de bits claros.
Retornar valor
RtlFindFirstRunClear retorna o número de bits na execução começando em StartingIndex ou zero se não encontrar uma execução de bits claros dentro do bitmap.
Comentários
Uma execução retornada pode ter um único bit claro. Ou seja, depois que um bit claro é encontrado, RtlFindFirstRunClear continua pesquisando até encontrar o bit do próximo conjunto e retorna o número de bits claros na execução encontrada.
Os chamadores de RtlFindFirstRunClear 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, RtlFindFirstRunClear 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) |