共用方式為


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) 。 在應用程式中使用 IDXGIFactoryIDXGIFactory1,但不同時使用兩者。
 
注意 如果您的應用程式的 DllMain 函式呼叫它,CreateDXGIFactory1 就會失敗。 如需 DXGI 如何從 DllMain 回應的詳細資訊,請參閱 來自 DLLMain 的 DXGI 回應
 
注意從 Windows 8 開始,不論所有 DXGI (Factory 都是以 CreateDXGIFactoryCreateDXGIFactory1 建立,) 列舉配接器是否相同。 您使用 IDXGIFactory::EnumAdaptersIDXGIFactory1::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

另請參閱

DXGI 函式