Table of contents
GDI
TOC
Collapse the table of content
Expand the table of content

Reporting Support for Programmable Pixel Processing Hardware

Last Updated: 2/14/2017

For a DirectX 8.0 level driver to report support for programmable pixel shader hardware, it must set the PixelShaderVersion field of the D3DCAPS8 structure to a valid, nonzero pixel shader version number. The PixelShaderVersion is a DWORD where the most significant word must have the value 0xFFFF and the least significant word holds the actual version number. This least significant byte of this word holds the minor version number and the most significant byte holds the major version number. Because the format of this DWORD is complex, the driver must set the value of PixelShaderVersion using the macro D3DPS_VERSION defined in d3d8types.h. For example, the following code fragment sets the PixelShaderVersion to indicate support for 1.0 level functionality.

myD3DCaps8.PixelShaderVersion = D3DPS_VERSION(1, 0);

Drivers that do not support programmable pixel processing should set PixelShaderVersion to zero.

Unlike reporting the number of constant registers a device has for vertex shaders, a device cannot expose more constant registers than are defined by the pixel shader version it specifies. For example, a device that implements the 1.0 pixel shader specification must expose only eight constant pixel shader registers. However, there is an additional pixel shader related capability that a driver should set, MaxPixelShaderValue. This field gives the internal range of values supported for pixel color blending operations.

Implementations must allow data within the range they report to pass through pixel processing unmodified (for example unclamped). This value normally defines the limits of a signed range, that is, an absolute value. Therefore, for example, 1 indicates that the range is [-1.0 to 1.0], and 8 indicates that the range is [-8.0 to 8.0]. For pixel shader version 1.0 to 1.3, the driver must set the value in MaxPixelShaderValue to a minimum of 1. For 1.4, the driver must set the value in MaxPixelShaderValue to a minimum of 8.

Send comments about this topic to Microsoft

© 2017 Microsoft