110 lines
4.7 KiB
C
110 lines
4.7 KiB
C
//-----------------------------------------------------------------------------
|
|
// File: DXUtil.h
|
|
//
|
|
// Desc: Helper functions and typing shortcuts for DirectX programming.
|
|
//
|
|
//@@BEGIN_MSINTERNAL
|
|
//
|
|
// Hist: See the source files for detailed histories
|
|
// 03.21.00 - mwetzel - Last Modified
|
|
//
|
|
//@@END_MSINTERNAL
|
|
// Copyright (c) 1997-2000 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 );
|
|
|
|
|
|
|
|
|
|
//-----------------------------------------------------------------------------
|
|
// 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
|