DXGKMDT_OPM_COPP_COMPATIBLE_GET_INFO_PARAMETERS structure (d3dkmdt.h)

The DXGKMDT_OPM_COPP_COMPATIBLE_GET_INFO_PARAMETERS structure contains parameters that are used to retrieve information from a protected output object in a call to the DxgkDdiOPMGetCOPPCompatibleInformation function.

Syntax

typedef struct _DXGKMDT_OPM_COPP_COMPATIBLE_GET_INFO_PARAMETERS {
  DXGKMDT_OPM_RANDOM_NUMBER rnRandomNumber;
  GUID                      guidInformation;
  ULONG                     ulSequenceNumber;
  ULONG                     cbParametersSize;
  BYTE                      abParameters[DXGKMDT_OPM_GET_INFORMATION_PARAMETERS_SIZE];
} DXGKMDT_OPM_COPP_COMPATIBLE_GET_INFO_PARAMETERS, *PDXGKMDT_OPM_COPP_COMPATIBLE_GET_INFO_PARAMETERS;

Members

rnRandomNumber

A DXGKMDT_OPM_RANDOM_NUMBER structure that contains a protected output object's 128-bit cryptographically secure random number. This random number is generated by an application and supplied to the display miniport driver in rnRandomNumber in a call to the driver's DxgkDdiOPMGetCOPPCompatibleInformation function.

guidInformation

The GUID that is used to retrieve the information. guidInformation can be set to one of the following GUIDs:

• DXGKMDT_OPM_GET_CONNECTED_HDCP_DEVICE_INFORMATION
• DXGKMDT_OPM_GET_CONNECTOR_TYPE
• DXGKMDT_OPM_GET_SUPPORTED_PROTECTION_TYPES
• DXGKMDT_OPM_GET_VIRTUAL_PROTECTION_LEVEL
• DXGKMDT_OPM_GET_ACTUAL_PROTECTION_LEVEL
• DXGKMDT_OPM_GET_ACTUAL_OUTPUT_FORMAT
• DXGKMDT_OPM_GET_ADAPTER_BUS_TYPE
• DXGKMDT_OPM_GET_ACP_AND_CGMSA_SIGNALING

ulSequenceNumber

A sequence number. For the DxgkDdiOPMGetCOPPCompatibleInformation function to process an information request, the value in ulSequenceNumber must match the current 4-byte sequence number that the display miniport driver stores. If a match is not detected, DxgkDdiOPMGetCOPPCompatibleInformation returns an error code. If a match is detected, DxgkDdiOPMGetCOPPCompatibleInformation increments the stored sequence number before returning. The initial 4-byte sequence number was part of the 256-byte array that the EncryptedParameters parameter of the DxgkDdiOPMSetSigningKeyAndSequenceNumbers function pointed to.

cbParametersSize

The size, in bytes, of the valid data that the abParameters member points to.

abParameters[DXGKMDT_OPM_GET_INFORMATION_PARAMETERS_SIZE]

A 4056-byte array that contains the data that accompanies the information request that is identified by the guidInformation member.

No data is required for the DXGKMDT_OPM_GET_CONNECTOR_TYPE, DXGKMDT_OPM_GET_SUPPORTED_PROTECTION_TYPES, DXGKMDT_OPM_GET_ACTUAL_OUTPUT_FORMAT, DXGKMDT_OPM_GET_CONNECTED_HDCP_DEVICE_INFORMATION, DXGKMDT_OPM_GET_ADAPTER_BUS_TYPE, and DXGKMDT_OPM_GET_ACP_AND_CGMSA_SIGNALING requests.

The DXGKMDT_OPM_GET_ACTUAL_PROTECTION_LEVEL and DXGKMDT_OPM_GET_VIRTUAL_PROTECTION_LEVEL requests require data that identifies the protection type that the protection level is requested for. Therefore, these requests require that the first 4 bytes in the abParameters array contain the protection type.

Requirements

See also

DXGKMDT_OPM_RANDOM_NUMBER

DxgkDdiOPMGetCOPPCompatibleInformation