Funzione CreateDXGIFactory (dxgi.h)

Articolo
08/23/2023

Crea una factory DXGI 1.0 che puoi usare per generare altri oggetti DXGI.

Sintassi

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

Parametri

riid

Tipo: REFIID

Identificatore univoco globale (GUID) dell'oggetto IDXGIFactory a cui fa riferimento il parametro ppFactory .

[out] ppFactory

Tipo: void**

Indirizzo di un puntatore a un oggetto IDXGIFactory .

Valore restituito

Tipo: HRESULT

Restituisce S_OK in caso di esito positivo; in caso contrario, restituisce uno dei DXGI_ERROR seguenti.

Commenti

Usare una factory DXGI per generare oggetti che enumerano gli adattatori, creare catene di scambio e associare una finestra alla sequenza di tasti ALT+INVIO per attivare o disattivare la modalità di visualizzazione a schermo intero.

Se la funzione CreateDXGIFactory ha esito positivo, il conteggio dei riferimenti sull'interfaccia IDXGIFactory viene incrementato. Per evitare una perdita di memoria, al termine dell'uso dell'interfaccia, chiamare il metodo IDXGIFactory::Release per rilasciare l'interfaccia.

Nota Non combinare l'uso di DXGI 1.0 (IDXGIFactory) e DXGI 1.1 (IDXGIFactory1) in un'applicazione. Usare IDXGIFactory o IDXGIFactory1, ma non entrambi in un'applicazione.

NotaCreateDXGIFactory ha esito negativo se la funzione DllMain dell'app la chiama. Per altre info sulla risposta DXGI da DllMain, vedi Risposte DXGI da DLLMain.

Nota A partire da Windows 8, tutte le factory DXGI (indipendentemente dal fatto che siano state create con CreateDXGIFactory o CreateDXGIFactory1) enumerano gli adattatori in modo identico. L'ordine di enumerazione degli adapter recuperati con IDXGIFactory::EnumAdapters o IDXGIFactory1::EnumAdapters1 è il seguente:

Adattatore con l'output in cui viene visualizzato il server primario del desktop. Questo adattatore corrisponde a un indice pari a zero.
Adattatori con output.
Adattatori senza output.

La funzione CreateDXGIFactory non esiste per le app di Windows Store. Le app di Windows Store usano invece la funzione CreateDXGIFactory1 .

Esempio

Creazione di una factory DXGI 1.0

L'esempio di codice seguente illustra come creare una factory DXGI 1.0. Questo esempio usa l'intrinseco __uuidof() per ottenere refiid o GUID dell'interfaccia IDXGIFactory .


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

Requisiti


Piattaforma di destinazione	Windows
Intestazione	dxgi.h
Libreria	DXGI.lib
DLL	DXGI.dll

Vedi anche

Funzioni DXGI

Condividi tramite