CreateDXGIFactory1-Funktion (dxgi.h)
Erstellt eine DXGI 1.1-Factory, die Sie zum Generieren anderer DXGI-Objekte verwenden können.
HRESULT CreateDXGIFactory1(
REFIID riid,
[out] void **ppFactory
);
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 .
Typ: HRESULT
Gibt bei erfolgreicher Ausführung S_OK zurück. andernfalls ein Fehlercode. Eine Liste der Fehlercodes finden Sie unter DXGI_ERROR.
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.
- 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.
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) );
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 |