RtlCompareMemoryUlong-Funktion (ntifs.h)

Die RtlCompareMemoryUlong-Routine gibt zurück, wie viele Bytes in einem Speicherblock einem angegebenen Muster entsprechen.

Syntax

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

Parameter

[in] Source

Zeiger auf einen Speicherblock. Muss an einer ULONG-Grenze ausgerichtet werden.

[in] Length

Anzahl der Bytes, für die der Vergleich durchgeführt werden soll. Muss ein Vielfaches von sizeof(ULONG) sein.

[in] Pattern

Muster, das byte byte byte wiederholt durch den angegebenen Speicherbereich verglichen werden soll.

Rückgabewert

RtlCompareMemoryUlong gibt die Anzahl der Bytes zurück, die verglichen und gleich sind. Wenn alle Bytes gleich sind, wird die Eingabelänge zurückgegeben. RtlCompareMemoryUlong gibt null zurück, wenn Source nicht auf ULONG ausgerichtet ist oder wenn Length kein Vielfaches von sizeof(ULONG) ist.

Hinweise

Wenn der Speicherblock an der Quelle nicht auslagert ist, kann der Aufrufer in jedem IRQL ausgeführt werden. Andernfalls müssen Aufrufer von RtlCompareMemoryUlong am IRQL-DISPATCH_LEVEL < ausgeführt werden.

Weitere Informationen zum Verwalten gepufferter Daten und zum Initialisieren von vom Treiber zugewiesenen Puffern finden Sie unter Gepufferte Daten und Pufferinitialisierung.

Anforderungen

Anforderung Wert
Zielplattform Universell
Header ntifs.h (include Ntifs.h)
Bibliothek NtosKrnl.lib
DLL NtosKrnl.exe (Kernelmodus); Ntdll.dll (Benutzermodus)
IRQL Beliebige Ebene (siehe Abschnitt "Hinweise")

Weitere Informationen

RtlCompareMemory