CreateDXGIFactory1, fonction (dxgi.h)

  • Article

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

Syntaxe

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

Paramètres

riid

Type : REFIID

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

[out] ppFactory

Type : void**

Adresse d’un pointeur vers un objet IDXGIFactory1 .

Valeur retournée

Type : HRESULT

Retourne S_OK en cas de réussite ; un code d’erreur dans le cas contraire. Pour obtenir la liste des codes d’erreur, consultez DXGI_ERROR.

Remarques

Utilisez une fabrique DXGI 1.1 pour générer des objets qui énumèrent les adaptateurs, créer des chaînes d’échange et associer 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 CreateDXGIFactory1 réussit, le nombre de références sur l’interface IDXGIFactory1 est incrémenté. Pour éviter une fuite de mémoire, lorsque vous avez terminé d’utiliser l’interface, appelez la méthode IDXGIFactory1 ::Release pour libérer l’interface.

Ce point d’entrée n’est pas pris en charge par DXGI 1.0, fourni dans Windows Vista et Windows Server 2008. La prise en charge de DXGI 1.1 est requise, disponible sur Windows 7, Windows Server 2008 R2 et en tant que mise à jour de Windows Vista avec Service Pack 2 (SP2) (KB 971644) et Windows Server 2008 (KB 971512).

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.
 
RemarqueCreateDXGIFactory1 é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.
 

Exemples

Création d’une fabrique DXGI 1.1

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


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

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 7 [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête dxgi.h
Bibliothèque DXGI.lib
DLL Dxgi.dll

Voir aussi

Fonctions DXGI