Funzione CreateDXGIFactory1 (dxgi.h)

  • Articolo

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

Sintassi

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

Parametri

riid

Tipo: REFIID

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

[out] ppFactory

Tipo: void**

Indirizzo di un puntatore a un oggetto IDXGIFactory1 .

Valore restituito

Tipo: HRESULT

Restituisce S_OK in caso di esito positivo; un codice di errore in caso contrario. Per un elenco dei codici di errore, vedere DXGI_ERROR.

Commenti

Usare una factory DXGI 1.1 per generare oggetti che enumerano 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 CreateDXGIFactory1 ha esito positivo, il conteggio dei riferimenti sull'interfaccia IDXGIFactory1 viene incrementato. Per evitare una perdita di memoria, al termine dell'uso dell'interfaccia, chiamare il metodo IDXGIFactory1::Release per rilasciare l'interfaccia.

Questo punto di ingresso non è supportato da DXGI 1.0, fornito in Windows Vista e Windows Server 2008. È necessario il supporto DXGI 1.1, disponibile in Windows 7, Windows Server 2008 R2 e come aggiornamento a Windows Vista con Service Pack 2 (SP2) (KB 971644) e Windows Server 2008 (KB 971512).

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.
 
NotaCreateDXGIFactory1 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.
 

Esempio

Creazione di una factory DXGI 1.1

L'esempio di codice seguente illustra come creare una factory DXGI 1.1. In questo esempio viene utilizzato l'intrinseco __uuidof() per ottenere REFIID, o GUID, dell'interfaccia IDXGIFactory1 .


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

Requisiti

Requisito Valore
Client minimo supportato Windows 7 [app desktop | App UWP]
Server minimo supportato Windows Server 2008 R2 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione dxgi.h
Libreria DXGI.lib
DLL Dxgi.dll

Vedi anche

Funzioni DXGI