D3DQuery Conformance Test
This automated test checks for driver support for Microsoft® DirectX® 9.0 asynchronous notifications.
Specifically, this test validates the functional and operational specifications for the DirectX 9.0 asynchronous notification API. This API provides an efficient and flexible mechanism to query the driver for state or statistical information. The query is run either synchronously (the application waits) or asynchronously (the application does not wait). The asynchronous notification API consists of the IDirect3DDevice9::CreateQuery, IDirect3DDevice9::Issue, and IDirect3DDevice9::GetData methods.
The Microsoft Direct3D® API defines a fixed set of query types, and the driver supports the query types that it chooses during setup. This test validates only the query types that the driver supports. All other query types are not validated.
This topic applies to the following test jobs:
D3DQuery Conformance Test
D3DQuery Conformance Test (WoW64)
Test details
Associated requirements |
Device.Graphics.AdapterRender.MinimumDirectXLevel |
Platforms |
Windows 7 (x64) Windows 7 (x86) Windows RT (ARM-based) Windows 8 (x64) Windows 8 (x86) Windows Server 2012 (x64) Windows Server 2008 R2 (x64) Windows RT 8.1 Windows 8.1 x64 Windows 8.1 x86 Windows Server 2012 R2 |
Expected run time |
~2 minutes |
Categories |
Basic Certification Functional |
Type |
Automated |
Running the test
Before you run the test, complete the test setup as described in the test requirements: Graphic Adapter or Chipset Testing Prerequisites.
In addition, this test requires the following software:
Microsoft DirectX 9.0 or later
High definition TV screen.
Troubleshooting
For troubleshooting information, see Troubleshooting Device.Graphics Testing.
The driver returns D3DERR_NOTAVAILABLE if the query type is not supported.
The test writes the test results to the D3DQuery.xml log file, and indicates success or failure on screen. The test log is written to the %windir%\dxlogs directory.
More information
There are general properties that are common to all or to a subset of query types. These properties are validated for each appropriate query type. For example, the test checks that asynchronous queries are performed in parallel with the CPU execution. It counts the number of iterations required to fetch the data with the GetData method.
There are also specific properties that are unique to a query type. These properties are validated for that query type, and typically involve verifying that the data that a query returns conforms to the expected value. For example, in the occlusion query, the test verifies that the number of processed pixels corresponds to the exposed area of the rendered primitive.
Command syntax
| Command option | Description |
|---|---|
D3DQuery -M:1 -dx9 -whql -logclean |
This command runs the D3DQuery Conformance test job. |
D3DQuery -M:1 -whql -logclean |
This command runs the D3DQuery Conformance (WoW64) test job. |
Note
For command line help for this test binary, type /?.
File list
| File | Location |
|---|---|
Configdisplay.exe |
<[testbinroot]>\nttest\windowstest\tools |
D3d10ref.dll |
<[testbinroot]>\nttest\graphics\d3d\support\ |
D3d11ref.dll |
<[testbinroot]>\nttest\windowstest\graphics\d3d\support\ |
D3DQuery.exe |
<[testbinroot]>\nttest\windowstest\graphics\d3d\conf\ |
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\ |
Modechange.exe |
<[testbinroot]>\nttest\windowstest\graphics\d3d\utility\ |
TDRWatch.exe |
<[testbinroot]>\nttest\windowstest\graphics\ |
Vbswap.x |
<[testbinroot]>\nttest\windowstest\graphics\d3d\conf\ |