ID3D10SwitchToRef::SetUseRef メソッド (d3d10sdklayers.h)

ハードウェアとソフトウェア デバイスを切り替えます。

構文

BOOL SetUseRef(
  [in] BOOL UseRef
);

パラメーター

[in] UseRef

種類: BOOL

ブール値。 ソフトウェア デバイスに変更する場合は TRUE に設定し、ハードウェア デバイスに変更するには FALSE に設定します。

戻り値

種類: BOOL

UseRef の前の値。

解説

デバイスが切り替え可能でない場合、この API は失敗します。デバイスの作成時に ( D3D10CreateDevice を呼び出すときに) D3D10_CREATE_DEVICE_SWITCH_TO_REF フラグを指定して、切り替え可能なデバイスを作成している必要があります。

ソフトウェア デバイスからハードウェア デバイスに切り替えると、キャッシュされたすべてのオブジェクトがシステム メモリからクリアされます。 ハードウェア デバイスからソフトウェア デバイスに切り替えると、リソースがシステム メモリにダウンロードされます。

必要条件

   
対象プラットフォーム Windows
ヘッダー d3d10sdklayers.h

関連項目

D3D10CreateDevice

ID3D10SwitchToRef インターフェイス