jedi-academy/code/ff/IFC/IFCErrors.h
2013-04-23 15:21:39 +10:00

181 lines
4.1 KiB
C++

/**********************************************************************
Copyright (c) 1999 - 2000 Immersion Corporation
Permission to use, copy, modify, distribute, and sell this
software and its documentation may be granted without fee;
interested parties are encouraged to request permission from
Immersion Corporation
801 Fox Lane
San Jose, CA 95131
408-467-1900
IMMERSION DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS.
IN NO EVENT SHALL IMMERSION BE LIABLE FOR ANY SPECIAL, INDIRECT OR
CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
FILE: IFCErrors.h
PURPOSE: Error codes returned in IFC; Error handling in IFC
STARTED: 2/28/99 by Jeff Mallett
NOTES/REVISIONS:
3/2/99 jrm (Jeff Mallett): Force-->Feel renaming
3/6/99 jrm: Added user error handling control
3/15/99 jrm: __declspec(dllimport/dllexport) the whole class
**********************************************************************/
#if !defined(IFCERRORS_H__INCLUDED_)
#define IFCERRORS_H__INCLUDED_
#if _MSC_VER >= 1000
#pragma once
#endif // _MSC_VER >= 1000
#ifndef _IFCDLL_
#define DLLIFC __declspec(dllimport)
#else
#define DLLIFC __declspec(dllexport)
#endif
#include <winerror.h>
#include "ImmBaseTypes.h"
/****************************************************************************
*
* Error Codes
*
****************************************************************************/
typedef enum {
IFC_ERR_OK = 0,
IFC_ERR_UNKNOWN_ERROR = 1,
IFC_ERR_ALLOCATION_FAILED = 2,
IFC_ERR_INVALID_PARAMETER = 3,
IFC_ERR_NULL_PARAMETER = 4,
IFC_ERR_WRONG_FORM = 5,
IFC_ERR_DEVICE_IS_NULL = 6,
IFC_ERR_INVALID_GUID = 7,
IFC_ERR_EFFECT_NOT_INITIALIZED = 8,
IFC_ERR_CANT_INITIALIZE_DEVICE = 9,
IFC_ERR_CANT_CREATE_EFFECT = 10,
IFC_ERR_CANT_CREATE_EFFECT_FROM_IFR = 11,
IFC_ERR_NO_EFFECTS_FOUND = 12,
IFC_ERR_EFFECT_IS_COMPOUND = 13,
IFC_ERR_PROJECT_ALREADY_OPEN = 14,
IFC_ERR_PROJECT_NOT_OPEN = 15,
IFC_ERR_NO_DX7_DEVICE = 16,
IFC_ERR_CANT_WRITE_IFR = 17,
IFC_ERR_DINPUT_NOT_FOUND = 18,
IFC_ERR_IMMAPI_NOT_FOUND = 19,
IFC_ERR_FILE_NOT_FOUND = 20,
IFC_ERR_NO_VERSION_INFO = 21
} IFC_ERROR_CODE;
typedef enum {
IFC_OUTPUT_ERR_TO_DEBUG = 0x0001,
IFC_OUTPUT_ERR_TO_DIALOG = 0x0002
} IFC_ERROR_HANDLING_FLAGS;
/****************************************************************************
*
* Macros
*
****************************************************************************/
//
// ------ PUBLIC MACROS ------
//
#define IFC_GET_LAST_ERROR CIFCErrors::GetLastErrorCode()
#define IFC_SET_ERROR_HANDLING CIFCErrors::SetErrorHandling
//
// ------ PRIVATE MACROS ------
//
#if (IFC_VERSION >= 0x0110)
#define IFC_SET_ERROR(err) CIFCErrors::SetErrorCode(err, __FILE__, __LINE__)
#else
#define IFC_SET_ERROR(err) CIFCErrors::SetErrorCode(err)
#endif
#define IFC_CLEAR_ERROR IFC_SET_ERROR(IFC_ERR_OK)
/****************************************************************************
*
* CIFCErrors
*
****************************************************************************/
// All members are static. Don't bother instantiating an object of this class.
//
// ------ PUBLIC INTERFACE ------
//
class DLLIFC CIFCErrors
{
//
// ATTRIBUTES
//
public:
static HRESULT
GetLastErrorCode()
{ return m_Err; }
static void
SetErrorHandling(unsigned long dwFlags)
{ m_dwErrHandlingFlags = dwFlags; }
//
// ------ PRIVATE INTERFACE ------
//
// Internally used by IFC classes
static void
SetErrorCode(
HRESULT err
#if (IFC_VERSION >= 0x0110)
, const char *sFile, int nLine
#endif
);
//
// HELPERS
//
protected:
//
// INTERNAL DATA
//
private:
static HRESULT m_Err;
static unsigned long m_dwErrHandlingFlags;
};
#endif // IFCERRORS_H__INCLUDED_