CreateDXGIFactory1 関数 (dxgi.h)

  • [アーティクル]

他の DXGI オブジェクトの生成に使用できる DXGI 1.1 ファクトリを作成します。

構文

HRESULT CreateDXGIFactory1(
        REFIID riid,
  [out] void   **ppFactory
);

パラメーター

riid

型: REFIID

ppFactory パラメーターによって参照される IDXGIFactory1 オブジェクトのグローバル一意識別子 (GUID)。

[out] ppFactory

型: void**

IDXGIFactory1 オブジェクトへのポインターのアドレス。

戻り値

型: HRESULT

成功した場合はS_OKを返します。それ以外の場合はエラー コード。 エラー コードの一覧については、「 DXGI_ERROR」を参照してください。

注釈

DXGI 1.1 ファクトリを使用して 、アダプターを列挙するオブジェクトを生成し、 スワップ チェーンを作成し、全画面表示モードとの間で切り替えるための alt + Enter キー シーケンスに ウィンドウを関連付けます 。

CreateDXGIFactory1 関数が成功すると、IDXGIFactory1 インターフェイスの参照カウントがインクリメントされます。 メモリ リークを回避するには、 インターフェイスの使用が完了したら、 IDXGIFactory1::Release メソッドを呼び出してインターフェイスを解放します。

このエントリ ポイントは、Windows Vista および Windows Server 2008 に付属している DXGI 1.0 ではサポートされていません。 DXGI 1.1 のサポートが必要です。これは、Windows 7、Windows Server 2008 R2、および Service Pack 2 (SP2) (KB 971644) と Windows Server 2008 (KB 971512) を使用した Windows Vista の更新プログラムとして利用できます。

メモ アプリケーションで DXGI 1.0 (IDXGIFactory) と DXGI 1.1 (IDXGIFactory1) の使用を混在させないでください。 IDXGIFactory または IDXGIFactory1 を使用しますが、アプリケーションでは両方を使用しないでください。
 
メモ アプリの DllMain 関数が呼び出した場合、CreateDXGIFactory1 は失敗します。 DLLMain からの DXGI の応答の詳細については、「DLLMain からの DXGI 応答」を参照してください。
 
メモWindows 8以降、すべての DXGI ファクトリ (CreateDXGIFactory または CreateDXGIFactory1 を使用して作成されたかどうかに関係なく) は、アダプターを同じように列挙します。 IDXGIFactory::EnumAdapters または IDXGIFactory1::EnumAdapters1 を使用して取得するアダプターの列挙順序は次のとおりです。
  • デスクトップ プライマリが表示される出力を含むアダプター。 このアダプターは、0 のインデックスに対応します。
  • 出力を含むアダプター。
  • 出力のないアダプター。
 

例

DXGI 1.1 ファクトリの作成

次のコード例は、DXGI 1.1 ファクトリを作成する方法を示しています。 この例では、__uuidof() 組み込みを使用して、 IDXGIFactory1 インターフェイスの REFIID (GUID) を取得します。


IDXGIFactory1 * pFactory;
HRESULT hr = CreateDXGIFactory1(__uuidof(IDXGIFactory1), (void**)(&pFactory) );

要件

要件 値
サポートされている最小のクライアント Windows 7 [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows Server 2008 R2 [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー dxgi.h
Library DXGI.lib
[DLL] Dxgi.dll

こちらもご覧ください

DXGI 関数