次の方法で共有

GetRenderTargetData - ミップ テクスチャとキューブ テクスチャ

  • [アーティクル]

この自動テストでは、IDirect3DDevice9:: GetRenderTargetData メソッド (Microsoft Direct3D 9) を使用して、レンダーターゲットの Mipmaps および Cubemaps の内容を抽出できることを確認します。

テストでは、最初にソース サーフェスと目的地サーフェスが作成されます。 テストでは、さまざまなサーフェイス形式と使用法の仕様を循環しています。 いずれかのサーフェスを作成できない場合、その構成はスキップされます。 サーフェスが作成されると、レンダーターゲット サーフェスがテクスチャ化された四角形で塗りつぶされます。 次に、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 への次の更新プログラム
予想される実行時間 (分) 2
カテゴリ 互換性
タイムアウト (分) 120
再起動が必要です 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 -grtdts -grtdtt -grtdtct -grtdcts -grtdctt -grtdctct -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