CodecHeader

Detailed Description

Defines the codecheader types.

Typedefs
typedef struct dwCodecHeaderObject const *	dwCodecHeaderConstHandle_t
typedef struct dwCodecHeaderObject *	dwCodecHeaderHandle_t
	CodecHeader handle. More...

Functions
dwStatus	dwCodecHeader_create (dwCodecHeaderHandle_t *handle, dwCodecType type, void *codecConfig)
	Get the specified dwCodecType in a codec header. More...
dwStatus	dwCodecHeader_destroy (dwCodecHeaderHandle_t handle)
	Get the specified dwCodecType in a codec header. More...
dwStatus	dwCodecHeader_getCodecType (dwCodecType *type, dwCodecHeaderConstHandle_t handle)
	Get the specified dwCodecType in a codec header. More...
dwStatus	dwCodecHeader_getConfig (void *config, size_t configSize, dwMediaType mediaType, dwCodecHeaderConstHandle_t handle)
	Get the specified dwCodecConfig* in a codec header. More...
dwStatus	dwCodecHeader_getMediaType (dwMediaType *type, dwCodecHeaderConstHandle_t handle)
	Get the specified dwMediaType in a codec header. More...
dwStatus	dwCodecHeader_load (dwCodecHeaderHandle_t *handle, void *data, size_t dataSize, dwContextHandle_t context)
	Load a serialized codec header from JSON string. More...
dwStatus	dwCodecHeader_release (dwCodecHeaderHandle_t handle)
	Release resources associated with codec header. More...
dwStatus	dwCodecHeader_save (size_t *dataSize, void *data, size_t maxDataSize, dwCodecHeaderConstHandle_t handle)
	Serializes the codec header into JSON string. More...

Typedef Documentation

dwCodecHeaderConstHandle_t

typedef struct dwCodecHeaderObject const* dwCodecHeaderConstHandle_t

Definition at line 61 of file CodecHeader.h.

dwCodecHeaderHandle_t

typedef struct dwCodecHeaderObject* dwCodecHeaderHandle_t

CodecHeader handle.

Definition at line 60 of file CodecHeader.h.

Function Documentation

dwCodecHeader_create()

dwStatus dwCodecHeader_create	(	dwCodecHeaderHandle_t *	handle,
		dwCodecType	type,
		void *	codecConfig
	)

Get the specified dwCodecType in a codec header.

Parameters

[out]	handle	the pointer in which the created codec header is stored
[in]	type	the type of codec header to create
[in]	codecConfig	the config associated with the type. Such as dwCodecConfigVideo for video codec types

Returns

DW_NOT_SUPPORT if type is not a supported type.
DW_INVALID_ARGUMENT if handle is nullptr DW_SUCCESS

dwCodecHeader_destroy()

dwStatus dwCodecHeader_destroy

(

dwCodecHeaderHandle_t

handle

)

Get the specified dwCodecType in a codec header.

Parameters

[in]

handle

the handle to release

Returns

DW_SUCCESS

dwCodecHeader_getCodecType()

dwStatus dwCodecHeader_getCodecType	(	dwCodecType *	type,
		dwCodecHeaderConstHandle_t	handle
	)

Get the specified dwCodecType in a codec header.

Parameters

[out]	type	stored in codec header
[in]	handle	the handle of codec header

Returns

DW_INVALID_ARGUMENT if type or codecHeader is nullptr.
DW_SUCCESS

dwCodecHeader_getConfig()

dwStatus dwCodecHeader_getConfig	(	void *	config,
		size_t	configSize,
		dwMediaType	mediaType,
		dwCodecHeaderConstHandle_t	handle
	)

Get the specified dwCodecConfig* in a codec header.

Parameters

[out]	config	stored in codec header
[in]	configSize	size of the memory pointed by the passed in config pointer
[in]	mediaType	media type corresonding to the codecHeader
[in]	handle	the handle of codec header

Returns

DW_INVALID_ARGUMENT if config or codecHeader is nullptr, or if configSize mismatches the expected size of specified mediaType.
DW_SUCCESS

dwCodecHeader_getMediaType()

dwStatus dwCodecHeader_getMediaType	(	dwMediaType *	type,
		dwCodecHeaderConstHandle_t	handle
	)

Get the specified dwMediaType in a codec header.

Parameters

[out]	type	stored in codec header
[in]	handle	the handle of codec header

Returns

DW_INVALID_ARGUMENT if type or codecHeader is nullptr.
DW_SUCCESS

dwCodecHeader_load()

dwStatus dwCodecHeader_load	(	dwCodecHeaderHandle_t *	handle,
		void *	data,
		size_t	dataSize,
		dwContextHandle_t	context
	)

Load a serialized codec header from JSON string.

Parameters

[out]	handle	the handle of codec to populate
[in]	data	pointer to memory block to containing the serialized codec header
[in]	dataSize	size of the serialized data
[in]	context	DW context

Returns

DW_INVALID_ARGUMENT if data or codecHeader is nullptr.
DW_SUCCESS

dwCodecHeader_release()

dwStatus dwCodecHeader_release

(

dwCodecHeaderHandle_t

handle

)

Release resources associated with codec header.

Parameters

[in]

handle

the handle of codec to populate

Returns

DW_SUCCESS

dwCodecHeader_save()

dwStatus dwCodecHeader_save	(	size_t *	dataSize,
		void *	data,
		size_t	maxDataSize,
		dwCodecHeaderConstHandle_t	handle
	)

Serializes the codec header into JSON string.

Parameters

[out]	dataSize	size of the serialized data
[out]	data	pointer to memory block to store the serialized string
[in]	maxDataSize	size of the memory block pointed to by data
[in]	handle	the handle of codec header

Returns

DW_INVALID_ARGUMENT if dataSize, data or codecHeader is nullptr, or if maxDataSize is smaller than the serialized size.
DW_SUCCESS