Méthode IDirect3DDevice9::GetFrontBufferData (d3d9helper.h)

  • Article

Génère une copie de la mémoire tampon frontale de l’appareil et place cette copie dans une mémoire tampon système fournie par l’application.

Syntaxe

HRESULT GetFrontBufferData(
  [in] UINT              iSwapChain,
  [in] IDirect3DSurface9 *pDestSurface
);

Paramètres

[in] iSwapChain

Type : UINT

Entier non signé spécifiant la chaîne d’échange.

[in] pDestSurface

Type : IDirect3DSurface9*

Pointeur vers une interface IDirect3DSurface9 qui recevra une copie du contenu de la mémoire tampon frontale. Les données sont retournées dans des lignes successives sans espace intermédiaire, à partir de la ligne verticalement la plus élevée de la sortie de l’appareil jusqu’à la ligne la plus basse.

Pour le mode fenêtré, la taille de la surface de destination doit être la taille du bureau. Pour le mode plein écran, la taille de la surface de destination doit être la taille de l’écran.

Valeur retournée

Type : HRESULT

Si la méthode réussit, la valeur de retour est D3D_OK. Si la méthode échoue, la valeur de retour peut être l’une des suivantes : D3DERR_DRIVERINTERNALERROR, D3DERR_DEVICELOST, D3DERR_INVALIDCALL

Notes

La mémoire tampon pointée vers pDestSurface est remplie d’une représentation de la mémoire tampon avant, convertie au format standard de 32 bits par pixel D3DFMT_A8R8G8B8.

Cette méthode est la seule façon de capturer une capture d’écran anti-attirail.

Cette fonction est très lente, de par sa conception, et ne doit pas être utilisée dans un chemin d’accès critique pour les performances.

Pour plus d’informations, consultez Appareils perdus et données récupérées.

Spécifications

   
Plateforme cible Windows
En-tête d3d9helper.h (incluez D3D9.h)
Bibliothèque D3D9.lib

Voir aussi

IDirect3DDevice9