Bewerken

Delen via


StorPortCaptureLiveDump function (storport.h)

StorPortCaptureLiveDump captures a live dump file.

Syntax

ULONG StorPortCaptureLiveDump(
  [in]          PVOID                      HwDeviceExtension,
  [in/optional] PSTOR_ADDRESS              StorAddress,
  [in]          PSTORPORT_CAPTURE_LIVEDUMP CaptureLivedump
);

Parameters

[in] HwDeviceExtension

Pointer to the miniport's hardware device extension.

[in/optional] StorAddress

Pointer to a STOR_ADDRESS structure that holds the address specifying the unit object. Set StorAddress to NULL if the device is an adapter.

[in] CaptureLivedump

Pointer to a STORPORT_CAPTURE_LIVEDUMP structure containing the data needed to generate the live dump.

Return value

StorPortCaptureLiveDump returns one of the following values:

Return code Description
STOR_STATUS_SUCCESS The dump feature list was set successfully.
STOR_STATUS_INVALID_PARAMETER One or more of the provided parameters are invalid.
STOR_STATUS_UNSUCCESSFUL Returned for other internal system reasons.

Remarks

When a miniport detects an issue that might require further triage, it can call StorPortCaptureLiveDump to capture a live dump file.

This function must be called at PASSIVE_LEVEL.

Requirements

Requirement Value
Minimum supported server Windows Server 2022
Header storport.h
IRQL PASSIVE_LEVEL

See also

STOR_ADDRESS

STORPORT_CAPTURE_LIVEDUMP

STORPORT_LIVEDUMP_DATA_TYPE

STORPORT_LIVEDUMP_DEVICE_TELEMETRY_LOG