Fonction RtlCompareMemory (wdm.h)

Article
03/01/2024

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)

Partager via