ホーム › Graphics.Dxgi › IDXGIDisplayControl

IDXGIDisplayControl

COM

IIDea9dbf1a-c88e-4486-854a-98aa0138f30c継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

IDXGIDisplayControl インターフェースは、オペレーティングシステムの立体視 3D ディスプレイの動作に関するユーザーの設定を示し、立体視 3D ディスプレイの状態を有効または無効に設定するためのメソッドを公開します。

解説(Remarks)

Note IDXGIDisplayControl インターフェースは、オペレーティングシステムのコントロールパネルの ディスプレイ アプリ、またはサードパーティ製グラフィックスベンダーのコントロールアプレットでのみ使用されます。このインターフェースはエンドユーザー向けアプリの開発者を対象としたものではありません。

Note IDXGIDisplayControl インターフェースは Windows ストアアプリには存在しません。

ファクトリオブジェクト(IDXGIFactory、IDXGIFactory1、または IDXGIFactory2)から QueryInterface を呼び出して、IDXGIDisplayControl インターフェースを取得します。以下のコードにその方法を示します。

IDXGIDisplayControl * pDXGIDisplayControl;
hr = g_pDXGIFactory->QueryInterface(__uuidof(IDXGIDisplayControl), (void **)&pDXGIDisplayControl);

オペレーティングシステムは、ステレオ有効化の構成に対する変更を非同期に処理します。そのため、これらの変更は、ステレオ構成を照会するために IDXGIDisplayControl::IsStereoEnabled を呼び出すすべてのプロセスにおいて、すぐに反映されるとは限りません。コントロールアプレットは、IDXGIFactory2::RegisterStereoStatusEvent または IDXGIFactory2::RegisterStereoStatusWindow メソッドを使用して、すべてのステレオ構成変更の通知を受け取るよう登録できます。

Platform Update for Windows 7: 立体視 3D ディスプレイの動作は、Platform Update for Windows 7 では利用できません。Platform Update for Windows 7 の詳細については、Platform Update for Windows 7 を参照してください。

メソッド 2

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 BOOL IsStereoEnabled()

オペレーティングシステムの立体視 3D ディスプレイの動作が有効かどうかを示すブール値を取得します。

戻り値

IsStereoEnabled は、オペレーティングシステムの立体視 3D ディスプレイの動作が有効な場合は TRUE を、無効な場合は FALSE を返します。

Platform Update for Windows 7: Platform Update for Windows 7 がインストールされた Windows 7 または Windows Server 2008 R2 では、立体視 3D ディスプレイの動作が Platform Update for Windows 7 では利用できないため、IsStereoEnabled は常に FALSE を返します。Platform Update for Windows 7 の詳細については、Platform Update for Windows 7 を参照してください。

解説(Remarks)

オペレーティングシステムの立体視 3D ディスプレイの動作を有効または無効にするには、IDXGIDisplayControl::SetStereoEnabled メソッドにブール値を渡します。TRUE はオペレーティングシステムの立体視 3D ディスプレイの動作を有効にし、FALSE は無効にします。

vtbl 4 void SetStereoEnabled(BOOL enabled)

オペレーティングシステムの立体視 3D ディスプレイの動作を有効または無効にするためのブール値を設定します。

enabled

BOOL

オペレーティングシステムの立体視 3D ディスプレイの動作を有効または無効にするブール値です。TRUE はオペレーティングシステムの立体視 3D ディスプレイの動作を有効にし、FALSE は無効にします。

解説(Remarks)

Platform Update for Windows 7: Platform Update for Windows 7 がインストールされた Windows 7 または Windows Server 2008 R2 では、立体視 3D ディスプレイの動作が Platform Update for Windows 7 では利用できないため、SetStereoEnabled は立体視 3D ディスプレイの動作を変更しません。Platform Update for Windows 7 の詳細については、Platform Update for Windows 7 を参照してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

#define global IID_IDXGIDisplayControl "{EA9DBF1A-C88E-4486-854A-98AA0138F30C}"
#usecom global IDXGIDisplayControl IID_IDXGIDisplayControl "{}"
#comfunc global IDXGIDisplayControl_IsStereoEnabled   3
#comfunc global IDXGIDisplayControl_SetStereoEnabled  4 int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。