DXVA_COPPStatusDisplayData structure (dxva.h)

The DXVA_COPPStatusDisplayData structure describes the display mode of the signal that is transmitted over the connector associated with a DirectX VA COPP device.

Syntax

typedef struct _DXVA_COPPStatusDisplayData {
  GUID  rApp;
  ULONG dwFlags;
  ULONG DisplayWidth;
  ULONG DisplayHeight;
  ULONG Format;
  ULONG d3dFormat;
  ULONG FreqNumerator;
  ULONG FreqDenominator;
} DXVA_COPPStatusDisplayData;

Members

rApp

Specifies a 128-bit random number, used once. This random number is generated by the requesting application and supplied to the display driver in the rApp member of the DXVA_COPPStatusInput structure.

dwFlags

Specifies additional status information that might be relevant to the calling application. The display driver should set dwFlags to the COPP_StatusNormal (0x00) value from the COPP_StatusFlags enumeration type or to a valid ORed combination of the following COPP_StatusFlags:

• COPP_LinkLost (0x01)
• COPP_RenegotiationRequired (0x02)

DisplayWidth

Specifies the current display width in pixels.

DisplayHeight

Specifies the current display height in pixels.

Format

Specifies how data is formatted on the display as defined by a DXVA_ExtendedFormat structure.

d3dFormat

Specifies the Direct3D surface format of the display. This is a value from the D3DFORMAT enumeration type. For more information, see the latest DirectX SDK documentation.

FreqNumerator

Specifies the numerator for the refresh rate of the current display mode.

FreqDenominator

Specifies the denominator for the refresh rate of the current display mode.

Remarks

The display driver returns display status through the pOutput parameter of COPPQueryStatus. The DXVA_COPPStatusOutput structure describes the returned status information. The display driver should cast the display status to a pointer to a DXVA_COPPStatusDisplayData structure and return the status information in the COPPStatus member of DXVA_COPPStatusOutput.

Because the DXVA_COPPQueryDisplayData request returns display information for the connector associated with the COPP device, this display information is not necessarily the same as the Windows desktop display mode. For example, if the connector associated with the COPP device is S-Video and the Windows desktop is set to 1024 x 768 at 85 Hz, then the DXVA_COPPQueryDisplayData request should return the resolution of the S-Video signal (720 x 480 at 60/1.01 Hz interlaced) and not the desktop resolution.

The refresh rate of the current display mode is expressed as a numerator/denominator pair. For example, 72 Hz is expressed by setting FreqNumerator to 72 and FreqDenominator to 1, and NTSC TV modes are expressed by setting FreqNumerator to 60,000 and FreqDenominator to 1,001.

Requirements

Requirement	Value
Minimum supported client	This structure applies only to Windows Server 2003 with SP1 and later, and Windows XP with SP2 and later.
Header	dxva.h (include Dxva.h)

See also

COPPQueryStatus

DXVA_COPPSetProtectionLevelCmdData

DXVA_COPPStatusInput

DXVA_COPPStatusOutput

DXVA_ExtendedFormat