Поделиться через

SnapshotOnDemand

  • Статья

Занимает одно время snapshot для заданного SnapshotType для указанных процессов, а затем экспортирует данные в буферы трассировки. Перед вызовом этого API необходимо настроить snapshot.

Синтаксис

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

Параметры

snapshotType
[in] SnapshotType.
Примечание. В настоящее время доступен только SnapshotTypeSnapshotType_Heap.
Pid
[in] Указатель на массив идентификаторов процессов. Можно указать до 8 идентификаторов процессов.
cPids
[in] Число идентификаторов процессов в массиве. Максимальное число — 8.

Возвращаемое значение

В следующей таблице описаны возможные возвращаемые значения.

Возвращаемое значение Описание:
S_OK Snapshot успешно принимается для указанных процессов.
E_WPRC_EXCEEDED_HEAP_SNAPSHOT_PIDS Количество ИДЕНТИФИКАТОРов превысило максимально допустимое ограничение. Можно указать до 8 пид.