StorPortMarkDumpMemory-Funktion (storport.h)
Ein Miniport sollte den Speicher markieren, der für die Dumpdatei oder die Ruhezustandsdatei verwendet wird. Markierter Arbeitsspeicher wird beibehalten und bleibt nach einem Fortführungsvorgang aus dem Ruhezustand gültig. Der zu markierende Arbeitsspeicher wird durch eine Adresse und Bereichslänge in einem Aufruf von StorPortMarkDumpMemory angegeben.
Syntax
ULONG StorPortMarkDumpMemory(
[in] PVOID HwDeviceExtension,
[in] PVOID Address,
[in] ULONG_PTR Length,
[in] ULONG Flags
);
Parameter
[in] HwDeviceExtension
Ein Zeiger auf die Hardwaregeräteerweiterung für den Host Bus Adapter (HBA).
[in] Address
Die Startadresse des zu markierenden Speicherbereichs.
[in] Length
Die Länge des markierten Speicherbereichs.
[in] Flags
Speichermarkierungsflags abspeichern. Der Flags-Parameter muss 0 sein oder nur den folgenden Wert enthalten.
| Wert | Bedeutung |
|---|---|
| MARK_DUMP_MEMORY_FLAG_PHYSICAL_ADDRESS | Die unter Adresse angegebene Adresse ist eine physische Adresse und keine virtuelle Systemadresse. |
Rückgabewert
StorPortMarkDumpMemory gibt einen der folgenden status Codes zurück:
| Rückgabecode | Beschreibung |
|---|---|
| STOR_STATUS_SUCCESS | Gibt an, dass die Routine die Einheitenattribute erfolgreich festgelegt hat. |
| STOR_STATUS_INVALID_PARAMETER | Im Flags-Parameter wurde ein ungültiger Flagwert angegeben. |
Hinweise
Die StorPortMarkDumpMemory-Routine darf nur von einem Miniporttreiber in seinen DriverEntry - oder HwStorFindAdapter-Routinen aufgerufen werden.
Wenn Länge = 0 ist, wird der gesamte Abschnitt mit Adresse markiert.
Miniporttreiber sollten StorPortMarkDumpMemory aufrufen, um sicherzustellen, dass der Speicher identifiziert wird, der vom Miniport zum Generieren der Dumpdatei oder der Ruhezustandsdatei verwendet wird. Miniports sollten mindestens StorPortMarkDumpMemory aufrufen, wenn das DumpMode-Element von PORT_CONFIGURATION_INFORMATION entweder auf DUMP_MODE_MARK_MEMORY oder DUMP_MODE_HIBER festgelegt ist.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 |
| Zielplattform | Universell |
| Header | storport.h (einschließlich Storport.h) |
| IRQL | Any |