Error functions

---

Detailed Description

The error functions operate on all ASX objects to collect, report and clear errors.

Functions
ASX32_API ASX_ERROR	ASX_Error_GetLast (ASX_HANDLE hASXObject, ASX_ERROR *pnAsxErrorCode, int *pnAsxSubSystemErrorCode)
	Get the last error.
ASX32_API ASX_ERROR	ASX_Error_GetLastString (ASX_HANDLE hASXObject, char *pszAsxErrorString, const int nAsxErrorStringLength, int *pnRequiredAsxErrorStringLength, char *pszAsxSubSystemErrorString, const int nAsxSubSystemErrorStringLength, int *pnRequiredAsxSubSystemErrorStringLength)
	Get the last error string information.
ASX32_API ASX_ERROR	ASX_Error_Clear (ASX_HANDLE hASXObject)
	Clears the last error.

---

Function Documentation

ASX32_API ASX_ERROR ASX_Error_Clear (  ASX_HANDLE  hASXObject  )

Clears the last error. This function clears error information for the last error generated by hASXObject. Parameters: hASXObject  The ASX object handle. Returns: Returns 0 if there is no error, otherwise one of asxERROR is returned. Examples: mixer/main.c.

ASX32_API ASX_ERROR ASX_Error_GetLast (  ASX_HANDLE  hASXObject, ASX_ERROR *  pnAsxErrorCode, int *  pnAsxSubSystemErrorCode )

Get the last error. This function returns error information for the last error generated by hASXObject. Parameters: hASXObject  The ASX object handle that generated the error. This can be any ASX object. pnAsxErrorCode  The returned ASX error code. If this parameter is set to 0, it will be ignored. pnAsxSubSystemErrorCode  The returned SubSystem error code. This code will be an HPI error if the HPI subsystem is being used, or a MMSYSTEM error if MMSYSTEM is being use. If this parameter is set to 0, it will be ignored. Returns: Returns 0 if there is no error, otherwise one of asxERROR is returned. Examples: adapter/main.c, dual_mono_play/main.c, dual_mono_record/main.c, mixer/main.c, mux/main.c, play/main.c, record/main.c, system/main.c, tuner/main.c, and volume/main.c.

ASX32_API ASX_ERROR ASX_Error_GetLastString (  ASX_HANDLE  hASXObject, char *  pszAsxErrorString, const int  nAsxErrorStringLength, int *  pnRequiredAsxErrorStringLength, char *  pszAsxSubSystemErrorString, const int  nAsxSubSystemErrorStringLength, int *  pnRequiredAsxSubSystemErrorStringLength )

Get the last error string information. This function returns error information for the last error generated by hASXObject. Note that errors are automatically cleared the next time any operation is performed using hASXObject. Parameters: hASXObject  The ASX object handle that generated the error. This can be any ASX object. pszAsxErrorString  The returned ASX error string. If this parameter is set to 0, it will be ignored. nAsxErrorStringLength  The length of pszAsxErrorString on bytes. pnRequiredAsxErrorStringLength  The required length of pszAsxErrorString in bytes. pszAsxSubSystemErrorString  The returned SubSystem error string. This string will describe an HPI error if the HPI subsystem is being used, or a MMSYSTEM error if MMSYSTEM is being use. If this parameter is set to 0, it will be ignored. nAsxSubSystemErrorStringLength  The length of pszAsxSubSystemErrorString in bytes. pnRequiredAsxSubSystemErrorStringLength  The required length of pszAsxSubSystemErrorString in bytes. Note: This function can be called with string pointers set to zero to determine the size of strings to allocate. Returns: Returns 0 if there is no error, otherwise one of asxERROR is returned. Examples: adapter/main.c, dual_mono_play/main.c, dual_mono_record/main.c, mixer/main.c, mux/main.c, play/main.c, record/main.c, system/main.c, tuner/main.c, and volume/main.c.

---