GetRenderTargetData - Backbuffer et cible de rendu

Ce test automatisé vérifie que la méthode IDirect3DDevice9::GetRenderTargetData dans Microsoft® Direct3D® 9 peut être utilisée pour extraire le contenu des mémoires tampons arrière et des cibles de rendu de base.

Le test crée d’abord les surfaces source et de destination. Le test effectue ensuite des cycles dans différents formats de surface et spécifications d’utilisation. Si l’une des surfaces ne peut pas être créée, cette configuration est ignorée. Une fois les surfaces créées, la surface cible de rendu est remplie d’un quad texturé. Ensuite, la source est copiée dans la destination avec la méthode GetRenderTargetData, et une comparaison de surface est effectuée pour vérifier que le contenu des deux surfaces est identique.

Cette rubrique s’applique aux travaux de test suivants :

• GetRenderTargetData - Backbuffer et cible de rendu

• GetRenderTargetData - Backbuffer et cible de rendu (WoW64)

Détails du test

Documentation supplémentaire

Les tests de cette zone de fonctionnalités peuvent contenir une documentation supplémentaire, notamment des informations sur les prérequis, l’installation et la résolution des problèmes, que vous trouverez dans les rubriques suivantes :

• Documentation supplémentaire sur Device.Graphics

Exécution du test

Avant d’exécuter le test, effectuez la configuration du test comme décrit dans les conditions requises pour le test : Adaptateur graphique ou Prérequis de test de chipset.

En outre, ce test nécessite les logiciels et matériels suivants.

• Microsoft DirectX® 9.0 ou version ultérieure

Dépannage

Pour la résolution des problèmes génériques des échecs de test HLK, consultez Résolution des échecs de test Windows HLK.

Pour plus d’informations sur la résolution des problèmes, consultez Résolution des problèmes de test Device.Graphics.

Plus d’informations

Cette section inclut du contenu lié aux tests qui peut ne pas aider le testeur à exécuter ou à résoudre les problèmes du test, mais qui est des informations qui sont bonnes à connaître, mais qui ne sont pas nécessaires pour l’exécution du test.

Ce test valide les spécifications fonctionnelles et opérationnelles de la méthode IDirect3DDevice9::GetRenderTargetData. La méthode GetRenderTargetData permet de copier le contenu d’une surface cible de rendu sur une surface de mémoire système. Il existe plusieurs restrictions sur les surfaces source et de destination que vous devez respecter pour que cette copie réussisse :

• La surface source doit être une surface cible de rendu standard ou un niveau spécifique d’une texture cible de rendu (mip map ou texture de cube).

• La source doit être POOL_DEFAULT et D3DMULTISAMPLE_NONE.

• La surface de destination doit être une surface ordinaire hors écran ou une texture (carte MIP ou cube) créée avec POOL_SYSTEMMEM.

• Les surfaces source et de destination doivent avoir la même dimension et le même format.

Le tableau suivant montre la matrice des combinaisons de surfaces que ce test couvre et les options de commande que le test utilise pour sélectionner le type de surface.

Syntaxe de commande

Liste de fichiers

Paramètres