CreateDXGIFactory-Funktion (dxgi.h)

Artikel
08/23/2023

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

Syntax

HRESULT CreateDXGIFactory(
        REFIID riid,
  [out] void   **ppFactory
);

Parameter

riid

Typ: REFIID

Der globally unique identifier (GUID) des IDXGIFactory-Objekts , auf das vom ppFactory-Parameter verwiesen wird.

[out] ppFactory

Typ: void**

Adresse eines Zeigers auf ein IDXGIFactory-Objekt .

Rückgabewert

Typ: HRESULT

Gibt bei erfolgreicher Ausführung S_OK zurück. Gibt andernfalls eine der folgenden DXGI_ERROR zurück.

Hinweise

Verwenden Sie eine DXGI-Factory, um Objekte zu generieren, die Adapter auflisten, Swapchains erstellen und ein Fenster mit der Tastensequenz ALT+EINGABETASTE zuordnen, um zum Umschalten in und aus dem Vollbildmodus zu wechseln.

Wenn die CreateDXGIFactory-Funktion erfolgreich ist, wird die Verweisanzahl auf der IDXGIFactory-Schnittstelle erhöht. Um einen Speicherverlust zu vermeiden, rufen Sie nach Der Verwendung der Schnittstelle die IDXGIFactory::Release-Methode auf, um die Schnittstelle freizugeben.

Hinweis Mischen Sie die Verwendung von DXGI 1.0 (IDXGIFactory) und DXGI 1.1 (IDXGIFactory1) in einer Anwendung nicht. Verwenden Sie IDXGIFactory oder IDXGIFactory1, aber nicht beides in einer Anwendung.

HinweisCreateDXGIFactory schlägt fehl, wenn die DllMain-Funktion Ihrer App sie aufruft. Weitere Informationen dazu, wie DXGI von DllMain aus reagiert, finden Sie unter DXGI-Antworten von DLLMain.

Hinweis Ab Windows 8 führen alle DXGI-Fabriken (unabhängig davon, ob sie mit CreateDXGIFactory oder CreateDXGIFactory1 erstellt wurden) Adapter identisch auf. Die Enumerationsreihenfolge von Adaptern, die Sie mit IDXGIFactory::EnumAdapters oder IDXGIFactory1::EnumAdapters1 abrufen, lautet wie folgt:

Adapter mit der Ausgabe, auf der der primäre Desktop angezeigt wird. Dieser Adapter entspricht einem Index von null.
Adapter mit Ausgaben.
Adapter ohne Ausgaben.

Die CreateDXGIFactory-Funktion ist für Windows Store-Apps nicht vorhanden. Stattdessen verwenden Windows Store-Apps die Funktion CreateDXGIFactory1 .

Beispiele

Erstellen einer DXGI 1.0 Factory

Im folgenden Codebeispiel wird veranschaulicht, wie Sie eine DXGI 1.0-Factory erstellen. In diesem Beispiel wird das systeminterne __uuidof() verwendet, um die REFIID oder GUID der IDXGIFactory-Schnittstelle abzurufen.


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

Anforderungen


Zielplattform	Windows
Kopfzeile	dxgi.h
Bibliothek	DXGI.lib
DLL	DXGI.dll

Weitere Informationen

DXGI-Funktionen

Freigeben über