StorPortMarkDumpMemory-Funktion (storport.h)
Ein Miniport sollte speichermarkieren, der für die Speicherabbilddatei oder die Ruhezustandsdatei verwendet wird. Der markierte Arbeitsspeicher wird beibehalten und bleibt gültig, nachdem der Ruhezustand fortgesetzt wurde. Der zu markierende Speicher wird durch eine Adresse und bereichslänge in einem Aufruf von StorPortMarkDumpMemoryangegeben.
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 Hostbusadapter (HBA).
[in] Address
Die Startadresse des zu markierenden Speicherbereichs.
[in] Length
Die Länge des markierten Speicherbereichs.
[in] Flags
Kennzeichnungen für speicherabbilden. Der parameter Flags muss 0 sein oder nur den folgenden Wert enthalten.
| Wert | Bedeutung |
|---|---|
| MARK_DUMP_MEMORY_FLAG_PHYSICAL_ADDRESS | Die in Adresse angegebene Adresse ist eine physische Adresse und keine virtuelle Systemadresse. |
Rückgabewert
StorPortMarkDumpMemory gibt einen der folgenden Statuscodes zurück:
| Rückgabecode | Beschreibung |
|---|---|
| STOR_STATUS_SUCCESS | Gibt an, dass die Routine die Einheitenattribute erfolgreich festgelegt hat. |
| STOR_STATUS_INVALID_PARAMETER | Im parameter Flags wurde ein ungültiger Flagwert angegeben. |
Bemerkungen
Die StorPortMarkDumpMemory Routine darf nur von einem Miniporttreiber in seinem DriverEntry oder HwStorFindAdapter Routinen aufgerufen werden.
Wenn Length = 0, wird der gesamte Abschnitt mit Address markiert.
Miniport-Treiber sollten StorPortMarkDumpMemory- aufrufen, um sicherzustellen, dass der vom Miniport zum Generieren der Speicherabbilddatei oder der Ruhezustandsdatei verwendete Speicher identifiziert wird. Miniports sollten mindestens StorPortMarkDumpMemory- aufrufen, wenn das DumpMode-Element von PORT_CONFIGURATION_INFORMATION entweder auf DUMP_MODE_MARK_MEMORY oder DUMP_MODE_HIBERfestgelegt ist.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 8 |
| Zielplattform- | Universal |
| Header- | storport.h (include Storport.h) |
| IRQL- | Jegliche |