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) |