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