SnapshotOnDemand

  • 项目

为指定进程创建给定 SnapshotType 的一次快照，然后导出到跟踪缓冲区。 在调用此 API 之前，必须配置快照。

语法

HRESULT SnapshotOnDemand
([in] SnapshotType snapshotType,
[in] ULONG* pids,
[in] ULONG cPids);

参数

snapshotType
[in] SnapshotType。
注意：目前唯一可用的 SnapshotType 为 SnapshotType_Heap。
pids
[in] 指向进程 ID 数组的指针。 最多可指定 8 个进程 ID。
cPids
[in] 数组中的进程 ID 数。 最大数目为 8。

返回值

下表描述了可能的返回值。

返回值 说明
S_OK 为指定的进程成功创建快照。
E_WPRC_EXCEEDED_HEAP_SNAPSHOT_PIDS PID 数超出了允许的最大限制。 最多可指定 8 个 PID。