管理DXUT框架的函数

DXUTResetFrameworkState

Resets DXUT state to its initial default state. All previous DXUT state changes are lost.

 VOID DXUTResetFrameworkState() ;

Parameters

None.

Return Values

No return value.

Remarks

This function does not normally need to be called. It is useful for testing purposes because the application process does not have to be restarted to reset DXUT back to its initial state.

DXUTShutdown

Triggers program termination and DXUT cleanup.

 VOID DXUTShutdown(    int   nExitCode  ) ;

Parameters

nExitCode

[in] The exit code returned via the DXUTGetExitCode function. The default value is 0

Return Values

No return value.

Remarks

It is not necessary for the application to call this function, since the application lifespan is handled by DXUT. However, the application can call this function to cleanly terminate the application process.

DXUTGetExitCode

Get DXUT exit code.

 INT DXUTGetExitCode() ;

Parameters

None.

Return Values

A DXUT exit code, which will be one of the following possible values.

Remarks

The return value of this function is typically used in the application as the return code of the application's WinMain function. Command-line tests can then be performed on applications using this return code.

The following is an example of command-line usage that uses DXUT exit code:

start /wait BasicHLSL.exeecho %errorlevel%

检索Direct3D变量的函数

DXUTGetD3DObject

Get a pointer to the IDirect3D9 object.

 IDirect3D9 * DXUTGetD3DObject() ;

Parameters

None.

Return Values

Pointer to the IDirect3D9 object. NULL is returned if no IDirect3D9 object has been created. See Remarks.

Remarks

This function exposes access to a global IDirect3D9 object. The reference count on this object interface is not incremented, so a calling function should not release the IDirect3D9 interface pointer returned by this function.

DXUTGetDeviceSettings

Get the DXUTDeviceSettings structure used to create the current device.

 DXUTDeviceSettings DXUTGetDeviceSettings() ;

Parameters

None.

Return Values

DXUTDeviceSettings structure used to create the current device.

Remarks

This settings structure can describe either a Direct3D 9 device or a Direct3D 10 device as defined the structure's DXUTDeviceVersion member.

If no device exists, then the DXUTDeviceSettings structure is filled with zeros.

DXUTGetPresentParameters

Get the presentation parameters of the Direct3D 9 device.

 D3DPRESENT_PARAMETERS DXUTGetPresentParameters() ;

Parameters

None.

Return Values

The presentation parameters of the Direct3D 9 device.

Remarks

If no Direct3D 9 device exists, then the D3DPRESENT_PARAMETERS structure is filled with zeros.

DXUTGetD3D9BackBufferSurfaceDesc

Get a pointer to a D3DSURFACE_DESC surface description of the current Direct3D 9 back buffer.

 CONST D3DSURFACE_DESC * DXUTGetD3D9BackBufferSurfaceDesc() ;

Parameters

None.

Return Values

Pointer to a D3DSURFACE_DESC surface description of the current Direct3D 9 back buffer.

Remarks

If no Direct3D 9 device exists, then the D3DSURFACE_DESC structure is filled with zeros.

DXUTGetD3D9DeviceCaps

Get a pointer to the D3DCAPS9 capabilities of the current device.

 CONST D3DCAPS9 * DXUTGetD3D9DeviceCaps() ;

Parameters

None.

Return Values

Pointer to the D3DCAPS9 capabilities of the Direct3D 9 device.

Remarks

If no Direct3D 9 device exists, then the D3DCAPS9 structure is filled with zeros.