StorPortCaptureLiveDump 函数 (storport.h)

StorPortCaptureLiveDump 捕获实时转储文件。

语法

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

参数

[in] HwDeviceExtension

指向微型端口的硬件设备扩展的指针。

[in/optional] StorAddress

指向包含指定单元对象的地址 的STOR_ADDRESS 结构的指针。 如果设备是适配器,请将 StorAddress 设置为 NULL。

[in] CaptureLivedump

指向包含生成实时转储所需数据的 STORPORT_CAPTURE_LIVEDUMP 结构的指针。

返回值

StorPortCaptureLiveDump 返回以下值之一:

返回代码 说明
STOR_STATUS_SUCCESS 已成功设置转储功能列表。
STOR_STATUS_INVALID_PARAMETER 提供的一个或多个参数无效。
STOR_STATUS_UNSUCCESSFUL 由于其他内部系统原因而返回。

注解

当微型端口检测到可能需要进一步会审的问题时,它可以调用 StorPortCaptureLiveDump 来捕获实时转储文件。

必须在PASSIVE_LEVEL调用此函数。

要求

要求
最低受支持的服务器 Windows Server 2022
标头 storport.h
IRQL PASSIVE_LEVEL

另请参阅

STOR_ADDRESS

STORPORT_CAPTURE_LIVEDUMP

STORPORT_LIVEDUMP_DATA_TYPE

STORPORT_LIVEDUMP_DEVICE_TELEMETRY_LOG