GetRenderTargetData - Backbuffer e Destino de Renderização
Esse teste automatizado verifica se o método IDirect3DDevice9::GetRenderTargetData no Microsoft® Direct3D® 9 pode ser usado para extrair o conteúdo de buffers de fundo e destinos básicos de renderização.
O teste primeiro cria as superfícies de origem e destino. Em seguida, o teste percorre vários formatos de superfície e especificações de uso. Se uma das superfícies não puder ser criada, essa configuração será ignorada. Depois que as superfícies são criadas, a superfície de destino de renderização é preenchida com um quad texturizado. Em seguida, a origem é copiada para o destino com o método GetRenderTargetData e uma comparação de superfície é executada para verificar se o conteúdo das duas superfícies é o mesmo.
Este tópico se aplica aos seguintes trabalhos de teste:
GetRenderTargetData - Backbuffer e Destino de Renderização
GetRenderTargetData - Backbuffer e Destino de Renderização (WoW64)
Detalhes do teste
| Especificações |
|
| Plataformas |
|
| Versões com suporte |
|
| Tempo de execução esperado (em minutos) | 8 |
| Categoria | Compatibilidade |
| Tempo limite (em minutos) | 480 |
| Requer reinicialização | false |
| Requer configuração especial | false |
| Tipo | automático |
Documentação adicional
Os testes nessa área de recurso podem ter documentação adicional, incluindo pré-requisitos, configuração e informações de solução de problemas, que podem ser encontradas nos tópicos a seguir:
Executando o teste
Antes de executar o teste, conclua a configuração de teste conforme descrito nos requisitos de teste: Pré-requisitos de teste de adaptador gráfico ou chipset.
Além disso, esse teste requer o software e o hardware a seguir.
- Microsoft DirectX® 9.0 ou posterior
Solucionando problemas
Para solução de problemas genéricos de falhas de teste do HLK, consulte Solução de problemas de falhas de teste do Windows HLK.
Para obter informações de solução de problemas, consulte Solução de problemas de teste de device.graphics.
Mais informações
Esta seção incluirá conteúdo relacionado ao teste que pode não ajudar o testador na execução ou na solução de problemas do teste, mas são informações que são boas de se saber, mas não são necessárias para executar o teste.
Esse teste valida as especificações funcionais e operacionais para o método IDirect3DDevice9::GetRenderTargetData. O método GetRenderTargetData fornece uma maneira de copiar o conteúdo de uma superfície de destino de renderização para uma superfície de memória do sistema. Há várias restrições nas superfícies de origem e destino que você deve atender para que essa cópia tenha êxito:
A superfície de origem deve ser uma superfície de destino de renderização regular ou um nível específico de uma textura de destino de renderização (mapa MIP ou textura de cubo).
A origem deve ser POOL_DEFAULT e D3DMULTISAMPLE_NONE.
A superfície de destino deve ser uma superfície simples fora da tela ou uma textura (mapa MIP ou cubo) criada com POOL_SYSTEMMEM.
As superfícies de origem e destino devem ter a mesma dimensão e formato.
A tabela a seguir mostra a matriz de combinações de superfície que este teste aborda e as opções de comando que o teste usa para selecionar o tipo de superfície.
| Surface | Offscreen plain | Textura de mapa MIP | Textura do cubo |
|---|---|---|---|
Buffer de fundo |
-grtdbb |
-grtdbbt |
-grtdbbct |
Destino de renderização |
-grtdrt |
-grtdrtt |
-grtdrtct |
Textura de mapa MIP |
-grtdts |
-grtdtt |
-grtdtct |
Textura do cubo |
-grtdcts |
-grtdctt |
-grtdctct |
Sintaxe de comando
| Opção de comando | Descrição |
|---|---|
Getrendertargetdata.exe -grtdbb -grtdbbt -grtdbbct -grtdrt -grtdrt -grtdrtt -grtdrtct -M:1 -dx9 -whql -logclean |
Executa o trabalho de teste, incluindo opções para superfícies específicas. Para obter mais informações sobre qual opção usar, consulte a tabela anteriormente neste tópico. |
Observação
Para obter ajuda de linha de comando para esse binário de teste, digite /h.
Lista de arquivos
| Arquivo | Location |
|---|---|
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
| Nome do parâmetro | Descrição do parâmetro |
|---|---|
| MONITOR | Índice de saída de exibição para o destino com teste |
| MODIFIEDCMDLINE | Argumentos de linha de comando adicionais para executável de teste |
| LLU_NetAccessOnly | Nome da LLU do usuário líquido |
| ConfigDisplayCommandLine | Linha de comando personalizada para ConfigDisplay. Padrão: logotipo |
| TDRArgs | /get ou /set |