次の方法で共有

GetRenderTargetData - バックバッファーとレンダー ターゲット

  • [アーティクル]

この自動テストでは、Microsoft® Direct3D® 9 の IDirect3DDevice9::GetRenderTargetData メソッドを使用して、バック バッファーと基本的なレンダー ターゲットの内容を抽出できることを検証します。

テストでは、最初にソースとターゲットのサーフェイスが作成されます。 その後、テストでは、さまざまなサーフェイスの形式と使用法に関する仕様を順番に切り替えます。 いずれかのサーフェイスを作成できない場合、その構成はスキップされます。 サーフェイスが作成されると、レンダーターゲット サーフェイスはテクスチャを適用した四角形で塗りつぶされます。 次に、GetRenderTargetData メソッドを使用してソースを変換先にコピーし、サーフェイスの比較を実行して 2 つのサーフェイスの内容が同じであることを確認します。

このトピックは次のテスト ジョブに適用されます。

  • GetRenderTargetData - バックバッファーとレンダー ターゲット

  • GetRenderTargetData - バックバッファーとレンダー ターゲット (WoW64)

テストの詳細

   
仕様
  • Device.Graphics.AdapterRender.MinimumDirectXLevel
プラットフォーム
  • Windows 10、クライアント エディション (x86)
  • Windows 10、クライアント エディション (x64)
  • Windows Server 2016 (x64)
  • Windows 10、クライアント エディション (Arm64)
サポートされているリリース
  • Windows 10
  • Windows 10 バージョン 1511
  • Windows 10 Version 1607
  • Windows 10 Version 1703
  • Windows 10 バージョン 1709
  • Windows 10 バージョン 1803
  • Windows 10 Version 1809
  • Windows 10 バージョン 1903
  • Windows 10 への次の更新プログラム
予想される実行時間 (分) 8
カテゴリ 互換性
タイムアウト (分) 480
再起動が必要です false
特別な構成が必要です false
Type automatic

 

その他のドキュメント

この機能領域のテストには、前提条件、セットアップ、トラブルシューティング情報など、次のトピックに記載されている追加のドキュメントが含まれている場合があります。

テストの実行

テストを実行する前に、「グラフィック アダプターまたはチップセットのテストの前提条件」で説明されているテスト要件に従って、テストのセットアップを完了します。

さらに、このテストには次のソフトウェアとハードウェアが必要です。

  • Microsoft DirectX®9.0 かそれ以降

トラブルシューティング

HLK テスト エラーの一般的なトラブルシューティングについては、「Windows HLK テストのエラーのトラブルシューティング」を参照してください。

トラブルシューティング情報については、「Device.Graphics テストのトラブルシューティング」を参照してください。

詳細

このセクションに含まれるテスト関連のコンテンツは、テスターによるテストの実行またはトラブルシューティングには有用ではない場合がありますが、知っておいた方がよい情報です。ただし、テストの実行に不可欠ではありません。

このテストでは、IDirect3DDevice9:: GetRenderTargetData メソッドの機能と操作の仕様を検証します。 GetRenderTargetData メソッドでは、レンダー ターゲット サーフェイスの内容をシステム メモリ サーフェイスにコピーする手段を提供します。 コピーを成功させるには、コピー元とコピー先のサーフェイスに関して、満たす必要がある制限がいくつかあります。

  • ソースのサーフェイスは、標準のレンダー ターゲット サーフェイスまたはレンダー ターゲット テクスチャ (MIP マップまたはキューブ テクスチャ) の特定のレベルである必要があります。

  • ソースは POOL_DEFAULT と D3DMULTISAMPLE_NONE である必要があります。

  • コピー先のサーフェイスは、POOL_SYSTEMMEM で作成された画面外のプレーン サーフェイスまたはテクスチャ (MIP マップまたはキューブ) のいずれかである必要があります。

  • コピー元とコピー先のサーフェイスは、同じディメンションと形式である必要があります。

次の表に、このテストで対象となるサーフェイスの組み合わせのマトリックスと、サーフェイスの種類を選択するために使用されるコマンド オプションを示します。

Surface オフスクリーン プレーン MIP マップ テクスチャ キューブのテクスチャ

バック バッファー

-grtdbb

-grtdbbt

-grtdbbct

レンダー ターゲット

-grtdrt

-grtdrtt

-grtdrtct

MIP マップ テクスチャ

-grtdts

-grtdtt

-grtdtct

キューブのテクスチャ

-grtdcts

-grtdctt

-grtdctct

 

コマンド構文

コマンド オプション 説明

Getrendertargetdata.exe -grtdbb -grtdbbt -grtdbbct -grtdrt -grtdrt -grtdrtt -grtdrtct -M:1 -dx9 -whql -logclean

特定のサーフェイスのオプションを含むテスト ジョブを実行します。 使用するオプションの詳細については、このトピックの前の表を参照してください。

Note

   このテスト バイナリのコマンド ライン ヘルプを表示するには、「/h」と入力します。

 

ファイル一覧

ファイル 場所

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\

 

パラメーター

パラメーター名 パラメーターの説明
MONITOR テストで対象とする表示出力のインデックス
MODIFIEDCMDLINE テスト実行可能ファイルの追加のコマンド ライン引数
LLU_NetAccessOnly net user の LLU 名
ConfigDisplayCommandLine ConfigDisplay のカスタム コマンド ライン。 既定値: logo
TDRArgs /get または /set