次の方法で共有

CreateDXGIFactory 関数 (dxgi.h)

  • [アーティクル]

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

構文

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

パラメーター

riid

型: REFIID

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

[out] ppFactory

型: void**

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

戻り値

型: HRESULT

成功した場合 はS_OK を返します。それ以外の場合は、次のいずれかの DXGI_ERRORを返します。

解説

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

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

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

例

DXGI 1.0 ファクトリの作成

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


IDXGIFactory * pFactory;
HRESULT hr = CreateDXGIFactory(__uuidof(IDXGIFactory), (void**)(&pFactory) );

要件

   
対象プラットフォーム Windows
ヘッダー dxgi.h
Library DXGI.lib
[DLL] DXGI.dll

関連項目

DXGI 関数