Skip to content

Latest commit

 

History

History
81 lines (62 loc) · 2.83 KB

nf-d3d10sdklayers-id3d10switchtoref-setuseref.md

File metadata and controls

81 lines (62 loc) · 2.83 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:d3d10sdklayers.ID3D10SwitchToRef.SetUseRef
ID3D10SwitchToRef::SetUseRef (d3d10sdklayers.h)
Switch between a hardware and a software device.
7960e1b8-7255-59bd-3f8f-533b12811a49
ID3D10SwitchToRef interface [Direct3D 10]
SetUseRef method
ID3D10SwitchToRef.SetUseRef
ID3D10SwitchToRef::SetUseRef
SetUseRef
SetUseRef method [Direct3D 10]
SetUseRef method [Direct3D 10]
ID3D10SwitchToRef interface
d3d10sdklayers/ID3D10SwitchToRef::SetUseRef
direct3d10.id3d10switchtoref_setuseref
direct3d10\id3d10switchtoref_setuseref.htm
direct3d10
VS|directx_sdk|~\id3d10switchtoref_setuseref.htm
12/05/2018
7960e1b8-7255-59bd-3f8f-533b12811a49, ID3D10SwitchToRef interface [Direct3D 10],SetUseRef method, ID3D10SwitchToRef.SetUseRef, ID3D10SwitchToRef::SetUseRef, SetUseRef, SetUseRef method [Direct3D 10], SetUseRef method [Direct3D 10],ID3D10SwitchToRef interface, d3d10sdklayers/ID3D10SwitchToRef::SetUseRef, direct3d10.id3d10switchtoref_setuseref
d3d10sdklayers.h
Windows
Windows
19H1
ID3D10SwitchToRef::SetUseRef
d3d10sdklayers/ID3D10SwitchToRef::SetUseRef
c++
APIRef
kbSyntax
COM
D3D10SDKLayers.h
ID3D10SwitchToRef.SetUseRef

ID3D10SwitchToRef::SetUseRef

-description

Switch between a hardware and a software device.

-parameters

-param 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.

-returns

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.

-see-also

D3D10CreateDevice

ID3D10SwitchToRef Interface