次の方法で共有

SnapshotOnDemand

  • [アーティクル]

指定されたプロセスの特定の SnapshotType のスナップショットを 1 回取得し、トレース バッファーにエクスポートします。 この 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 を指定できます。