IDXGIFactory_EnumAdapters

アダプタ (ビデオカード) を列挙する。

IDXGIFactory_EnumAdapters this, Adapter, ppAdapter

this : [comobj] IDXGIFactory インターフェースの COM オブジェクト変数
Adapter : [int] 型: UINT 列挙するアダプタのインデックス。
ppAdapter : [comobj] 型: IDXGIAdapter** Adapter パラメータで指定した位置にある IDXGIAdapter インターフェースへのポインタのアドレス。このパラメータは NULL であってはならない。

(プラグイン / モジュール : com_misc.dll)

解説

アダプタ (ビデオカード) を列挙する。

[戻り値]
型: HRESULT 成功した場合は S_OK を返す。インデックスがローカルシステムのアダプタ数以上の場合は
DXGI_ERROR_NOT_FOUND を、ppAdapter パラメータが NULL の場合は
DXGI_ERROR_INVALID_CALL を返す。

[備考]

ファクトリを生成すると、ファクトリはシステム内で利用可能なアダプタ集合を列挙する。したがってシステム内のアダプタを変更した場合は、IDXGIFactory
オブジェクトを破棄して再生成しなければならない。システム内のアダプタ数は、ディスプレイカードの追加・取り外しや、ラップトップのドック・アンドックに伴って変化する。EnumAdapters
メソッドが成功し ppAdapter パラメータにアダプタインターフェースへのポインタのアドレスが格納されると、EnumAdapters
はアダプタインターフェースの参照カウントをインクリメントする。アダプタインターフェースの使用が終わったら、ポインタを破棄する前に
Release メソッドを呼んで参照カウントを減らすこと。EnumAdapters
はまずデスクトッププライマリが表示される出力を持つアダプタを返す。このアダプタはインデックス 0
に対応する。次に他の出力を持つアダプタを返し、最後に出力を持たないアダプタを返す。

情報