The RtlCompareMemory routine compares blocks of memory and returns the number of bytes that are equivalent.

SIZE_T 
  RtlCompareMemory(
    IN CONST VOID  *Source1,
    IN CONST VOID  *Source2,
    IN SIZE_T  Length
    );

Parameters

Source1

Pointer to a block of memory to compare.

Source2

Pointer to a block of memory to compare.

Length

Specifies the number of bytes to be compared.

Return Value

RtlCompareMemory returns the number of bytes that compare as equal. If all bytes compare as equal, the input Length is returned.

Comments

Callers of RtlCompareMemory can be running at any IRQL if both blocks of memory are resident.

Requirements

IRQL: Any level (See Comments section)

Headers: Declared in Wdm.h. Include Wdm.h, Ntddk.h, or Ntifs.h.