Skip to content

Latest commit

 

History

History
124 lines (92 loc) · 5.84 KB

ns-d3dkmdt-_dxgkmdt_opm_copp_compatible_get_info_parameters.md

File metadata and controls

124 lines (92 loc) · 5.84 KB
UID title description old-location tech.root ms.date keywords ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames f1_keywords topic_type api_type api_location api_name
NS:d3dkmdt._DXGKMDT_OPM_COPP_COMPATIBLE_GET_INFO_PARAMETERS
_DXGKMDT_OPM_COPP_COMPATIBLE_GET_INFO_PARAMETERS (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.
display\dxgkmdt_opm_copp_compatible_get_info_parameters.htm
display
05/10/2018
DXGKMDT_OPM_COPP_COMPATIBLE_GET_INFO_PARAMETERS structure
*PDXGKMDT_OPM_COPP_COMPATIBLE_GET_INFO_PARAMETERS, DXGKMDT_OPM_COPP_COMPATIBLE_GET_INFO_PARAMETERS, DXGKMDT_OPM_COPP_COMPATIBLE_GET_INFO_PARAMETERS structure [Display Devices], DmStructs_2e356de0-a1ca-4f75-a3f2-c72be3bdf87f.xml, PDXGKMDT_OPM_COPP_COMPATIBLE_GET_INFO_PARAMETERS, PDXGKMDT_OPM_COPP_COMPATIBLE_GET_INFO_PARAMETERS structure pointer [Display Devices], _DXGKMDT_OPM_COPP_COMPATIBLE_GET_INFO_PARAMETERS, d3dkmdt/DXGKMDT_OPM_COPP_COMPATIBLE_GET_INFO_PARAMETERS, d3dkmdt/PDXGKMDT_OPM_COPP_COMPATIBLE_GET_INFO_PARAMETERS, display.dxgkmdt_opm_copp_compatible_get_info_parameters
d3dkmdt.h
Windows
Available in Windows Vista and later versions of the Windows operating systems.
Windows
DXGKMDT_OPM_COPP_COMPATIBLE_GET_INFO_PARAMETERS, *PDXGKMDT_OPM_COPP_COMPATIBLE_GET_INFO_PARAMETERS
_DXGKMDT_OPM_COPP_COMPATIBLE_GET_INFO_PARAMETERS
d3dkmdt/_DXGKMDT_OPM_COPP_COMPATIBLE_GET_INFO_PARAMETERS
PDXGKMDT_OPM_COPP_COMPATIBLE_GET_INFO_PARAMETERS
d3dkmdt/PDXGKMDT_OPM_COPP_COMPATIBLE_GET_INFO_PARAMETERS
DXGKMDT_OPM_COPP_COMPATIBLE_GET_INFO_PARAMETERS
d3dkmdt/DXGKMDT_OPM_COPP_COMPATIBLE_GET_INFO_PARAMETERS
APIRef
kbSyntax
HeaderDef
d3dkmdt.h
_DXGKMDT_OPM_COPP_COMPATIBLE_GET_INFO_PARAMETERS
PDXGKMDT_OPM_COPP_COMPATIBLE_GET_INFO_PARAMETERS
DXGKMDT_OPM_COPP_COMPATIBLE_GET_INFO_PARAMETERS

_DXGKMDT_OPM_COPP_COMPATIBLE_GET_INFO_PARAMETERS structure

-description

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.

-struct-fields

-field 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.

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

-field 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.

-field cbParametersSize

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

-field abParameters

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.

-see-also

DXGKMDT_OPM_RANDOM_NUMBER

DxgkDdiOPMGetCOPPCompatibleInformation