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