CreateDXGIFactory 函式 (dxgi.h)

  • 發行項

建立 DXGI 1.0 處理站，供您用來產生其他 DXGI 物件。

語法

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會失敗。 如需 DXGI 如何從 DllMain回應的詳細資訊，請參閱 來自 DLLMain 的 DXGI 回應。
 
注意 從 Windows 8 開始，不論所有 DXGI (Factory 都是以 CreateDXGIFactory 或 CreateDXGIFactory1 建立，) 以相同方式列舉配接器。 您使用 IDXGIFactory：：EnumAdapters 或 IDXGIFactory1：：EnumAdapters1擷取的配接器列舉順序如下：
  • 配接器，其中顯示桌面主要複本的輸出。 此配接器會對應至零的索引。
  • 具有輸出的配接器。
  • 沒有輸出的配接器。
 
Windows 市集應用程式不存在 CreateDXGIFactory 函式。 相反地，Windows 市集應用程式會使用 CreateDXGIFactory1 函式。

範例

建立 DXGI 1.0 Factory

下列程式碼範例示範如何建立 DXGI 1.0 Factory。 這個範例會使用 __uuidof () 內建函式來取得 IDXGIFactory 介面的 REFIID 或 GUID。


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

需求

   
目標平台 Windows
標頭 dxgi.h
程式庫 DXGI.lib
Dll DXGI.dll

另請參閱

DXGI 函式