CreateDXGIFactory1-Funktion (dxgi.h)

Artikel
02/26/2024

Erstellt eine DXGI 1.1-Factory, die Sie zum Generieren anderer DXGI-Objekte verwenden können.

Syntax

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

Parameter

riid

Typ: REFIID

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

[out] ppFactory

Typ: void**

Adresse eines Zeigers auf ein IDXGIFactory1-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

Verwenden Sie eine DXGI 1.1-Factory, um Objekte zu generieren, die Adapter aufzählen, Swapchains erstellen und ein Fenster mit der Tastenfolge ALT+EINGABETASTE für das Umschalten in den und aus dem Vollbildmodus zuordnen.

Wenn die CreateDXGIFactory1-Funktion erfolgreich ist, wird die Verweisanzahl auf der IDXGIFactory1-Schnittstelle erhöht. Wenn Sie die Verwendung der Schnittstelle abgeschlossen haben, rufen Sie die IDXGIFactory1::Release-Methode auf, um einen Speicherverlust zu vermeiden, um die Schnittstelle freizugeben.

Dieser Einstiegspunkt wird von DXGI 1.0, das in Windows Vista und Windows Server 2008 ausgeliefert wurde, nicht unterstützt. DxGI 1.1-Unterstützung ist erforderlich, die unter Windows 7, Windows Server 2008 R2 und als Update auf Windows Vista mit Service Pack 2 (SP2) (KB 971644) und Windows Server 2008 (KB 971512) verfügbar ist.

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.

HinweisCreateDXGIFactory1 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 werden adapter von allen DXGI-Fabriken (unabhängig davon, ob sie mit CreateDXGIFactory oder CreateDXGIFactory1 erstellt wurden) identisch aufgelistet. Die Enumerationsreihenfolge der Adapter, 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 Ausgängen.
Adapter ohne Ausgaben.

Beispiele

Erstellen einer DXGI 1.1-Factory

Im folgenden Codebeispiel wird veranschaulicht, wie eine DXGI 1.1-Factory erstellt wird. In diesem Beispiel wird die systeminterne __uuidof() verwendet, um die REFIID (GUID) der IDXGIFactory1-Schnittstelle abzurufen.


IDXGIFactory1 * pFactory;
HRESULT hr = CreateDXGIFactory1(__uuidof(IDXGIFactory1), (void**)(&pFactory) );

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	dxgi.h
Bibliothek	DXGI.lib
DLL	Dxgi.dll

Weitere Informationen

DXGI-Funktionen

Freigeben über