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

  • Статья

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

Синтаксис

HRESULT StartInitialization(
  [out] OPM_RANDOM_NUMBER *prnRandomNumber,
  [out] BYTE              **ppbCertificate,
  [out] ULONG             *pulCertificateLength
);

Параметры

[out] prnRandomNumber

Указатель на структуру OPM_RANDOM_NUMBER . Структура получает 128-битовое случайное число, созданное драйвером отображения. Это число необходимо для метода IOPMVideoOutput::FinishInitialization .

[out] ppbCertificate

Получает указатель на буфер, содержащий сертификат драйвера отображения. Метод выделяет память для буфера. Вызывающий объект должен освободить память, вызвав CoTaskMemFree.

[out] pulCertificateLength

Получает длину буфера, на который указывает ppbCertificate.

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

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

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

Метод возвращает цепочку сертификатов, содержащую 2048-разрядный открытый ключ RSA драйвера. Вызывающий объект должен проверить цепочку сертификатов, а затем вызвать IOPMVideoOutput::FinishInitialization , чтобы установить сеанс OPM.

Этот метод поддерживает как семантику OPM, так и семантику COPP. Семантика COPP поддерживается для обеспечения обратной совместимости; новые приложения должны использовать семантику OPM.

Семантика OPM

Метод возвращает цепочку сертификатов X.509. Цепочка сертификатов закодирована с помощью Distinguished Encoding Rules (DER) ASN.1.

Семантика COPP

Метод возвращает цепочку сертификатов COPP. Цепочка сертификатов возвращается в виде строки UTF-8. Буфер, возвращаемый в ppbCertificate , можно рассматривать как массив chars.

Требования

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

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

IOPMVideoOutput

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