CreateDXGIFactory, fonction (dxgi.h)

  • Article

Crée une fabrique DXGI 1.0 que vous pouvez utiliser pour générer d’autres objets DXGI.

Syntaxe

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

Paramètres

riid

Type : REFIID

Identificateur global unique (GUID) de l’objet IDXGIFactory référencé par le paramètre ppFactory .

[out] ppFactory

Type : void**

Adresse d’un pointeur vers un objet IDXGIFactory .

Valeur retournée

Type : HRESULT

Retourne S_OK en cas de réussite ; sinon, retourne l’une des DXGI_ERROR suivantes.

Notes

Utilisez une fabrique DXGI pour générer des objets qui énumèrent des adaptateurs, créent des chaînes d’échange et associent une fenêtre à la séquence de touches alt+entrée pour basculer vers et depuis le mode d’affichage plein écran.

Si la fonction CreateDXGIFactory réussit, le nombre de références sur l’interface IDXGIFactory est incrémenté. Pour éviter une fuite de mémoire, lorsque vous avez terminé d’utiliser l’interface, appelez la méthode IDXGIFactory::Release pour libérer l’interface.

Note Ne mélangez pas l’utilisation de DXGI 1.0 (IDXGIFactory) et de DXGI 1.1 (IDXGIFactory1) dans une application. Utilisez IDXGIFactory ou IDXGIFactory1, mais pas les deux dans une application.
 
RemarqueCreateDXGIFactory échoue si la fonction DllMain de votre application l’appelle. Pour plus d’informations sur la façon dont DXGI répond à partir de DllMain, consultez Réponses DXGI à partir de DLLMain.
 
Note À compter de Windows 8, toutes les fabriques DXGI (qu’elles aient été créées avec CreateDXGIFactory ou CreateDXGIFactory1) énumèrent les adaptateurs de façon identique. L’ordre d’énumération des adaptateurs, que vous récupérez avec IDXGIFactory::EnumAdapters ou IDXGIFactory1::EnumAdapters1, est le suivant :
  • Adaptateur avec la sortie sur laquelle le serveur principal du bureau est affiché. Cet adaptateur correspond à un index de zéro.
  • Adaptateurs avec sorties.
  • Adaptateurs sans sorties.
 
La fonction CreateDXGIFactory n’existe pas pour les applications du Windows Store. Au lieu de cela, les applications du Windows Store utilisent la fonction CreateDXGIFactory1 .

Exemples

Création d’une fabrique DXGI 1.0

L’exemple de code suivant montre comment créer une fabrique DXGI 1.0. Cet exemple utilise l’intrinsèque __uuidof() pour obtenir le REFIID, ou GUID, de l’interface IDXGIFactory .


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

Spécifications

   
Plateforme cible Windows
En-tête dxgi.h
Bibliothèque DXGI.lib
DLL DXGI.dll

Voir aussi

Fonctions DXGI