MÉTHODE IDXGIOutput1 ::GetDisplaySurfaceData1 (dxgi1_2.h)

Copie la surface d’affichage (mémoire tampon avant) dans une ressource fournie par l’utilisateur.

Syntaxe

HRESULT GetDisplaySurfaceData1(
  [in] IDXGIResource *pDestination
);

Paramètres

[in] pDestination

Pointeur vers une interface de ressource qui représente la ressource vers laquelle GetDisplaySurfaceData1 copie la surface d’affichage.

Valeur retournée

Retourne l’un des codes d’erreur décrits dans la rubrique DXGI_ERROR .

Remarques

GetDisplaySurfaceData1 est similaire à IDXGIOutput ::GetDisplaySurfaceData, sauf que GetDisplaySurfaceData1 prend un IDXGIResource et IDXGIOutput ::GetDisplaySurfaceData prend un IDXGISurface.

GetDisplaySurfaceData1 retourne une erreur si la ressource d’entrée n’est pas une texture 2D (représentée par l’interface ID3D11Texture2D) avec une taille de tableau (membre ArraySize de la structure D3D11_TEXTURE2D_DESC) égale aux mémoires tampons de la chaîne d’échange.

IdXGIOutput ::GetDisplaySurfaceData d’origine et GetDisplaySurfaceData1 mis à jour se comportent exactement de la même façon. GetDisplaySurfaceData1 était requis, car les textures d’une taille de tableau égale à 2 (ArraySize = 2) n’implémentent pas IDXGISurface.

Vous pouvez appeler GetDisplaySurfaceData1 uniquement lorsqu’une sortie est en mode plein écran. Si GetDisplaySurfaceData1 réussit, il remplit la ressource de destination.

Utilisez IDXGIOutput ::GetDesc pour déterminer la taille (largeur et hauteur) de la sortie lorsque vous souhaitez allouer de l’espace à la ressource de destination. Cela est vrai quelle que soit la rotation du moniteur cible. Une ressource de destination créée par un composant graphique (tel que Direct3D 11) doit être créée avec l’autorisation d’écriture du processeur (voir D3D11_CPU_ACCESS_WRITE). D’autres surfaces peuvent être créées avec l’autorisation de lecture/écriture du processeur (D3D11_CPU_ACCESS_READ | D3D11_CPU_ACCESS_WRITE). GetDisplaySurfaceData1 modifie les données de surface pour les adapter à la ressource de destination (stretch, shrink, convert format, rotate). GetDisplaySurfaceData1 effectue l’étirement et la réduction avec l’échantillonnage de points.

Configuration requise

Voir aussi

IDXGIOutput1