Partilhar via


GetRenderTargetData - Backbuffer e Destino de Renderização (WoW64)

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
  • Device.Graphics.AdapterRender.MinimumDirectXLevel
Plataformas
  • Windows 10, edições de cliente (x64)
  • Windows Server 2016 (x64)
  • Windows 10, edições de cliente (Arm64)
Versões com suporte
  • Windows 10
  • Windows 10, versão 1511
  • Windows 10, versão 1607
  • Windows 10, versão 1703
  • Windows 10, versão 1709
  • Windows 10, versão 1803
  • Windows 10, versão 1809
  • Windows 10, versão 1903
  • Próxima atualização para Windows 10
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 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