ID3D10SwitchToRef::SetUseRef method

Switch between a hardware and a software device.

Syntax


BOOL SetUseRef(
  [in]  BOOL UseRef
);

Parameters

UseRef [in]

Type: BOOL

A boolean value. Set this to TRUE to change to a software device, set this to FALSE to change to a hardware device.

Return value

Type: BOOL

The previous value of UseRef.

Remarks

This API will fail if the device is not switchable; you must have created a device that is switchable by specifying the D3D10_CREATE_DEVICE_SWITCH_TO_REF flag during device creation (when calling D3D10CreateDevice).

Switching from a software device to a hardware device clears all cached objects from system memory. Switching from a hardware device to a software device causes resources to be downloaded to system memory.

Requirements

Header

D3D10SDKLayers.h

See also

D3D10CreateDevice
ID3D10SwitchToRef Interface

 

 

Community Additions

ADD
Show:
© 2014 Microsoft