DXVA_COPPStatusInput structure (dxva.h)

Article
02/22/2024

The DXVA_COPPStatusInput structure describes a request for status on a protected video session that is associated with a DirectX VA COPP device.

Syntax

typedef struct _DXVA_COPPStatusInput {
  GUID  rApp;
  GUID  guidStatusRequestID;
  ULONG dwSequence;
  ULONG cbSizeData;
  UCHAR StatusData[4056];
} DXVA_COPPStatusInput, *LPDXVA_COPPStatusInput;

Members

rApp

Specifies a 128-bit random number (used once) generated by the sending application. This random number is also returned by the display driver with the status data in the rApp member of the DXVA_COPPStatusData structure. The display driver also supplies this random number to the message authentication code (MAC) generator to generate the MAC GUID.

guidStatusRequestID

Specifies the GUID that identifies the status request. The following status request GUIDs are supported:

DXVA_COPPQueryConnectorType

DEFINE_GUID(DXVA_COPPQueryConnectorType,
  0x81d0bfd5,0x6afe,0x48c2,0x99,0xc0,0x95,0xa0,0x8f,0x97,0xc5,0xda);

DXVA_COPPQueryProtectionType

DEFINE_GUID(DXVA_COPPQueryProtectionType,
  0x38f2a801,0x9a6c,0x48bb,0x91,0x07,0xb6,0x69,0x6e,0x6f,0x17,0x97);

DXVA_COPPQueryLocalProtectionLevel

DEFINE_GUID(DXVA_COPPQueryLocalProtectionLevel,
  0xb2075857,0x3eda,0x4d5d,0x88,0xdb,0x74,0x8f,0x8c,0x1a,0x05,0x49);

DXVA_COPPQueryGlobalProtectionLevel

DEFINE_GUID(DXVA_COPPQueryGlobalProtectionLevel,
  0x1957210a,0x7766,0x452a,0xb9,0x9a,0xd2,0x7a,0xed,0x54,0xf0,0x3a);

DXVA_COPPQueryDisplayData

DEFINE_GUID(DXVA_COPPQueryDisplayData,
  0xd7bf1ba3,0xad13,0x4f8e,0xaf,0x98,0x0d,0xcb,0x3c,0xa2,0x04,0xcc);

DXVA_COPPQueryHDCPKeyData

DEFINE_GUID(DXVA_COPPQueryHDCPKeyData,
  0xdb59d74,0xa992,0x492e,0xa0,0xbd,0xc2,0x3f,0xda,0x56,0x4e,0x0);

DXVA_COPPQueryBusData

DEFINE_GUID(DXVA_COPPQueryBusData,
  0xc6f4d673,0x6174,0x4184,0x8e,0x35,0xf6,0xdb,0x52, 0x0,0xbc,0xba);

DXVA_COPPQuerySignaling

DEFINE_GUID(DXVA_COPPQuerySignaling,
  0x6629a591,0x3b79,0x4cf3,0x92,0x4a,0x11,0xe8,0xe7,0x81,0x16,0x71);

dwSequence

Specifies a sequence number. For the COPPQueryStatus function to process the status request, the value in dwSequence must match the 32-bit random starting status sequence number that was passed in the DXVA_COPPSignature structure to the COPPSequenceStart function.

cbSizeData

Specifies the size, in bytes, of the status request data at StatusData.

StatusData[4056]

Specifies an array that contains the data that accompanies the status request identified by guidStatusRequestID.

No data is required for the DXVA_COPPQueryConnectorType, DXVA_COPPQueryProtectionType, DXVA_COPPQueryDisplayData, DXVA_COPPQueryHDCPKeyData, DXVA_COPPQueryBusData, and DXVA_COPPQuerySignaling requests.

The DXVA_COPPQueryLocalProtectionLevel and DXVA_COPPQueryGlobalProtectionLevel requests require data that identifies the protection type for which the protection level is requested. Therefore, these requests require that the first 4 bytes in the StatusData array contain the protection type.

Remarks

Status requests are passed in the pInput parameter of the COPPQueryStatus function. Status information is returned through the pOutput parameter of COPPQueryStatus. The DXVA_COPPStatusOutput structure describes the returned status information.

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)