OPM_GET_INFO_PARAMETERS 结构 (ksopmapi.h)

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

语法

typedef struct _OPM_GET_INFO_PARAMETERS {
  OPM_OMAC          omac;
  OPM_RANDOM_NUMBER rnRandomNumber;
  GUID              guidInformation;
  ULONG             ulSequenceNumber;
  ULONG             cbParametersSize;
  BYTE              abParameters[OPM_GET_INFORMATION_PARAMETERS_SIZE];
} 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[OPM_GET_INFORMATION_PARAMETERS_SIZE]

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

注解

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

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

要求

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

另请参阅

OPM 结构

输出保护管理器