Метод IOPMVideoOutput::FinishInitialization (opmapi.h)

  • Статья

Завершает последовательность инициализации для сеанса диспетчера защиты вывода (OPM).

Синтаксис

HRESULT FinishInitialization(
  [in] const OPM_ENCRYPTED_INITIALIZATION_PARAMETERS *pParameters
);

Параметры

[in] pParameters

Указатель на структуру OPM_ENCRYPTED_INITIALIZATION_PARAMETERS . Инициализируйте эту структуру, как описано в сеансе примечаний.

Возвращаемое значение

Возвращает HRESULT. Возможные значения включают , но не ограничиваются ими, приведенные в следующей таблице.

Код возврата Описание
S_OK
 Метод выполнен успешно.
ERROR_GRAPHICS_OPM_DRIVER_INTERNAL_ERROR
 Произошла непредвиденная ошибка драйвера дисплея.
ERROR_GRAPHICS_OPM_INVALID_ENCRYPTED_PARAMETERS
 Зашифрованные параметры в pParameters неверны.

Комментарии

Этот метод эквивалентен методу IAMCertifiedOutputProtection::SessionSequenceStart в приложении Certified Output Protection Protocol (COPP).

Параметр pParameters указывает на структуру OPM_ENCRYPTED_INITIALIZATION_PARAMETERS , содержащую 256-байтный массив. Перед вызовом метода подготовьте этот массив следующим образом. Сначала сцепляйте следующие числа:

  • 128-разрядное число, возвращаемое в параметре prnRandomNumber метода IOPMVideoOutput::StartInitialization .
  • Ключ подписывания AES. Это значение представляет собой 128-битовое случайное число, созданное приложением.
  • Начальный порядковый номер для запросов состояния OPM. Это значение представляет собой 32-разрядное случайное число, созданное приложением.
  • Начальный порядковый номер для команд OPM. Это значение представляет собой 32-разрядное случайное число, созданное приложением.
Зашифруйте этот номер с помощью RAEAS-OAEP, используя открытый ключ шифрования драйвера дисплея. Открытый ключ шифрования содержится в сертификате, возвращенном в параметре ppbCertificate метода StartInitialization .

Приложение должно использовать криптографически защищенные случайные числа. Рекомендуется использовать функцию CryptGenRandom , хотя и не обязательную.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header opmapi.h

См. также раздел

IOPMVideoOutput

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