共用方式為


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