структура 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
Структура OPM_RANDOM_NUMBER , содержащая криптографически безопасное 128-разрядное случайное число.
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) |