NvMedia CVScratchpad

Detailed Description

The NvMedia CVScratchpad API creates and destroys CVScratchpad objects for use as scratch memory for internal operation in media processing and computer vision pipelines.

Macros
#define	NVMEDIA_CVSCRATCHPAD_VERSION_MAJOR   (1u)
	Major version number. More...
#define	NVMEDIA_CVSCRATCHPAD_VERSION_MINOR   (1u)
	Minor version number. More...

Typedefs
typedef struct NvMediaCVScratchpad	NvMediaCVScratchpad
	Holds a descriptor for the CVScratchpad. More...

Enumerations
enum	NvMediaCVScratchMemoryAllocationType {   NVMEDIA_SCRATCH_MEMORY_TYPE_CVSRAM = 0,   NVMEDIA_SCRATCH_MEMORY_TYPE_DRAM = 1,   NVMEDIA_SCRATCH_NUM_MEMORY_TYPES = 2 }
	Specifies the type of memory that is allocated. More...

Functions
NvMediaStatus	NvMediaCVScratchpadGetVersion (NvMediaVersion *version)
	Returns version information for the CVScratchpad component. More...
NvMediaCVScratchpad *	NvMediaCVScratchpadCreate (NvMediaDevice *device, uint32_t size, NvMediaCVScratchMemoryAllocationType memoryType)
	Creates an NvMedia CVScratchpad handle. More...
NvMediaStatus	NvMediaCVScratchpadDestroy (NvMediaCVScratchpad *handle)
	Destroys a CVScratchpad handle created by NvMediaCVScratchpadCreate(). More...
NvMediaStatus	NvMediaCVScratchpadGetProperties (const NvMediaCVScratchpad *handle, uint32_t *size, NvMediaCVScratchMemoryAllocationType *memoryType)
	Gets the size in bytes and memory location type of a CVScratchpad. More...

Macro Definition Documentation

NVMEDIA_CVSCRATCHPAD_VERSION_MAJOR

#define NVMEDIA_CVSCRATCHPAD_VERSION_MAJOR   (1u)

Major version number.

Definition at line 38 of file nvmedia_cvscratchpad.h.

NVMEDIA_CVSCRATCHPAD_VERSION_MINOR

#define NVMEDIA_CVSCRATCHPAD_VERSION_MINOR   (1u)

Minor version number.

Definition at line 40 of file nvmedia_cvscratchpad.h.

Typedef Documentation

NvMediaCVScratchpad

typedef struct NvMediaCVScratchpad NvMediaCVScratchpad

Holds a descriptor for the CVScratchpad.

Note

The handle must be created and destroyed using NvMediaCVScratchpadCreate() and NvMediaCVScratchpadDestroy().

Definition at line 60 of file nvmedia_cvscratchpad.h.

Enumeration Type Documentation

NvMediaCVScratchMemoryAllocationType

enum NvMediaCVScratchMemoryAllocationType

Specifies the type of memory that is allocated.

Enumerator
NVMEDIA_SCRATCH_MEMORY_TYPE_CVSRAM	Specifies scratch memory allocated in CVSRAM.
NVMEDIA_SCRATCH_MEMORY_TYPE_DRAM	Specifies scratch memory allocated in DRAM.
NVMEDIA_SCRATCH_NUM_MEMORY_TYPES	Specifies the number of memory types.

Definition at line 44 of file nvmedia_cvscratchpad.h.

Function Documentation

NvMediaCVScratchpadCreate()

NvMediaCVScratchpad* NvMediaCVScratchpadCreate	(	NvMediaDevice *	device,
		uint32_t	size,
		NvMediaCVScratchMemoryAllocationType	memoryType
	)

Creates an NvMedia CVScratchpad handle.

Parameters

[in]	device	Handle to the NvMedia device returned by NvMediaDeviceCreate().
[in]	size	Size for the CVScratchpad allocation in bytes. Value must be in the range [1,4096].
[in]	memoryType	Type of memory to be allocated.

Returns

A handle to the allocated CVScratchpad, or NULL if the operation was unsuccessful.

NvMediaCVScratchpadDestroy()

NvMediaStatus NvMediaCVScratchpadDestroy

(

NvMediaCVScratchpad *

handle

)

Destroys a CVScratchpad handle created by NvMediaCVScratchpadCreate().

Parameters

[in]

handle

The handle to the CVScratchpad to be destroyed.

Returns

Status indicator. Possible return values are:

• NVMEDIA_STATUS_OK if the operation was successful.
• NVMEDIA_STATUS_BAD_PARAMETER if input argument was invalid or NULL.

NvMediaCVScratchpadGetProperties()

NvMediaStatus NvMediaCVScratchpadGetProperties	(	const NvMediaCVScratchpad *	handle,
		uint32_t *	size,
		NvMediaCVScratchMemoryAllocationType *	memoryType
	)

Gets the size in bytes and memory location type of a CVScratchpad.

Parameters

[in]	handle	Handle to a CVScratchpad.
[out]	size	A pointer to a location in which to store the size of the CVScratchpad.
[out]	memoryType	A pointer to a location in which to store the type of memory used.

Returns

Status indicator. Possible return values are:

• NVMEDIA_STATUS_OK if the operation was successful.
• NVMEDIA_STATUS_BAD_PARAMETER if input argument was invalid or NULL.

NvMediaCVScratchpadGetVersion()

NvMediaStatus NvMediaCVScratchpadGetVersion

(

NvMediaVersion *

version

)

Returns version information for the CVScratchpad component.

Parameters

[out]

version

A pointer to a structure that the function fills with version information.

Returns

Status indicator. Possible values are:

• NVMEDIA_STATUS_OK if the operation was successful
• NVMEDIA_STATUS_BAD_PARAMETER if version was invalid.