DXGKMDT_OPM_CONFIGURE_PARAMETERS 结构 (d3dkmdt.h)

项目
08/07/2023

DXGKMDT_OPM_CONFIGURE_PARAMETERS 结构包含的参数用于在调用 DxgkDdiOPMConfigureProtectedOutput 函数时配置受保护的输出对象。

语法

typedef struct _DXGKMDT_OPM_CONFIGURE_PARAMETERS {
  DXGKMDT_OPM_OMAC omac;
  GUID             guidSetting;
  ULONG            ulSequenceNumber;
  ULONG            cbParametersSize;
  BYTE             abParameters[DXGKMDT_OPM_CONFIGURE_SETTING_DATA_SIZE];
} DXGKMDT_OPM_CONFIGURE_PARAMETERS, *PDXGKMDT_OPM_CONFIGURE_PARAMETERS;

成员

omac

包含单键密码块链接 (CBC) 模式消息身份验证代码 (OMAC) 的DXGKMDT_OPM_OMAC结构，以确保消息真实性。有关 OMAC 的详细信息，请参阅 OMAC-1 算法。 OPM 和 COPP 使用的 OMAC-1 参数包括：

E = AES (高级加密标准)

t = 128 位

K = 调用 DxgkDdiOPMSetSigningKeyAndSequenceNumbers 时显示微型端口驱动程序接收的 128 位密钥。

n = 128 位

有关 AES 的信息，请参阅 RSA 实验室网站。

guidSetting

用于配置受保护的输出对象的 GUID。 guidSetting 可以设置为以下 GUID 之一：

DXGKMDT_OPM_SET_PROTECTION_LEVEL
DXGKMDT_OPM_SET_ACP_AND_CGMSA_SIGNALING
DXGKMDT_OPM_SET_HDCP_SRM
DXGKMDT_OPM_SET_PROTECTION_LEVEL_ACCORDING_TO_CSS_DVD。在 Windows 7 及更高版本中受支持。

ulSequenceNumber

序列号。要使 DxgkDdiOPMConfigureProtectedOutput 函数处理配置请求， ulSequenceNumber 中的值必须与显示微型端口驱动程序存储的当前 4 字节序列号匹配。如果未检测到匹配项， DxgkDdiOPMConfigureProtectedOutput 将返回错误代码。如果检测到匹配项， DxgkDdiOPMConfigureProtectedOutput 将在返回之前递增存储的序列号。初始 4 字节序列号是 DxgkDdiOPMSetSigningKeyAndSequenceNumbers 函数的 EncryptedParameters 参数指向的 256 字节数组的一部分。

cbParametersSize

abParameters 成员指向的有效配置数据的大小（以字节为单位）。

abParameters[DXGKMDT_OPM_CONFIGURE_SETTING_DATA_SIZE]

一个 4056 字节数组，指定如何配置受保护的输出对象。

abParameters 参数将强制转换为包含配置信息的以下结构之一，具体取决于 dxgkDdiOPMConfigureProtectedOutput 的 Parameters 参数指向的 DXGKMDT_OPM_CONFIGURE_PARAMETERS 的 guidSetting 成员中指定的 GUID。

以下是配置信息的可能 GUID 和结构：

GUID	检索到的信息的结构
DXGKMDT_OPM_SET_PROTECTION_LEVEL或DXGKMDT_OPM_SET_PROTECTION_LEVEL_ACCORDING_TO_CSS_DVD	DXGKMDT_OPM_SET_PROTECTION_LEVEL_PARAMETERS
DXGKMDT_OPM_SET_ACP_AND_CGMSA_SIGNALING	DXGKMDT_OPM_SET_ACP_AND_CGMSA_SIGNALING_PARAMETERS
DXGKMDT_OPM_SET_HDCP_SRM	DXGKMDT_OPM_SET_HDCP_SRM_PARAMETERS