Méthode IDirect3DDevice9 ::GetFrontBufferData (d3d9.h)
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
Remarques
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.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | d3d9.h (inclure D3D9.h) |
| Bibliothèque | D3D9.lib |