IDXGIFactory1::EnumAdapters1, méthode (dxgi.h)

Énumère les deux adaptateurs (cartes vidéo) avec ou sans sorties.

Syntaxe

HRESULT EnumAdapters1(
        UINT          Adapter,
  [out] IDXGIAdapter1 **ppAdapter
);

Paramètres

Adapter

Type : UINT

Index de l’adaptateur à énumérer.

[out] ppAdapter

Type : IDXGIAdapter1**

Adresse d’un pointeur vers une interface IDXGIAdapter1 à la position spécifiée par le paramètre Adapter .
Ce paramètre ne doit pas être NULL.

Valeur retournée

Type : HRESULT

Retourne S_OK en cas de réussite ; sinon, retourne DXGI_ERROR_NOT_FOUND si l’index est supérieur ou égal au nombre d’adaptateurs dans le système local, ou DXGI_ERROR_INVALID_CALL si le paramètre ppAdapter a la valeur NULL.

Notes

Cette méthode n’est pas prise 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).

Lorsque vous créez une fabrique, la fabrique énumère l’ensemble des adaptateurs disponibles dans le système. Par conséquent, si vous modifiez les adaptateurs dans un système, vous devez détruire et recréer l’objet IDXGIFactory1 . Le nombre d’adaptateurs d’un système change lorsque vous ajoutez ou supprimez un carte d’affichage, ou que vous ancrez ou désactivez un ordinateur portable.

Lorsque la méthode EnumAdapters1 réussit et remplit le paramètre ppAdapter avec l’adresse du pointeur vers l’interface de l’adaptateur, EnumAdapters1 incrémente le nombre de références de l’interface de l’adaptateur. Lorsque vous avez terminé d’utiliser l’interface de l’adaptateur, appelez la méthode Release pour décrémenter le nombre de références avant de détruire le pointeur.

EnumAdapters1 retourne d’abord l’adaptateur avec la sortie sur laquelle le serveur principal du bureau est affiché. Cet adaptateur correspond à un index de zéro. EnumAdapters1 retourne ensuite d’autres adaptateurs avec des sorties. EnumAdapters1 retourne enfin des adaptateurs sans sortie.

Exemples

Énumération des adaptateurs

L’exemple de code suivant montre comment énumérer des adaptateurs à l’aide de la méthode EnumAdapters1 .

UINT i = 0; 
IDXGIAdapter1 * pAdapter; 
std::vector <IDXGIAdapter1*> vAdapters; 
while(pFactory->EnumAdapters1(i, &pAdapter) != DXGI_ERROR_NOT_FOUND) 
{ 
	vAdapters.push_back(pAdapter); 
	++i; 
} 
          

Spécifications

Voir aussi

DXGI Interfaces

IDXGIFactory1