IDXGIOutput::GetDisplaySurfaceData, méthode (dxgi.h)

[À compter de Direct3D 11.1, nous vous recommandons de ne plus utiliser GetDisplaySurfaceData pour récupérer la surface d’affichage actuelle. Utilisez plutôt IDXGIOutput1::GetDisplaySurfaceData1, qui prend en charge le mode d’affichage stéréo.]

Obtient une copie de l’aire d’affichage actuelle.

Syntaxe

HRESULT GetDisplaySurfaceData(
  [in] IDXGISurface *pDestination
);

Paramètres

[in] pDestination

Type : IDXGISurface*

Pointeur vers une surface de destination (voir IDXGISurface).

Valeur retournée

Type : HRESULT

Retourne l’une des valeurs DXGI_ERROR .

Notes

IDXGIOutput::GetDisplaySurfaceData ne peut être appelé que lorsqu’une sortie est en mode plein écran. Si la méthode réussit, DXGI remplit la surface de destination.

Utilisez IDXGIOutput::GetDesc pour déterminer la taille (largeur et hauteur) de la sortie lorsque vous souhaitez allouer de l’espace à la surface de destination. Cela est vrai quelle que soit la rotation du moniteur cible. Une surface de destination créée par un composant graphique (tel que Direct3D 10) doit être créée avec l’autorisation d’écriture du processeur (voir D3D10_CPU_ACCESS_WRITE). D’autres surfaces doivent être créées avec l’autorisation de lecture-écriture du processeur (voir D3D10_CPU_ACCESS_READ_WRITE). Cette méthode modifie les données de surface pour qu’elles s’adaptent à la surface de destination (étirer, réduire, convertir le format, faire pivoter). L’étirement et la réduction sont effectués avec l’échantillonnage de points.

Spécifications

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

Voir aussi

DXGI Interfaces

IDXGIOutput