Função RtlCompareMemory (wdm.h)

A rotina RtlCompareMemory compara dois blocos de memória e retorna o número de bytes que correspondem até a primeira diferença.

Sintaxe

NTSYSAPI SIZE_T RtlCompareMemory(
  [in] const VOID *Source1,
  [in] const VOID *Source2,
  [in] SIZE_T     Length
);

Parâmetros

[in] Source1

Um ponteiro para o primeiro bloco de memória.

[in] Source2

Um ponteiro para o segundo bloco de memória.

[in] Length

O número de bytes a serem comparados.

Retornar valor

RtlCompareMemory retorna o número de bytes nos dois blocos que correspondem. Se todos os bytes corresponderem ao valor length especificado, o valor Length será retornado.

Comentários

A rotina começa comparando o primeiro byte no primeiro bloco com o primeiro byte no segundo bloco e continua comparando bytes sucessivos nos dois blocos enquanto os bytes correspondem. A rotina para de comparar bytes quando encontra o primeiro par de bytes que não são iguais ou quando o número de bytes correspondentes é igual ao valor do parâmetro Length , o que ocorrer primeiro.

Os chamadores de RtlCompareMemory poderão estar em execução em qualquer IRQL se ambos os blocos de memória forem residentes.

Requisitos

Requisito	Valor
Plataforma de Destino	Universal
Cabeçalho	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca	NtosKrnl.lib; OneCoreUAP.lib no Windows 10
DLL	NtDll.dll (modo de usuário); Kernel32.dll (modo de usuário); NtosKrnl.exe (modo kernel)
IRQL	Qualquer nível (consulte a seção Comentários)
Regras de conformidade da DDI	BufAfterReqCompletedIntIoctlA(kmdf), BufAfterReqCompletedIoctlA(kmdf), BufAfterReqCompletedReadA(kmdf), BufAfterReqCompletedWriteA(kmdf)