aclrtSnapShotProcessLock

Note: This API is for trial use and may be changed in later versions. It is not available in production environments.

Applicable Products

Product	Supported
Ascend 950PR	√
Ascend 950DT	☓
Atlas A3 training products/Atlas A3 inference products	√
Atlas A2 training products/Atlas A2 inference products	√
Atlas 200I/500 A2 inference products	X
Atlas inference products	X
Atlas training products	X

Function

Locks the current process to prevent subsequent runtime API calls for purposes such as device setup/release, memory allocation/freeing/copying, creation and destruction of resources such as Context, Stream, Event, and Notify, as well as delivery of certain tasks.

Before calling this API, ensure that the current process is in the RUNNING state, which is the default state. After this API is called, the current process will transition to the LOCKED state.

Prototype

aclError aclrtSnapShotProcessLock(int pid, void* reserve)

Parameters

Parameter	Input/Output	Description
pid	Input	Process ID. Only the ID of the current process can be passed. Cross-process operation is not supported.
reserve	Input	Reserved parameter. Only NULL is supported currently.

Returns

0 on success; otherwise, failure. For details, see aclError.

Parent topic: Snapshot Management