Fonction RtlCompareMemory (wdm.h)

La routine RtlCompareMemory compare deux blocs de mémoire et retourne le nombre d’octets qui correspondent jusqu’à la première différence.

Syntaxe

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

Paramètres

[in] Source1

Pointeur vers le premier bloc de mémoire.

[in] Source2

Pointeur vers le deuxième bloc de mémoire.

[in] Length

Nombre d'octets à comparer.

Valeur retournée

RtlCompareMemory retourne le nombre d’octets dans les deux blocs qui correspondent. Si tous les octets correspondent à la valeur Length spécifiée, la valeur Length est retournée.

Remarques

La routine commence par comparer le premier octet du premier bloc au premier octet du deuxième bloc et continue à comparer les octets successifs dans les deux blocs tandis que les octets correspondent. La routine cesse de comparer les octets lorsqu’elle rencontre la première paire d’octets qui ne sont pas égales, ou lorsque le nombre d’octets correspondants est égal à la valeur du paramètre Length , selon ce qui se produit en premier.

Les appelants de RtlCompareMemory peuvent être en cours d’exécution sur n’importe quel IRQL si les deux blocs de mémoire sont résidents.

Configuration requise

Condition requise Valeur
Plateforme cible Universal
En-tête wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Bibliothèque NtosKrnl.lib ; OneCoreUAP.lib sur Windows 10
DLL NtDll.dll (mode utilisateur) ; Kernel32.dll (mode utilisateur) ; NtosKrnl.exe (mode noyau)
IRQL N’importe quel niveau (voir la section Remarques)
Règles de conformité DDI BufAfterReqCompletedIntIoctlA(kmdf), BufAfterReqCompletedIoctlA(kmdf), BufAfterReqCompletedReadA(kmdf), BufAfterReqCompletedWriteA(kmdf)