IDXGIAdapter

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

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

ディスプレイサブシステムを列挙するには、IDXGIFactory::EnumAdapters を使用します。

特定のデバイスに対応するアダプターのインターフェイスを取得するには、IDXGIDevice::GetAdapter を使用します。

ソフトウェアアダプターを作成するには、IDXGIFactory::CreateSoftwareAdapter を使用します。

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

アダプター(ビデオカード)の出力(アウトプット)を列挙します。

型: HRESULT

成功または失敗を示すコード(DXGI_ERROR を参照)。インデックスが出力(アウトプット)の数を超えている場合は DXGI_ERROR_NOT_FOUND が返されます。

アダプターが D3D_DRIVER_TYPE_WARP を使用して作成されたデバイスから取得されたものである場合、そのアダプターには出力がないため、DXGI_ERROR_NOT_FOUND が返されます。

EnumOutputs は、まずデスクトップのプライマリが表示されている出力(アウトプット)を返します。この出力はインデックス 0 に対応します。その後、EnumOutputs は他の出力を返します。

例

出力(アウトプット)の列挙

EnumOutputs を使用してアダプター上のすべての出力を列挙する方法の例を次に示します。

UINT i = 0;
IDXGIOutput * pOutput;
std::vector<IDXGIOutput*> vOutputs;
while(pAdapter->EnumOutputs(i, &pOutput) != DXGI_ERROR_NOT_FOUND)
{
    vOutputs.push_back(pOutput);
    ++i;
}

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

型: HRESULT

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

グラフィックスアプリケーションは、DXGI API を使用して、Windows Display Driver Model (WDDM) ドライバーを備えたシステムで正確なグラフィックスメモリの値のセットを取得できます。以下に、関係する重要な手順を示します。

• グラフィックスドライバーモデルの判定 — DXGI は WDDM ドライバーを備えたシステムでのみ利用できるため、アプリケーションはまず次の API を使用してドライバーモデルを確認する必要があります。

  
  HasWDDMDriver()
  {
      LPDIRECT3DCREATE9EX pD3D9Create9Ex = NULL;
      HMODULE             hD3D9          = NULL;
  
      hD3D9 = LoadLibrary( L"d3d9.dll" );
  
      if ( NULL == hD3D9 ) {
          return false;
      }
  
      //
      /*  Try to create IDirect3D9Ex interface (also known as a DX9L interface). This interface can only be created if the driver is a WDDM driver.
       */
      //
      pD3D9Create9Ex = (LPDIRECT3DCREATE9EX) GetProcAddress( hD3D9, "Direct3DCreate9Ex" );
  
      return pD3D9Create9Ex != NULL;
  }
        
  

• グラフィックスメモリ値の取得。— アプリケーションがドライバーモデルを WDDM と判定した後は、Direct3D 10 以降の API と DXGI を使用してグラフィックスメモリの量を取得できます。Direct3D デバイスを作成した後、次のコードを使用して、利用可能なグラフィックスメモリの量を含む DXGI_ADAPTER_DESC 構造体を取得します。

  
  IDXGIDevice * pDXGIDevice;
  hr = g_pd3dDevice->QueryInterface(__uuidof(IDXGIDevice), (void **)&pDXGIDevice);
  IDXGIAdapter * pDXGIAdapter;
  pDXGIDevice->GetAdapter(&pDXGIAdapter);
  DXGI_ADAPTER_DESC adapterDesc;
  pDXGIAdapter->GetDesc(&adapterDesc);
        
  

システムがグラフィックスコンポーネント用のデバイスインターフェイスをサポートしているかどうかを確認します。

型: HRESULT

S_OK はインターフェイスがサポートされていることを示します。それ以外の場合は DXGI_ERROR_UNSUPPORTED が返されます(詳細については DXGI_ERROR を参照してください)。