opmapi.h) (OPM_GET_INFO_PARAMETERS 结构

包含 IOPMVideoOutput::GetInformation 方法的参数。

语法

typedef struct _OPM_GET_INFO_PARAMETERS {
  OPM_OMAC          omac;
  OPM_RANDOM_NUMBER rnRandomNumber;
  GUID              guidInformation;
  ULONG             ulSequenceNumber;
  ULONG             cbParametersSize;
  BYTE              abParameters[4056];
} OPM_GET_INFO_PARAMETERS;

成员

omac

一个 OPM_OMAC 结构,其中包含消息身份验证代码 (MAC) 结构其余部分的数据。

rnRandomNumber

包含加密安全 128 位随机数 的OPM_RANDOM_NUMBER 结构。

guidInformation

定义状态请求的 GUID。 有关详细信息,请参阅 OPM 状态请求

ulSequenceNumber

状态序列号。 应用程序必须保留状态请求的运行计数。 对于每个请求,将序列号递增 1。

首次调用 GetInformation 时,将 ulSequenceNumber 设置为起始状态序列号,该序列号在应用程序调用 IOPMVideoOutput::FinishInitialization 时指定。 在每次后续调用中,将 ulSequenceNumber 递增 1。

异常:如果状态请求失败,请不要递增序列号。 请重新对下一个状态请求使用相同的编号。

cbParametersSize

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

abParameters[4056]

状态请求的数据。 数据的含义取决于请求。 有关详细信息,请参阅 OPM 状态请求

注解

初始化此结构,如下所示:

  1. 生成加密安全的 128 位随机数,并将其复制到 rnRandomNumber 成员。 调用 GetInformation 后,请勿重复使用此号码。
  2. 填写其余结构成员( omac 成员除外)。
  3. 使用 OMAC 1 算法 (MAC) 计算在 omac 成员之后显示的数据块的消息身份验证代码, (不包括 omac 成员) 。
  4. 将 MAC 复制到 omac 成员。

要求

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

另请参阅

OPM 结构

输出保护管理器