StorPortCaptureLiveDump-Funktion (storport.h)

Artikel
02/07/2025

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

Zeigen Sie auf eine STOR_ADDRESS-Struktur, die die Adresse enthält, die das Einheitenobjekt angibt. Legen Sie StorAddress- auf NULL fest, wenn das Gerät ein Adapter ist.

[in] CaptureLivedump

Zeigen Sie auf eine STORPORT_CAPTURE_LIVEDUMP Struktur, die die daten enthält, die zum Generieren des Liveabbilds erforderlich sind.

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.

Bemerkungen

Wenn ein Miniport ein Problem erkennt, das möglicherweise eine weitere Triage erfordert, kann er StorPortCaptureLiveDump- aufrufen, um eine Liveabbilddatei zu erfassen.

Diese Funktion muss bei PASSIVE_LEVEL aufgerufen werden.