Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Das Makro WriteStructToModeAligned schreibt eine Struktur sicher in den Arbeitsspeicher, basierend auf dem angegebenen Prozessormodus mit Ausrichtungsüberprüfung.
Syntax
void WriteStructToModeAligned(
Destination,
Source,
Mode,
Alignment
);
Parameters
Destination
[out] Ein Zeiger auf den Speicherort, an dem die Struktur geschrieben wird.
Source
[in] Ein Zeiger auf die Struktur, die in den Zielspeicherort geschrieben werden soll.
Mode
[in] Der Prozessormodus, der bestimmt, wie der Speicherzugriff ausgeführt wird. Der Modus kann einen der folgenden Werte aufweisen.
| Value | Meaning |
|---|---|
| KernelMode | Ziel verweist auf den Kernelmodusspeicher. Das Makro führt mit memory_order_relaxed Semantik einen Schreibvorgang in die angegebene Adresse aus. Weitere Informationen finden Sie in den Hinweisen. |
| UserMode | Ziel verweist auf den Arbeitsspeicher des Benutzermodus. Das Makro löst eine Ausnahme aus, wenn das Ziel nicht auf den Arbeitsspeicher des Benutzermodus verweist. andernfalls wird mit memory_order_relaxed Semantik ein Schreibzugriff auf die angegebene Adresse ausgeführt. Weitere Informationen finden Sie in den Hinweisen. |
Alignment
[in] Die erforderliche Ausrichtung für die Zieladresse in Byte.
Return value
None
Remarks
Dieses Makro bietet eine sichere Möglichkeit, eine Struktur in den Arbeitsspeicher zu schreiben, mit zusätzlichen Sicherheitsüberprüfungen beim Zugriff auf Arbeitsspeicher und Ausrichtungserzwingung im Benutzermodus. Es stellt sicher, dass die angegebene Adresse gültig und zugänglich ist, basierend auf dem angegebenen Prozessormodus, und erfüllt die angegebenen Ausrichtungsanforderungen beim Zugriff auf den Benutzermodusspeicher.
Das Makro überprüft den Quell- und Zielpunkt auf kompatible Typen und bestimmt automatisch die Strukturgröße für den Kopiervorgang.
Dieses Makro erzwingt die Ausrichtung, indem überprüft wird, ob die Zieladresse beim Zugriff auf den Benutzermodusspeicher die angegebene Ausrichtungsanforderung erfüllt. Dadurch können Leistungsstrafen und potenzielle Hardwarefehler vermieden werden, die beim Zugriff auf falsch ausgerichtete Datenstrukturen auftreten können.
Es löst eine strukturierte Ausnahme aus, wenn der Speicherzugriff fehlschlägt, z. B. wenn die Zieladresse nicht gültig ist oder für den angegebenen Prozessormodus nicht zugänglich ist oder die Ausrichtungsanforderungen nicht erfüllt.
Dieses Makro wird niemals vom Compiler optimiert, oder der Compiler erstellt zusätzlichen Zugriff auf diesen Speicherspeicherort, bevor das Makro aufgerufen wird oder nachdem das Makro zurückgegeben wird (es sei denn, der Quellcode führt diese Zugriffe explizit aus). Der Speicherzugriff wird mit memory_order_relaxed Semantik ausgeführt.
Dieses Makro funktioniert auf allen Versionen von Windows, nicht nur auf dem neuesten. Sie müssen die neueste WDK verwenden, um die Makrodeklaration aus dem Header usermode_accessors.h abzurufen. Außerdem benötigen Sie die Bibliothek (umaccess.lib) aus dem neuesten WDK. Der resultierende Treiber wird jedoch in älteren Versionen von Windows einwandfrei ausgeführt.
Requirements
| Requirement | Value |
|---|---|
| Mindestens unterstützter Client | See Remarks |
| Header | usermode_accessors.h |
| Library | umaccess.lib |
| IRQL | Kleiner oder gleich APC_LEVEL |