Share via

структура 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.

Комментарии

Инициализируйте эту структуру следующим образом:

  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

Диспетчер защиты выходных данных