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 の更新プログラムとして利用できます。
- デスクトップ プライマリが表示される出力を含むアダプター。 このアダプターは、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 |