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) );