Context Management

Collaboration diagram for Context Management:

Modules
	Context Management [Deprecated]

Functions
hipError_t	hipDevicePrimaryCtxGetState (hipDevice_t dev, unsigned int *flags, int *active)
	Get the state of the primary context. More...
hipError_t	hipDevicePrimaryCtxRelease (hipDevice_t dev)
	Release the primary context on the GPU. More...
hipError_t	hipDevicePrimaryCtxRetain (hipCtx_t *pctx, hipDevice_t dev)
	Retain the primary context on the GPU. More...
hipError_t	hipDevicePrimaryCtxReset (hipDevice_t dev)
	Resets the primary context on the GPU. More...
hipError_t	hipDevicePrimaryCtxSetFlags (hipDevice_t dev, unsigned int flags)
	Set flags for the primary context. More...

Detailed Description

----------------------------------------------------------------------------------------------—

This section describes the context management functions of HIP runtime API.

Function Documentation

hipError_t hipDevicePrimaryCtxGetState	(	hipDevice_t	dev,
		unsigned int *	flags,
		int *	active
	)

Get the state of the primary context.

Parameters

[in]	Device	to get primary context flags for
[out]	Pointer	to store flags
[out]	Pointer	to store context state; 0 = inactive, 1 = active

Returns

#hipSuccess

See also

hipCtxCreate, hipCtxDestroy, hipCtxGetFlags, hipCtxPopCurrent, hipCtxGetCurrent, hipCtxSetCurrent, hipCtxPushCurrent, hipCtxSetCacheConfig, hipCtxSynchronize, hipCtxGetDevice

hipError_t hipDevicePrimaryCtxRelease

(

hipDevice_t

dev

)

Release the primary context on the GPU.

Parameters

[in]

Device

which primary context is released

Returns

#hipSuccess

See also

hipCtxCreate, hipCtxDestroy, hipCtxGetFlags, hipCtxPopCurrent, hipCtxGetCurrent, hipCtxSetCurrent, hipCtxPushCurrent, hipCtxSetCacheConfig, hipCtxSynchronize, hipCtxGetDevice

Warning

This function return #hipSuccess though doesn't release the primaryCtx by design on HIP/HCC path.

hipError_t hipDevicePrimaryCtxReset

(

hipDevice_t

dev

)

Resets the primary context on the GPU.

Parameters

[in]

Device

which primary context is reset

Returns

#hipSuccess

See also

hipCtxCreate, hipCtxDestroy, hipCtxGetFlags, hipCtxPopCurrent, hipCtxGetCurrent, hipCtxSetCurrent, hipCtxPushCurrent, hipCtxSetCacheConfig, hipCtxSynchronize, hipCtxGetDevice

hipError_t hipDevicePrimaryCtxRetain	(	hipCtx_t *	pctx,
		hipDevice_t	dev
	)

Retain the primary context on the GPU.

Parameters

[out]	Returned	context handle of the new context
[in]	Device	which primary context is released

Returns

#hipSuccess

See also

hipCtxCreate, hipCtxDestroy, hipCtxGetFlags, hipCtxPopCurrent, hipCtxGetCurrent, hipCtxSetCurrent, hipCtxPushCurrent, hipCtxSetCacheConfig, hipCtxSynchronize, hipCtxGetDevice

hipError_t hipDevicePrimaryCtxSetFlags	(	hipDevice_t	dev,
		unsigned int	flags
	)

Set flags for the primary context.

Parameters

[in]	Device	for which the primary context flags are set
[in]	New	flags for the device

Returns

#hipSuccess, #hipErrorContextAlreadyInUse

See also

hipCtxCreate, hipCtxDestroy, hipCtxGetFlags, hipCtxPopCurrent, hipCtxGetCurrent, hipCtxSetCurrent, hipCtxPushCurrent, hipCtxSetCacheConfig, hipCtxSynchronize, hipCtxGetDevice