dxutil.h
上传用户:sycq158
上传日期:2008-10-22
资源大小:15361k
文件大小:5k
- //-----------------------------------------------------------------------------
- // File: DXUtil.h
- //
- // Desc: Helper functions and typing shortcuts for DirectX programming.
- //
- // Copyright (c) 1997-2001 Microsoft Corporation. All rights reserved
- //-----------------------------------------------------------------------------
- #ifndef DXUTIL_H
- #define DXUTIL_H
- //-----------------------------------------------------------------------------
- // Miscellaneous helper functions
- //-----------------------------------------------------------------------------
- #define SAFE_DELETE(p) { if(p) { delete (p); (p)=NULL; } }
- #define SAFE_DELETE_ARRAY(p) { if(p) { delete[] (p); (p)=NULL; } }
- #define SAFE_RELEASE(p) { if(p) { (p)->Release(); (p)=NULL; } }
- //-----------------------------------------------------------------------------
- // Name: DXUtil_GetDXSDKMediaPath() and DXUtil_FindMediaFile()
- // Desc: Returns the DirectX SDK path, as stored in the system registry
- // during the SDK install.
- //-----------------------------------------------------------------------------
- const TCHAR* DXUtil_GetDXSDKMediaPath();
- HRESULT DXUtil_FindMediaFile( TCHAR* strPath, TCHAR* strFilename );
- //-----------------------------------------------------------------------------
- // Name: DXUtil_Read*RegKey() and DXUtil_Write*RegKey()
- // Desc: Helper functions to read/write a string registry key
- //-----------------------------------------------------------------------------
- HRESULT DXUtil_WriteStringRegKey( HKEY hKey, TCHAR* strRegName, TCHAR* strValue );
- HRESULT DXUtil_WriteIntRegKey( HKEY hKey, TCHAR* strRegName, DWORD dwValue );
- HRESULT DXUtil_WriteGuidRegKey( HKEY hKey, TCHAR* strRegName, GUID guidValue );
- HRESULT DXUtil_WriteBoolRegKey( HKEY hKey, TCHAR* strRegName, BOOL bValue );
- HRESULT DXUtil_ReadStringRegKey( HKEY hKey, TCHAR* strRegName, TCHAR* strValue, DWORD dwLength, TCHAR* strDefault );
- HRESULT DXUtil_ReadIntRegKey( HKEY hKey, TCHAR* strRegName, DWORD* pdwValue, DWORD dwDefault );
- HRESULT DXUtil_ReadGuidRegKey( HKEY hKey, TCHAR* strRegName, GUID* pGuidValue, GUID& guidDefault );
- HRESULT DXUtil_ReadBoolRegKey( HKEY hKey, TCHAR* strRegName, BOOL* pbValue, BOOL bDefault );
- //-----------------------------------------------------------------------------
- // Name: DXUtil_Timer()
- // Desc: Performs timer opertations. Use the following commands:
- // TIMER_RESET - to reset the timer
- // TIMER_START - to start the timer
- // TIMER_STOP - to stop (or pause) the timer
- // TIMER_ADVANCE - to advance the timer by 0.1 seconds
- // TIMER_GETABSOLUTETIME - to get the absolute system time
- // TIMER_GETAPPTIME - to get the current time
- // TIMER_GETELAPSEDTIME - to get the time that elapsed between
- // TIMER_GETELAPSEDTIME calls
- //-----------------------------------------------------------------------------
- enum TIMER_COMMAND { TIMER_RESET, TIMER_START, TIMER_STOP, TIMER_ADVANCE,
- TIMER_GETABSOLUTETIME, TIMER_GETAPPTIME, TIMER_GETELAPSEDTIME };
- FLOAT __stdcall DXUtil_Timer( TIMER_COMMAND command );
- //-----------------------------------------------------------------------------
- // UNICODE support for converting between CHAR, TCHAR, and WCHAR strings
- //-----------------------------------------------------------------------------
- VOID DXUtil_ConvertAnsiStringToWide( WCHAR* wstrDestination, const CHAR* strSource, int cchDestChar = -1 );
- VOID DXUtil_ConvertWideStringToAnsi( CHAR* strDestination, const WCHAR* wstrSource, int cchDestChar = -1 );
- VOID DXUtil_ConvertGenericStringToAnsi( CHAR* strDestination, const TCHAR* tstrSource, int cchDestChar = -1 );
- VOID DXUtil_ConvertGenericStringToWide( WCHAR* wstrDestination, const TCHAR* tstrSource, int cchDestChar = -1 );
- VOID DXUtil_ConvertAnsiStringToGeneric( TCHAR* tstrDestination, const CHAR* strSource, int cchDestChar = -1 );
- VOID DXUtil_ConvertWideStringToGeneric( TCHAR* tstrDestination, const WCHAR* wstrSource, int cchDestChar = -1 );
- //-----------------------------------------------------------------------------
- // GUID to String converting
- //-----------------------------------------------------------------------------
- VOID DXUtil_ConvertGUIDToString( const GUID* pGuidIn, TCHAR* strOut );
- BOOL DXUtil_ConvertStringToGUID( const TCHAR* strIn, GUID* pGuidOut );
- //-----------------------------------------------------------------------------
- // Debug printing support
- //-----------------------------------------------------------------------------
- VOID DXUtil_Trace( TCHAR* strMsg, ... );
- HRESULT _DbgOut( TCHAR*, DWORD, HRESULT, TCHAR* );
- #if defined(DEBUG) | defined(_DEBUG)
- #define DXTRACE DXUtil_Trace
- #else
- #define DXTRACE sizeof
- #endif
- #if defined(DEBUG) | defined(_DEBUG)
- #define DEBUG_MSG(str) _DbgOut( __FILE__, (DWORD)__LINE__, 0, str )
- #else
- #define DEBUG_MSG(str) (0L)
- #endif
- #endif // DXUTIL_H