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
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista |
| Header | d3dkmdt.h |