CreateDXGIFactory1 函式 (dxgi.h)
建立 DXGI 1.1 處理站，供您用來產生其他 DXGI 物件。
語法
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 方法來釋放介面。
DXGI 1.0 不支援此進入點，此進入點隨附於 Windows Vista 和 Windows Server 2008。 需要 DXGI 1.1 支援，此支援適用於 Windows 7、Windows Server 2008 R2，以及以 Service Pack 2 (SP2) (KB) (KB 971644) 和 Windows Server 2008 (KB 971512) 更新。
注意 請勿在應用程式中混合使用 DXGI 1.0 (IDXGIFactory) 和 DXGI 1.1 (IDXGIFactory1) 。 在應用程式中使用 IDXGIFactory 或 IDXGIFactory1，但不同時使用兩者。
注意 如果您的應用程式的 DllMain 函式呼叫它，CreateDXGIFactory1 就會失敗。 如需 DXGI 如何從 DllMain 回應的詳細資訊，請參閱 來自 DLLMain 的 DXGI 回應。
注意從 Windows 8 開始，不論所有 DXGI (Factory 都是以 CreateDXGIFactory 或 CreateDXGIFactory1 建立，) 列舉配接器是否相同。 您使用 IDXGIFactory：：EnumAdapters 或 IDXGIFactory1：：EnumAdapters1 擷取的配接器列舉順序如下：
- 配接器，其中顯示桌面主要複本的輸出。 此配接器會對應至零的索引。
- 具有輸出的配接器。
- 沒有輸出的配接器。
範例
建立 DXGI 1.1 Factory
下列程式代碼範例示範如何建立 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 |
| 程式庫 | DXGI.lib |
| Dll | Dxgi.dll |