229 lines
6.3 KiB
C
229 lines
6.3 KiB
C
|
/* $Id$ */
|
||
|
|
/*
|
||
|
|
* Copyright (C) 2008-2011 Teluu Inc. (http://www.teluu.com)
|
||
|
|
*
|
||
|
|
* This program is free software; you can redistribute it and/or modify
|
||
|
|
* it under the terms of the GNU General Public License as published by
|
||
|
|
* the Free Software Foundation; either version 2 of the License, or
|
||
|
|
* (at your option) any later version.
|
||
|
|
*
|
||
|
|
* This program is distributed in the hope that it will be useful,
|
||
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||
|
|
* GNU General Public License for more details.
|
||
|
|
*
|
||
|
|
* You should have received a copy of the GNU General Public License
|
||
|
|
* along with this program; if not, write to the Free Software
|
||
|
|
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
||
|
|
*/
|
||
|
|
#ifndef __PJMEDIA_AUDIODEV_AUDIODEV_ERRNO_H__
|
||
|
|
#define __PJMEDIA_AUDIODEV_AUDIODEV_ERRNO_H__
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @file errno.h Error Codes
|
||
|
|
* @brief Audiodev specific error codes.
|
||
|
|
*/
|
||
|
|
|
||
|
|
#include <pjmedia-audiodev/config.h>
|
||
|
|
#include <pj/errno.h>
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @defgroup error_codes Error Codes
|
||
|
|
* @ingroup audio_device_api
|
||
|
|
* @brief Audio devive library specific error codes.
|
||
|
|
* @{
|
||
|
|
*/
|
||
|
|
|
||
|
|
|
||
|
|
PJ_BEGIN_DECL
|
||
|
|
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Start of error code relative to PJ_ERRNO_START_USER.
|
||
|
|
* This value is 420000.
|
||
|
|
*/
|
||
|
|
#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)
|
||
|
|
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Mapping from PortAudio error codes to pjmedia error space.
|
||
|
|
*/
|
||
|
|
#define PJMEDIA_AUDIODEV_PORTAUDIO_ERRNO_START \
|
||
|
|
(PJMEDIA_AUDIODEV_ERRNO_END-10000)
|
||
|
|
#define PJMEDIA_AUDIODEV_PORTAUDIO_ERRNO_END \
|
||
|
|
(PJMEDIA_AUDIODEV_PORTAUDIO_ERRNO_START + 10000 -1)
|
||
|
|
/**
|
||
|
|
* Convert PortAudio error code to PJLIB error code.
|
||
|
|
* PortAudio error code range: 0 >= err >= -10000
|
||
|
|
*/
|
||
|
|
#define PJMEDIA_AUDIODEV_ERRNO_FROM_PORTAUDIO(err) \
|
||
|
|
((int)PJMEDIA_AUDIODEV_PORTAUDIO_ERRNO_START-err)
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Mapping from Windows multimedia WaveIn error codes.
|
||
|
|
*/
|
||
|
|
#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)
|
||
|
|
/**
|
||
|
|
* Convert WaveIn operation error codes to PJLIB error space.
|
||
|
|
*/
|
||
|
|
#define PJMEDIA_AUDIODEV_ERRNO_FROM_WMME_IN(err) \
|
||
|
|
((int)PJMEDIA_AUDIODEV_WMME_IN_ERROR_START+err)
|
||
|
|
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Mapping from Windows multimedia WaveOut error codes.
|
||
|
|
*/
|
||
|
|
#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)
|
||
|
|
/**
|
||
|
|
* Convert WaveOut operation error codes to PJLIB error space.
|
||
|
|
*/
|
||
|
|
#define PJMEDIA_AUDIODEV_ERRNO_FROM_WMME_OUT(err) \
|
||
|
|
((int)PJMEDIA_AUDIODEV_WMME_OUT_ERROR_START+err)
|
||
|
|
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Mapping from CoreAudio error codes to pjmedia error space.
|
||
|
|
*/
|
||
|
|
#define PJMEDIA_AUDIODEV_COREAUDIO_ERRNO_START \
|
||
|
|
(PJMEDIA_AUDIODEV_ERRNO_START+20000)
|
||
|
|
#define PJMEDIA_AUDIODEV_COREAUDIO_ERRNO_END \
|
||
|
|
(PJMEDIA_AUDIODEV_COREAUDIO_ERRNO_START + 20000 -1)
|
||
|
|
/**
|
||
|
|
* Convert CoreAudio error code to PJLIB error code.
|
||
|
|
* CoreAudio error code range: 0 >= err >= -10000
|
||
|
|
*/
|
||
|
|
#define PJMEDIA_AUDIODEV_ERRNO_FROM_COREAUDIO(err) \
|
||
|
|
((int)PJMEDIA_AUDIODEV_COREAUDIO_ERRNO_START-err)
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Mapping from BDIMAD error codes to pjmedia error space.
|
||
|
|
*/
|
||
|
|
#define PJMEDIA_AUDIODEV_BDIMAD_ERROR_START \
|
||
|
|
(PJMEDIA_AUDIODEV_ERRNO_START + 40000)
|
||
|
|
#define PJMEDIA_AUDIODEV_BDIMAD_ERROR_END \
|
||
|
|
(PJMEDIA_AUDIODEV_BDIMAD_ERROR_START + 2000 - 1)
|
||
|
|
/**
|
||
|
|
* Convert BDIMAD error codes to PJLIB error space.
|
||
|
|
*/
|
||
|
|
#define PJMEDIA_AUDIODEV_ERRNO_FROM_BDIMAD(err) \
|
||
|
|
((int)PJMEDIA_AUDIODEV_BDIMAD_ERROR_START+err)
|
||
|
|
|
||
|
|
/************************************************************
|
||
|
|
* Audio Device API error codes
|
||
|
|
***********************************************************/
|
||
|
|
/**
|
||
|
|
* @hideinitializer
|
||
|
|
* General/unknown error.
|
||
|
|
*/
|
||
|
|
#define PJMEDIA_EAUD_ERR (PJMEDIA_AUDIODEV_ERRNO_START+1) /* 420001 */
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @hideinitializer
|
||
|
|
* Unknown error from audio driver
|
||
|
|
*/
|
||
|
|
#define PJMEDIA_EAUD_SYSERR (PJMEDIA_AUDIODEV_ERRNO_START+2) /* 420002 */
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @hideinitializer
|
||
|
|
* Audio subsystem not initialized
|
||
|
|
*/
|
||
|
|
#define PJMEDIA_EAUD_INIT (PJMEDIA_AUDIODEV_ERRNO_START+3) /* 420003 */
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @hideinitializer
|
||
|
|
* Invalid audio device
|
||
|
|
*/
|
||
|
|
#define PJMEDIA_EAUD_INVDEV (PJMEDIA_AUDIODEV_ERRNO_START+4) /* 420004 */
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @hideinitializer
|
||
|
|
* Found no devices
|
||
|
|
*/
|
||
|
|
#define PJMEDIA_EAUD_NODEV (PJMEDIA_AUDIODEV_ERRNO_START+5) /* 420005 */
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @hideinitializer
|
||
|
|
* Unable to find default device
|
||
|
|
*/
|
||
|
|
#define PJMEDIA_EAUD_NODEFDEV (PJMEDIA_AUDIODEV_ERRNO_START+6) /* 420006 */
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @hideinitializer
|
||
|
|
* Device not ready
|
||
|
|
*/
|
||
|
|
#define PJMEDIA_EAUD_NOTREADY (PJMEDIA_AUDIODEV_ERRNO_START+7) /* 420007 */
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @hideinitializer
|
||
|
|
* The audio capability is invalid or not supported
|
||
|
|
*/
|
||
|
|
#define PJMEDIA_EAUD_INVCAP (PJMEDIA_AUDIODEV_ERRNO_START+8) /* 420008 */
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @hideinitializer
|
||
|
|
* The operation is invalid or not supported
|
||
|
|
*/
|
||
|
|
#define PJMEDIA_EAUD_INVOP (PJMEDIA_AUDIODEV_ERRNO_START+9) /* 420009 */
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @hideinitializer
|
||
|
|
* Bad or invalid audio device format
|
||
|
|
*/
|
||
|
|
#define PJMEDIA_EAUD_BADFORMAT (PJMEDIA_AUDIODEV_ERRNO_START+10) /* 4200010 */
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @hideinitializer
|
||
|
|
* Invalid audio device sample format
|
||
|
|
*/
|
||
|
|
#define PJMEDIA_EAUD_SAMPFORMAT (PJMEDIA_AUDIODEV_ERRNO_START+11) /* 4200011 */
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @hideinitializer
|
||
|
|
* Bad latency setting
|
||
|
|
*/
|
||
|
|
#define PJMEDIA_EAUD_BADLATENCY (PJMEDIA_AUDIODEV_ERRNO_START+12) /* 4200012 */
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @hideinitializer
|
||
|
|
* General WASAPI error
|
||
|
|
*/
|
||
|
|
#define PJMEDIA_EAUD_WASAPI_ERROR \
|
||
|
|
(PJMEDIA_AUDIODEV_ERRNO_START+13) /* 4200013 */
|
||
|
|
|
||
|
|
/**
|
||
|
|
* 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).
|
||
|
|
*
|
||
|
|
* @param status The error code.
|
||
|
|
* @param buffer The buffer where to put the error message.
|
||
|
|
* @param bufsize Size of the buffer.
|
||
|
|
*
|
||
|
|
* @return The error message as NULL terminated string,
|
||
|
|
* wrapped with pj_str_t.
|
||
|
|
*/
|
||
|
|
PJ_DECL(pj_str_t) pjmedia_audiodev_strerror(pj_status_t status, char *buffer,
|
||
|
|
pj_size_t bufsize);
|
||
|
|
|
||
|
|
|
||
|
|
PJ_END_DECL
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @}
|
||
|
|
*/
|
||
|
|
|
||
|
|
|
||
|
|
#endif /* __PJMEDIA_AUDIODEV_AUDIODEV_ERRNO_H__ */
|
||
|
|
|