Ddraw Blt - ColorFill - AGP

Note  This content applies to the Windows Logo Kit (WLK). For the latest information using the new Windows Hardware Certification Kit (HCK), see Windows HCK User's Guide on the Windows Hardware Dev Center.

Type: Automated Test

Overview

Most of the Microsoft DirectDraw tests (including the DDraw Blt - ColorFill - AGP test) are located in Fnddraw.exe. You can run Fnddraw.exe outside of the DCT shell, and select initial tests. On the Tests menu, click Select Tests.

The test titles that are listed in the DCT shell do not directly match the test names in Fnddraw.exe. In fact, the names in the DCT often refer to a group of Fnddraw tests. You can obtain the Fnddraw test case names from the DCT log file.You can pause many Fnddraw tests (especially blt-related tests) to give you time to visually analyze the blt results. Use the <Pause> key to pause and resume.

Use the <ESC> key to abort a test run. Be patient because some tests are more responsive than others.

Details

The purpose of the DDraw Blt - ColorFill - AGP tests is to verify that the graphics adapter can successfully perform color fill blt operations on AGP (non-local video) memory surfaces.

The test performs a series of color fill operations on an AGP surface whose pixel format matches the current display mode. Fill regions (RECTs) are chosen so that a variety of sizes and memory alignments are tested. The results of the color fills are compared against a reference image that is generated by using GDI.

Drivers are not required to support color fill operations on AGP surfaces. DirectDraw can perform these operations in its emulation layer. Flags that are passed to DirectDraw indicate whether or not a display driver supports color fill operations on AGP surfaces. If the driver sets flags that indicate support, the generated image must match the reference image exactly.

The Microsoft Windows Driver Kit (WDK) documents which flags a driver sets to indicate support for AGP color fills.

To run this test, use the Fnddraw.exe executable file with the BLT Color Fill AGP Mem test case.

Run Time: 00:01:50

Log File:

System Restart Required: No

Test Category:

Supported operating systems for Logo or Signature testing:

• Windows 7

• Windows Server 2008 R2

• Windows Vista

• Windows Server 2003

• Windows XP

Program:

Requirements

Software Requirements

The test tool requires the following software:

• Supported operating system (see list above).
• Software components included with the device that is being tested.
• DirectX version 7.0 or later

Hardware Requirements

• Device to be tested
• Computer that meets the minimum software requirements
• Windows keyboard
• Two-button pointing device
• Color display monitor capable of at least 1024 by 768 resolution, 32-bits per pixel, 60 Hz
• Hard drive with a minimum of 20 GB available on partition C:
• Display adapater with DDraw capabilities

Processor

• x86
• x64
• Itanium

Running DDraw Blt - ColorFill - AGP

There are no specific steps to follow for this test. You should run Fnddraw.exe with the BLT Color Fill AGP Mem test case.

Command Syntax

Cautions

Turn off the screen saver and disable the power management before you run this test. Mode changes and full-screen applications can cause failures, so you should avoid them.

Reference Documentation

Microsoft DirectX SDK (version 7.0 or later)

Code Tour

File Manifest

Build date: 9/14/2012