Função RtlCompareMemoryUlong (ntifs.h)

  • Artigo

A rotina RtlCompareMemoryUlong retorna quantos bytes em um bloco de memória correspondem a um padrão especificado.

Sintaxe

NTSYSAPI SIZE_T RtlCompareMemoryUlong(
  [in] PVOID  Source,
  [in] SIZE_T Length,
  [in] ULONG  Pattern
);

Parâmetros

[in] Source

Ponteiro para um bloco de memória. Deve estar alinhado em um limite ULONG.

[in] Length

Número de bytes sobre os quais a comparação deve ser feita. Deve ser um múltiplo de sizeof(ULONG).

[in] Pattern

Padrão a ser comparado por byte, repetidamente, por meio do intervalo de memória especificado.

Retornar valor

RtlCompareMemoryUlong retorna o número de bytes que foram comparados e considerados iguais. Se todos os bytes forem comparados como iguais, o Comprimento de entrada será retornado. RtlCompareMemoryUlong retornará zero se Source não estiver alinhado ao ULONG ou se Length não for um múltiplo de sizeof(ULONG).

Comentários

Se o bloco de memória na Origem não forpagado, o chamador poderá estar em execução em qualquer IRQL. Caso contrário, os chamadores de RtlCompareMemoryUlong devem estar em execução no IRQL < DISPATCH_LEVEL.

Para obter mais informações sobre como gerenciar dados armazenados em buffer e inicializar buffers alocados por driver, consulte Inicialização de buffer e dados armazenados em buffer.

Requisitos

Requisito Valor
Plataforma de Destino Universal
Cabeçalho ntifs.h (inclua Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe (modo kernel); Ntdll.dll (modo de usuário)
IRQL Qualquer nível (consulte a seção Comentários)

Confira também

RtlCompareMemory