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 结构

输出保护管理器