Win32 API 日本語リファレンス
ホーム › Graphics.Dxgi › IDXGIAdapter1

IDXGIAdapter1

COM
📘 Microsoft Learn (日本語) · English
IID29038f61-3839-4626-91fd-086879011a05継承元IDXGIAdapter自前メソッド開始 vtbl10

公式ドキュメント

IDXGIAdapter1 インターフェイスは、ディスプレイサブシステム(1 つ以上の GPU、DAC、およびビデオメモリを含む)を表します。

解説(Remarks)

このインターフェイスは、Windows Vista および Windows Server 2008 に同梱された DXGI 1.0 ではサポートされていません。DXGI 1.1 のサポートが必要であり、これは Windows 7、Windows Server 2008 R2、および Service Pack 2 (SP2) 適用済みの Windows Vista 向け更新プログラム (KB 971644) と Windows Server 2008 向け更新プログラム (KB 971512) で利用できます。

ディスプレイサブシステムはビデオカードと呼ばれることが多いですが、一部のマシンではディスプレイサブシステムがマザーボードの一部になっています。

ディスプレイサブシステムを列挙するには、IDXGIFactory1::EnumAdapters1 を使用します。特定のデバイスに対するアダプターのインターフェイスを取得するには、IDXGIDevice::GetAdapter を使用します。ソフトウェアアダプターを作成するには、IDXGIFactory::CreateSoftwareAdapter を使用します。

Windows Phone 8: この API はサポートされています。

メソッド 1

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

vtbl 10 HRESULT GetDesc1(DXGI_ADAPTER_DESC1* pDesc)

アダプター(またはビデオカード)の DXGI 1.1 の記述を取得します。

pDescDXGI_ADAPTER_DESC1*outアダプターを記述する DXGI_ADAPTER_DESC1 構造体へのポインター。
このパラメーターは NULL であってはなりません。フィーチャーレベル 9 のグラフィックスハードウェアでは、GetDesc1 は DXGI_ADAPTER_DESC1 の VendorId、DeviceId、SubSysId、Revision の各メンバーにゼロを返し、Description メンバーの記述文字列には「Software Adapter」を返します。

戻り値

型: HRESULT

成功した場合は S_OK を返します。それ以外の場合、pDesc パラメーターが NULL であれば E_INVALIDARG を返します。

解説(Remarks)

このメソッドは、Windows Vista および Windows Server 2008 に同梱された DXGI 1.0 ではサポートされていません。DXGI 1.1 のサポートが必要であり、これは Windows 7、Windows Server 2008 R2、および Service Pack 2 (SP2) 適用済みの Windows Vista 向け更新プログラム (KB 971644) と Windows Server 2008 向け更新プログラム (KB 971512) で利用できます。

アダプターの DXGI 1.1 の記述を取得するには、GetDesc1 メソッドを使用します。DXGI 1.0 の記述を取得するには、IDXGIAdapter メソッドを使用します。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IDXGIAdapter1 "{29038F61-3839-4626-91FD-086879011A05}"
#usecom global IDXGIAdapter1 IID_IDXGIAdapter1 "{}"
#comfunc global IDXGIAdapter1_GetDesc1  10 var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。