CreateDXGIFactory2-Funktion (dxgi1_3.h)

Erstellt eine DXGI 1.3-Factory, mit der Sie andere DXGI-Objekte generieren können.

In Windows 8 wird jede DXGI-Factory geladen und verwendet, während DXGIDebug.dll auf dem System vorhanden war. Ab Windows 8.1 fordern Apps explizit an, dass stattdessen DXGIDebug.dll geladen werden. Verwenden Sie CreateDXGIFactory2 , und geben Sie das flag DXGI_CREATE_FACTORY_DEBUG an, um DXGIDebug.dll anzufordern. Die DLL wird geladen, wenn sie auf dem System vorhanden ist.

Syntax

HRESULT CreateDXGIFactory2(
        UINT   Flags,
        REFIID riid,
  [out] void   **ppFactory
);

Parameter

Flags

Typ: UINT

Gültige Werte sind das flag DXGI_CREATE_FACTORY_DEBUG (0x01) und null.

Hinweis Dieses Flag wird von der D3D-Runtime festgelegt, wenn:
  • Das System erstellt während der Geräteerstellung eine implizite Factory.
  • Das D3D11_CREATE_DEVICE_DEBUG-Flag wird während der Geräteerstellung angegeben, z. B. mithilfe von D3D11CreateDevice (oder der Swapchainmethode oder den Direct3D 10-Entsprechungen).
 

riid

Typ: REFIID

Die GUID (Globally Unique Identifier) des IDXGIFactory2-Objekts , auf das vom ppFactory-Parameter verwiesen wird.

[out] ppFactory

Typ: void**

Adresse eines Zeigers auf ein IDXGIFactory2-Objekt .

Rückgabewert

Typ: HRESULT

Gibt bei erfolgreicher Ausführung S_OK zurück. andernfalls ein Fehlercode. Eine Liste der Fehlercodes finden Sie unter DXGI_ERROR.

Hinweise

Diese Funktion akzeptiert ein Flag, das angibt, ob DXGIDebug.dll geladen wird. Die Funktion verhält sich andernfalls identisch mit CreateDXGIFactory1.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 8.1 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 R2 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile dxgi1_3.h
Bibliothek DXGI.lib
DLL Dxgi.dll

Weitere Informationen

DXGI-Funktionen