Handle

Typedefs | Enumerations | Functions

Handle

Typedefs
typedef void *(*	miopenAllocatorFunction) (void *context, size_t sizeBytes)
	Custom allocator function. More...
typedef void(*	miopenDeallocatorFunction) (void *context, void *memory)
	Custom deallocator function. More...

Enumerations
enum	miopenStatus_t {   miopenStatusSuccess = 0 ,   miopenStatusNotInitialized = 1 ,   miopenStatusInvalidValue = 2 ,   miopenStatusBadParm = 3 ,   miopenStatusAllocFailed = 4 ,   miopenStatusInternalError = 5 ,   miopenStatusNotImplemented = 6 ,   miopenStatusUnknownError = 7 ,   miopenStatusUnsupportedOp = 8 ,   miopenStatusGpuOperationsSkipped = 9 ,   miopenStatusVersionMismatch = 10 }
enum	miopenF8RoundingMode_t {   miopenF8RoundingModeStandard = 0 ,   miopenF8RoundingModeStochastic = 1 }

Functions
	MIOPEN_DECLARE_OBJECT (miopenHandle)
	Creates the miopenHandle_t type. More...
const char *	miopenGetErrorString (miopenStatus_t error)
	Get character string for an error code. More...
miopenStatus_t	miopenGetVersion (size_t *major, size_t *minor, size_t *patch)
	Method to return version of MIOpen. More...
miopenStatus_t	miopenCreate (miopenHandle_t *handle)
	Method to create the MIOpen handle object. More...
miopenStatus_t	miopenCreateWithStream (miopenHandle_t *handle, miopenAcceleratorQueue_t stream)
	Create a MIOpen handle with an accelerator stream. More...
miopenStatus_t	miopenDestroy (miopenHandle_t handle)
	Destroys the MIOpen handle. More...
miopenStatus_t	miopenSetStream (miopenHandle_t handle, miopenAcceleratorQueue_t streamID)
	Set accelerator command queue previously created. More...
miopenStatus_t	miopenGetStream (miopenHandle_t handle, miopenAcceleratorQueue_t *streamID)
	Get the previously created accelerator command queue. More...
miopenStatus_t	miopenSetAllocator (miopenHandle_t handle, miopenAllocatorFunction allocator, miopenDeallocatorFunction deallocator, void *allocatorContext)
	Set allocator for previously created miopenHandle. More...
miopenStatus_t	miopenGetKernelTime (miopenHandle_t handle, float *time)
	Get time for last kernel launched. More...
miopenStatus_t	miopenEnableProfiling (miopenHandle_t handle, bool enable)
	Enable profiling to retrieve kernel time. More...

Detailed Description

Typedef Documentation

◆ miopenAllocatorFunction

typedef void*(* miopenAllocatorFunction) (void *context, size_t sizeBytes)

Custom allocator function.

This function allow for user-defined custom allocator

Parameters

context	A pointer a context (input)
sizeBytes	Number of bytes to allocate (input)

Examples

/home/docs/checkouts/readthedocs.org/user_builds/advanced-micro-devices-miopen/checkouts/develop/include/miopen/miopen.h.

◆ miopenDeallocatorFunction

typedef void(* miopenDeallocatorFunction) (void *context, void *memory)

Custom deallocator function.

This function allow for user-defined custom deallocation function

Parameters

context	A pointer context (input)
memory	A pointer allocated memory (input)

Examples

/home/docs/checkouts/readthedocs.org/user_builds/advanced-micro-devices-miopen/checkouts/develop/include/miopen/miopen.h.

Enumeration Type Documentation

◆ miopenF8RoundingMode_t

enum miopenF8RoundingMode_t

Enumerator
miopenF8RoundingModeStandard
miopenF8RoundingModeStochastic

Examples

/home/docs/checkouts/readthedocs.org/user_builds/advanced-micro-devices-miopen/checkouts/develop/include/miopen/miopen.h.

◆ miopenStatus_t

enum miopenStatus_t

Error codes that are returned by all MIOpen API calls.

Enumerator
miopenStatusSuccess	No errors
miopenStatusNotInitialized	Data not initialized.
miopenStatusInvalidValue	Incorrect variable value.
miopenStatusBadParm	Incorrect parameter detected.
miopenStatusAllocFailed	Memory allocation error.
miopenStatusInternalError	MIOpen failure.
miopenStatusNotImplemented	Use of unimplemented feature.
miopenStatusUnknownError	Unknown error occurred.
miopenStatusUnsupportedOp	Unsupported operator for fusion.
miopenStatusGpuOperationsSkipped	This is not an error.
miopenStatusVersionMismatch	Version mismatch of the supplied binary data argment.

Examples

/home/docs/checkouts/readthedocs.org/user_builds/advanced-micro-devices-miopen/checkouts/develop/include/miopen/miopen.h.

Function Documentation

◆ MIOPEN_DECLARE_OBJECT()

MIOPEN_DECLARE_OBJECT

(

miopenHandle

)

Creates the miopenHandle_t type.

◆ miopenCreate()

miopenStatus_t miopenCreate

(

miopenHandle_t *

handle

)

Method to create the MIOpen handle object.

This function creates a MIOpen handle. This is called at the very start to initialize the MIOpen environment.

Parameters

handle

A pointer to a MIOpen handle type (output)

Returns

miopenStatus_t

Examples

/home/docs/checkouts/readthedocs.org/user_builds/advanced-micro-devices-miopen/checkouts/develop/include/miopen/miopen.h.

◆ miopenCreateWithStream()

miopenStatus_t miopenCreateWithStream	(	miopenHandle_t *	handle,
		miopenAcceleratorQueue_t	stream
	)

Create a MIOpen handle with an accelerator stream.

The HIP side uses a hipStream_t type for the stream, while OpenCL will use a cl_command_queue.

Create a handle with a previously created accelerator command queue.

Parameters

handle	A pointer to a MIOpen handle type (output)
stream	An accelerator queue type (input)

Returns

miopenStatus_t

Examples

/home/docs/checkouts/readthedocs.org/user_builds/advanced-micro-devices-miopen/checkouts/develop/include/miopen/miopen.h.

◆ miopenDestroy()

miopenStatus_t miopenDestroy

(

miopenHandle_t

handle

)

Destroys the MIOpen handle.

This is called when breaking down the MIOpen environment.

Parameters

handle

MIOpen handle (input)

Returns

miopenStatus_t

Examples

/home/docs/checkouts/readthedocs.org/user_builds/advanced-micro-devices-miopen/checkouts/develop/include/miopen/miopen.h.

◆ miopenEnableProfiling()

miopenStatus_t miopenEnableProfiling	(	miopenHandle_t	handle,
		bool	enable
	)

Enable profiling to retrieve kernel time.

Enable or disable kernel profiling. This profiling is only for kernel time.

Parameters

handle	MIOpen handle (input)
enable	Boolean to toggle profiling (input)

Returns

miopenStatus_t

Examples

/home/docs/checkouts/readthedocs.org/user_builds/advanced-micro-devices-miopen/checkouts/develop/include/miopen/miopen.h.

◆ miopenGetErrorString()

const char* miopenGetErrorString

(

miopenStatus_t

error

)

Get character string for an error code.

A function which returns a NULL terminated character string of the error code.

Parameters

error

miopenStatus_t type error status (input)

Returns

errorString

Examples

/home/docs/checkouts/readthedocs.org/user_builds/advanced-micro-devices-miopen/checkouts/develop/include/miopen/miopen.h.

◆ miopenGetKernelTime()

miopenStatus_t miopenGetKernelTime	(	miopenHandle_t	handle,
		float *	time
	)

Get time for last kernel launched.

This function is used only when profiling mode has been enabled. Kernel timings are based on the MIOpen handle and is not thread-safe. In order to use multi-threaded profiling, create an MIOpen handle for each concurrent thread.

Parameters

handle	MIOpen handle (input)
time	Pointer to a float type to contain kernel time in milliseconds (output)

Returns

miopenStatus_t

Examples

/home/docs/checkouts/readthedocs.org/user_builds/advanced-micro-devices-miopen/checkouts/develop/include/miopen/miopen.h.

◆ miopenGetStream()

miopenStatus_t miopenGetStream	(	miopenHandle_t	handle,
		miopenAcceleratorQueue_t *	streamID
	)

Get the previously created accelerator command queue.

Creates a command queue for an accelerator device

Parameters

handle	MIOpen handle (input)
streamID	Pointer to a accelerator queue type (output)

Returns

miopenStatus_t

Examples

/home/docs/checkouts/readthedocs.org/user_builds/advanced-micro-devices-miopen/checkouts/develop/include/miopen/miopen.h.

◆ miopenGetVersion()

miopenStatus_t miopenGetVersion	(	size_t *	major,
		size_t *	minor,
		size_t *	patch
	)

Method to return version of MIOpen.

The output values of this call follow from the versioning format major.minor.patch

Pointers that are NULL will be ignored.

Parameters

major	Major version number (output)
minor	Minor version number (output)
patch	Patch version number (output)

Returns

miopenStatus_t

Examples

/home/docs/checkouts/readthedocs.org/user_builds/advanced-micro-devices-miopen/checkouts/develop/include/miopen/miopen.h.

◆ miopenSetAllocator()

miopenStatus_t miopenSetAllocator	(	miopenHandle_t	handle,
		miopenAllocatorFunction	allocator,
		miopenDeallocatorFunction	deallocator,
		void *	allocatorContext
	)

Set allocator for previously created miopenHandle.

Set a command queue for an accelerator device

Parameters

handle	MIOpen handle
allocator	A callback function MIOpen will use for internal memory allocations. The provided callback function should allocate device memory with requested size and return a pointer to this memory. Passing 0 will restore the default MIOpen allocator and deallocator.
deallocator	A callback function MIOpen will use to for internal memory deallocation. The provided callback function should free the specified memory pointer
allocatorContext	User-specified pointer which is passed to allocator and deallocator This allows the callback function to access state set by the caller to this function, for example a stateful heap allocator or a c++ class.

Returns

miopenStatus_t

Examples

/home/docs/checkouts/readthedocs.org/user_builds/advanced-micro-devices-miopen/checkouts/develop/include/miopen/miopen.h.

◆ miopenSetStream()

miopenStatus_t miopenSetStream	(	miopenHandle_t	handle,
		miopenAcceleratorQueue_t	streamID
	)

Set accelerator command queue previously created.

Set a command queue for an accelerator device

Parameters

handle	MIOpen handle (input)
streamID	An accelerator queue type (input)

Returns

miopenStatus_t

Examples

/home/docs/checkouts/readthedocs.org/user_builds/advanced-micro-devices-miopen/checkouts/develop/include/miopen/miopen.h.