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 状态请求。
注解
初始化此结构,如下所示:
- 生成加密安全的 128 位随机数,并将其复制到 rnRandomNumber 成员。 调用 GetInformation 后,请勿重复使用此号码。
- 填写其余结构成员( omac 成员除外)。
- 使用 OMAC 1 算法 (MAC) 计算在 omac 成员之后显示的数据块的消息身份验证代码, (不包括 omac 成员) 。
- 将 MAC 复制到 omac 成员。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
标头 | opmapi.h (包括 Opmapi.h) |