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

另請參閱

DXGI 函式