k4a_playback_get_attachment()

k4a_buffer_result_t k4a_playback_get_attachment	(	k4a_playback_t	playback_handle,
		const char *	file_name,
		uint8_t *	data,
		size_t *	data_size
	)

Reads an attachment file from a recording.

Parameters

playback_handle	Handle obtained by k4a_playback_open().
file_name	The attachment file name.
data	Location to write the attachment data. If a NULL buffer is specified, data_size will be set to the size of buffer needed to store the data.
data_size	On input, the size of the data buffer. On output, this is set to the length of the attachment data.

Returns

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