OPM_CONFIGURE_PARAMETERS 结构 (opmapi.h)

  • 项目

包含 输出保护管理器 (OPM) 或认证输出保护管理器 (COPP) 命令。

语法

typedef struct _OPM_CONFIGURE_PARAMETERS {
  OPM_OMAC omac;
  GUID     guidSetting;
  ULONG    ulSequenceNumber;
  ULONG    cbParametersSize;
  BYTE     abParameters[4056];
} OPM_CONFIGURE_PARAMETERS;

成员

omac

OPM_MAC结构。 使用命令数据的消息身份验证代码 (MAC) 填充此结构。 使用基于 AES 的单键 CBC MAC (OMAC) 计算此值。

guidSetting

指定命令的 GUID。 有关详细信息，请参阅 OPM 命令。

ulSequenceNumber

命令序列号。 应用程序必须保留所发出的命令的运行计数。 对于每个命令，将序列号递增 1。

首次调用 IOPMVideoOutput：：Configure 时，将 ulSequenceNumber 设置为起始命令序列号，该序列号在应用程序调用 IOPMVideoOutput：：FinishInitialization 时指定。 在每次后续调用中，将 ulSequenceNumber 递增 1。

异常：如果 IOPMVideoOutput：：Configure 方法失败，请不要递增序列号。 请改用下一个命令的相同编号。

cbParametersSize

abParameters 成员中有效数据的字节数。

abParameters[4056]

命令的数据。 数据的含义取决于 命令。 有关详细信息，请参阅 OPM 命令。

注解

此结构的布局与认证输出保护协议 (COPP) 中使用的 AMCOPPCommand 结构相同。

按如下所示初始化此结构。

  1. 填写除 omac 成员之外的所有结构成员。
  2. 使用 OMAC 1 算法 (MAC) 计算在 omac 成员之后显示的数据块的消息身份验证代码， (不包括 omac 成员) 。
  3. 将 MAC 复制到 omac 成员。

要求

要求 值
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
标头 opmapi.h

另请参阅

IOPMVideoOutput：：Configure

OPM 结构

输出保护管理器