k4a_playback_track_get_codec_context()

k4a_buffer_result_t k4a_playback_track_get_codec_context	(	k4a_playback_t	playback_handle,
		const char *	track_name,
		uint8_t *	codec_context,
		size_t *	codec_context_size
	)

Gets the codec context for a particular track.

The codec context is a codec-specific buffer that contains any required codec metadata that is only known to the codec. It is mapped to the matroska Codec Private field.

Parameters

playback_handle	Handle obtained by k4a_playback_open().
track_name	The track name to read the codec context from.
codec_context	Location to write the codec context data. If a NULL buffer is specified, codec_context_size will be set to the size of buffer needed to store the data.
codec_context_size	On input, the size of the codec_context buffer. On output, this is set to the length of the codec_context data.

Returns

A return of K4A_BUFFER_RESULT_SUCCEEDED means that the codec_context has been filled in. If the buffer is too small the function returns K4A_BUFFER_RESULT_TOO_SMALL and the needed size of the codec_context buffer is returned in the codec_context_size parameter. K4A_BUFFER_RESULT_FAILED is returned if the track_name does not exist. All other failures return K4A_BUFFER_RESULT_FAILED.