GetRenderTargetData: backbuffer y destino de representación
Esta prueba automatizada comprueba que el método IDirect3DDevice9::GetRenderTargetData de Microsoft® Direct3D® 9 se puede usar para extraer el contenido de los búferes de reserva y los destinos de representación básicos.
La prueba crea primero las superficies de origen y destino. A continuación, la prueba recorre varios formatos de superficie y especificaciones de uso. Si alguna de las superficies no se puede crear, se omite esa configuración. Una vez creadas las superficies, la superficie de destino de representación se rellena con un quad con textura. A continuación, el origen se copia en el destino con el método GetRenderTargetData y se realiza una comparación de superficie para comprobar que el contenido de la superficie es el mismo.
Este tema se aplica a los siguientes trabajos de prueba:
GetRenderTargetData: backbuffer y destino de representación
GetRenderTargetData: backbuffer y destino de representación (WoW64)
Detalles de las pruebas
| Especificaciones |
|
| Plataformas |
|
| Versiones admitidas |
|
| Tiempo de ejecución esperado (en minutos) | 8 |
| Categoría | Compatibilidad |
| Tiempo de espera (en minutos) | 480 |
| Requiere reinicio | false |
| Requiere una configuración especial | false |
| Tipo | automatic |
Documentación adicional
Las pruebas de este área de características pueden tener documentación adicional, incluidos los requisitos previos, la configuración y la información de solución de problemas, que se pueden encontrar en los temas siguientes:
Ejecución de la prueba
Antes de ejecutar la prueba, complete la configuración de prueba como se describe en los requisitos de prueba: Requisitos previos de adaptador gráfico o pruebas de conjuntos de chips.
Además, esta prueba requiere el siguiente software y hardware.
- Microsoft DirectX® 9.0 o posterior
Solución de problemas
Para solucionar problemas genéricos de errores de prueba de HLK, consulte Solución de problemas de errores de prueba de HLK de Windows.
Para obtener información de solución de problemas, consulte Solución de problemas de Device.Graphics Testing.
Más información
En esta sección se incluirá contenido relacionado con pruebas que pueden no ayudar al evaluador a ejecutar o solucionar problemas de la prueba, pero es información que es buena para saber, pero no es necesario para ejecutar la prueba.
Esta prueba valida las especificaciones funcionales y operativas del método IDirect3DDevice9::GetRenderTargetData. El método GetRenderTargetData proporciona una manera de copiar el contenido de una superficie de destino de representación en una superficie de memoria del sistema. Hay varias restricciones en las superficies de origen y destino que debe cumplir para que esta copia se realice correctamente:
La superficie de origen debe ser una superficie de destino de representación normal o un nivel específico de una textura de destino de representación (textura de mapa miP o cubo).
El origen debe ser POOL_DEFAULT y D3DMULTISAMPLE_NONE.
La superficie de destino debe ser una superficie sin formato fuera de la pantalla o una textura (mapa de MIP o cubo) que se crea con POOL_SYSTEMMEM.
Las superficies de origen y destino deben tener el mismo formato y dimensión.
En la tabla siguiente se muestra la matriz de combinaciones de superficies que abarca esta prueba y las opciones de comando que usa la prueba para seleccionar el tipo de superficie.
| Superficie | Sin formato de pantalla | Textura de mapa de MIP | Textura del cubo |
|---|---|---|---|
Búfer de reserva |
-grtdbb |
-grtdbbt |
-grtdbbct |
Destino de representación |
-grtdrt |
-grtdrtt |
-grtdrtct |
Textura de mapa de MIP |
-grtdts |
-grtdtt |
-grtdtct |
Textura del cubo |
-grtdcts |
-grtdctt |
-grtdctct |
Sintaxis de comandos
| Opción de comando | Descripción |
|---|---|
Getrendertargetdata.exe -grtdbb -grtdbbt -grtdbbct -grtdrt -grtdrt -grtdrtt -grtdrtct -M:1 -dx9 -whql -logclean |
Ejecuta el trabajo de prueba, incluidas las opciones de superficies específicas. Para obtener más información sobre qué opción usar, consulte la tabla anterior en este tema. |
Nota
Para obtener ayuda de la línea de comandos para este binario de prueba, escriba /h.
Lista de archivos
| Archivo | Ubicación |
|---|---|
Configdisplay.exe |
<[testbinroot]>\nttest\windowstest\tools\ |
D3d10ref.dll |
<[testbinroot]>\nttest\graphics\d3d\support\ |
D3d11ref.dll |
<[testbinroot]>\nttest\windowstest\graphics\d3d\support\ |
D3dcompiler_test.dll |
<[testbinroot]>\nttest\windowstest\graphics\d3d\support\ |
D3dref.dll |
<[testbinroot]>\nttest\windowstest\graphics\d3d\support |
D3dref8.dll |
<[testbinroot]>\nttest\windowstest\graphics\d3d\support\ |
D3dref9.dll |
<[testbinroot]>\nttest\windowstest\graphics\d3d\support\ |
D3dx10_test.dll |
<[testbinroot]>\nttest\windowstest\graphics\d3d\support\ |
D3dx11_TEST.dll |
<[testbinroot]>\nttest\windowstest\graphics\d3d\support\ |
D3dx8d.dll |
<[testbinroot]>\nttest\windowstest\graphics\d3d\support\ |
D3dx9_TEST.dll |
<[testbinroot]>\nttest\windowstest\graphics\d3d\support\ |
Fpstate.dll |
<[testbinroot]>\nttest\windowstest\graphics\d3d\utility\ |
Getrendertargetdata.exe |
<[testbinroot]>\nttest\ |
Modechange.exe |
<[testbinroot]>\nttest\windowstest\graphics\d3d\utility\ |
TDRWatch.exe |
<[testbinroot]>\nttest\windowstest\graphics\ |
Vbswap.x |
<[testbinroot]>\nttest\windowstest\graphics\d3d\conf\ |
Parámetros
| Nombre de parámetro | Descripción de los parámetros |
|---|---|
| MONITOR | Índice de salida de visualización al destino con prueba |
| MODIFIEDCMDLINE | Argumentos de línea de comandos adicionales para el ejecutable de prueba |
| LLU_NetAccessOnly | Nombre de LLU de net user |
| ConfigDisplayCommandLine | Línea de comandos personalizada para ConfigDisplay. Valor predeterminado: logotipo |
| TDRArgs | /get o /set |