StorPortCaptureLiveDump-Funktion (storport.h)
StorPortCaptureLiveDump erfasst eine Liveabbilddatei.
Syntax
ULONG StorPortCaptureLiveDump(
[in] PVOID HwDeviceExtension,
[in/optional] PSTOR_ADDRESS StorAddress,
[in] PSTORPORT_CAPTURE_LIVEDUMP CaptureLivedump
);
Parameter
[in] HwDeviceExtension
Zeiger auf die Hardwaregeräteerweiterung des Miniports.
[in/optional] StorAddress
Zeiger auf eine STOR_ADDRESS-Struktur , die die Adresse enthält, die das Einheitsobjekt angibt. Legen Sie StorAddress auf NULL fest, wenn es sich bei dem Gerät um einen Adapter handelt.
[in] CaptureLivedump
Zeiger auf eine STORPORT_CAPTURE_LIVEDUMP Struktur, die die zum Generieren des Liveabbilds erforderlichen Daten enthält.
Rückgabewert
StorPortCaptureLiveDump gibt einen der folgenden Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
| STOR_STATUS_SUCCESS | Die Liste der Dumpfeatures wurde erfolgreich festgelegt. |
| STOR_STATUS_INVALID_PARAMETER | Mindestens einer der bereitgestellten Parameter ist ungültig. |
| STOR_STATUS_UNSUCCESSFUL | Wird aus anderen internen Systemgründen zurückgegeben. |
Hinweise
Wenn ein Miniport ein Problem erkennt, das möglicherweise eine weitere Triage erfordert, kann storPortCaptureLiveDump aufgerufen werden, um eine Liveabbilddatei zu erfassen.
Diese Funktion muss bei PASSIVE_LEVEL aufgerufen werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Server) | Windows Server 2022 |
| Kopfzeile | storport.h |
| IRQL | PASSIVE_LEVEL |