Error Codes
[Audio Device API]

Audio devive library specific error codes.

Defines
#define	PJMEDIA_AUDIODEV_ERRNO_START   (PJ_ERRNO_START_USER + PJ_ERRNO_SPACE_SIZE*5)
#define	PJMEDIA_AUDIODEV_ERRNO_END   (PJMEDIA_AUDIODEV_ERRNO_START + PJ_ERRNO_SPACE_SIZE - 1)
#define	PJMEDIA_AUDIODEV_PORTAUDIO_ERRNO_START   (PJMEDIA_AUDIODEV_ERRNO_END-10000)
#define	PJMEDIA_AUDIODEV_PORTAUDIO_ERRNO_END   (PJMEDIA_AUDIODEV_PORTAUDIO_ERRNO_START + 10000 -1)
#define	PJMEDIA_AUDIODEV_ERRNO_FROM_PORTAUDIO(err)   ((int)PJMEDIA_AUDIODEV_PORTAUDIO_ERRNO_START-err)
#define	PJMEDIA_AUDIODEV_WMME_IN_ERROR_START   (PJMEDIA_AUDIODEV_ERRNO_START + 30000)
#define	PJMEDIA_AUDIODEV_WMME_IN_ERROR_END   (PJMEDIA_AUDIODEV_WMME_IN_ERROR_START + 1000 - 1)
#define	PJMEDIA_AUDIODEV_ERRNO_FROM_WMME_IN(err)   ((int)PJMEDIA_AUDIODEV_WMME_IN_ERROR_START+err)
#define	PJMEDIA_AUDIODEV_WMME_OUT_ERROR_START   (PJMEDIA_AUDIODEV_WMME_IN_ERROR_END + 1000)
#define	PJMEDIA_AUDIODEV_WMME_OUT_ERROR_END   (PJMEDIA_AUDIODEV_WMME_OUT_ERROR_START + 1000)
#define	PJMEDIA_AUDIODEV_ERRNO_FROM_WMME_OUT(err)   ((int)PJMEDIA_AUDIODEV_WMME_OUT_ERROR_START+err)
#define	PJMEDIA_AUDIODEV_COREAUDIO_ERRNO_START   (PJMEDIA_AUDIODEV_ERRNO_START+20000)
#define	PJMEDIA_AUDIODEV_COREAUDIO_ERRNO_END   (PJMEDIA_AUDIODEV_COREAUDIO_ERRNO_START + 20000 -1)
#define	PJMEDIA_AUDIODEV_ERRNO_FROM_COREAUDIO(err)   ((int)PJMEDIA_AUDIODEV_COREAUDIO_ERRNO_START-err)
#define	PJMEDIA_EAUD_ERR
#define	PJMEDIA_EAUD_SYSERR
#define	PJMEDIA_EAUD_INIT
#define	PJMEDIA_EAUD_INVDEV
#define	PJMEDIA_EAUD_NODEV
#define	PJMEDIA_EAUD_NODEFDEV
#define	PJMEDIA_EAUD_NOTREADY
#define	PJMEDIA_EAUD_INVCAP
#define	PJMEDIA_EAUD_INVOP
#define	PJMEDIA_EAUD_BADFORMAT
#define	PJMEDIA_EAUD_SAMPFORMAT
#define	PJMEDIA_EAUD_BADLATENCY
Functions
pj_str_t	pjmedia_audiodev_strerror (pj_status_t status, char *buffer, pj_size_t bufsize)

---

Define Documentation

#define PJMEDIA_AUDIODEV_ERRNO_START   (PJ_ERRNO_START_USER + PJ_ERRNO_SPACE_SIZE*5)

Start of error code relative to PJ_ERRNO_START_USER. This value is 420000.

#define PJMEDIA_AUDIODEV_PORTAUDIO_ERRNO_START   (PJMEDIA_AUDIODEV_ERRNO_END-10000)

Mapping from PortAudio error codes to pjmedia error space.

#define PJMEDIA_AUDIODEV_ERRNO_FROM_PORTAUDIO

(

err

)

((int)PJMEDIA_AUDIODEV_PORTAUDIO_ERRNO_START-err)

Convert PortAudio error code to PJLIB error code. PortAudio error code range: 0 >= err >= -10000

#define PJMEDIA_AUDIODEV_WMME_IN_ERROR_START   (PJMEDIA_AUDIODEV_ERRNO_START + 30000)

Mapping from Windows multimedia WaveIn error codes.

#define PJMEDIA_AUDIODEV_ERRNO_FROM_WMME_IN

(

err

)

((int)PJMEDIA_AUDIODEV_WMME_IN_ERROR_START+err)

Convert WaveIn operation error codes to PJLIB error space.

#define PJMEDIA_AUDIODEV_WMME_OUT_ERROR_START   (PJMEDIA_AUDIODEV_WMME_IN_ERROR_END + 1000)

Mapping from Windows multimedia WaveOut error codes.

#define PJMEDIA_AUDIODEV_ERRNO_FROM_WMME_OUT

(

err

)

((int)PJMEDIA_AUDIODEV_WMME_OUT_ERROR_START+err)

Convert WaveOut operation error codes to PJLIB error space.

#define PJMEDIA_AUDIODEV_COREAUDIO_ERRNO_START   (PJMEDIA_AUDIODEV_ERRNO_START+20000)

Mapping from CoreAudio error codes to pjmedia error space.

#define PJMEDIA_AUDIODEV_ERRNO_FROM_COREAUDIO

(

err

)

((int)PJMEDIA_AUDIODEV_COREAUDIO_ERRNO_START-err)

Convert CoreAudio error code to PJLIB error code. CoreAudio error code range: 0 >= err >= -10000

#define PJMEDIA_EAUD_ERR

General/unknown error.

#define PJMEDIA_EAUD_SYSERR

Unknown error from audio driver

#define PJMEDIA_EAUD_INIT

Audio subsystem not initialized

#define PJMEDIA_EAUD_INVDEV

Invalid audio device

#define PJMEDIA_EAUD_NODEV

Found no devices

#define PJMEDIA_EAUD_NODEFDEV

Unable to find default device

#define PJMEDIA_EAUD_NOTREADY

Device not ready

#define PJMEDIA_EAUD_INVCAP

The audio capability is invalid or not supported

#define PJMEDIA_EAUD_INVOP

The operation is invalid or not supported

#define PJMEDIA_EAUD_BADFORMAT

Bad or invalid audio device format

#define PJMEDIA_EAUD_SAMPFORMAT

Invalid audio device sample format

#define PJMEDIA_EAUD_BADLATENCY

Bad latency setting

---

Function Documentation

pj_str_t pjmedia_audiodev_strerror	(	pj_status_t	status,
		char *	buffer,
		pj_size_t	bufsize
	)

Get error message for the specified error code. Note that this function is only able to decode PJMEDIA Audiodev specific error code. Application should use pj_strerror(), which should be able to decode all error codes belonging to all subsystems (e.g. pjlib, pjmedia, pjsip, etc).

Parameters:

	status	The error code.
	buffer	The buffer where to put the error message.
	bufsize	Size of the buffer.

Returns:

The error message as NULL terminated string, wrapped with pj_str_t.