IdXGIAdapter ::EnumOutputs, méthode (dxgi.h)

Article
02/28/2024

Énumérer les sorties de l’adaptateur (carte vidéo).

Syntaxe

HRESULT EnumOutputs(
        UINT        Output,
  [out] IDXGIOutput **ppOutput
);

Paramètres

Output

Type : UINT

Index de la sortie.

[out] ppOutput

Type : IDXGIOutput**

Adresse d’un pointeur vers une interface IDXGIOutput à la position spécifiée par le paramètre Output .

Valeur retournée

Type : HRESULT

Code qui indique la réussite ou l’échec (voir DXGI_ERROR). DXGI_ERROR_NOT_FOUND est retourné si l’index est supérieur au nombre de sorties.

Si l’adaptateur provient d’un appareil créé à l’aide de D3D_DRIVER_TYPE_WARP, l’adaptateur n’a pas de sorties, de sorte que DXGI_ERROR_NOT_FOUND est retourné.

Remarques

Note Si vous appelez cette API dans un processus session 0, elle retourne DXGI_ERROR_NOT_CURRENTLY_AVAILABLE.

Lorsque la méthode EnumOutputs réussit et remplit le paramètre ppOutput avec l’adresse du pointeur vers l’interface de sortie, EnumOutputs incrémente le nombre de références de l’interface de sortie. Pour éviter une fuite de mémoire, lorsque vous avez terminé d’utiliser l’interface de sortie, appelez la méthode Release pour décrémenter le nombre de références.

EnumOutputs retourne d’abord la sortie sur laquelle le serveur principal du bureau est affiché. Cette sortie correspond à un index de zéro. EnumOutputs retourne ensuite d’autres sorties.

Exemples

Énumération des sorties

Voici un exemple d’utilisation d’EnumOutputs pour énumérer toutes les sorties sur un adaptateur :


UINT i = 0;
IDXGIOutput * pOutput;
std::vector<IDXGIOutput*> vOutputs;
while(pAdapter->EnumOutputs(i, &pOutput) != DXGI_ERROR_NOT_FOUND)
{
    vOutputs.push_back(pOutput);
    ++i;
}

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	dxgi.h
Bibliothèque	DXGI.lib

Voir aussi

DXGI Interfaces

IDXGIAdapter

Partager via