Поделиться через

Метод IAMCertifiedOutputProtection::SessionSequenceStart (strmif.h)

  • Статья

[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует, чтобы новый код использовал MediaPlayer, IMFMediaEngine и аудио- и видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, использующий устаревшие API, чтобы по возможности использовать новые API.]

Метод SessionSequenceStart инициирует сеанс COPP с графическим драйвером.

Синтаксис

HRESULT SessionSequenceStart(
  [in] AMCOPPSignature *pSig
);

Параметры

[in] pSig

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

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

Возвращает значение HRESULT . Ниже приведены возможные значения.

Код возврата Описание
S_OK
 Успешно.
E_UNEXPECTED
 Недопустимое состояние. Возможно, приложение передавало непредвиденные данные или вызывало методы IAMCertifiedOutputProtection в неправильном порядке.
VFW_E_NO_COPP_HW
 Устройство отображения не поддерживает COPP; или виртуальная машина еще не подключена к устройству отображения.

Комментарии

Чтобы заполнить структуру для параметра pSig , сначала сцепьте следующие числа:

  • 128-разрядное число, возвращаемое в параметре pRandom метода IAMCertifiedOutputProtection::KeyExchange .
  • Ключ сеанса целостности данных. Это значение представляет собой 128-битовое случайное число, созданное приложением.
  • Начальный порядковый номер для запросов состояния COPP. Это значение представляет собой 32-разрядное случайное число, созданное приложением.
  • Начальный порядковый номер для команд COPP. Это значение представляет собой 32-разрядное случайное число, созданное приложением.
Затем зашифруйте этот номер с помощью 2048-разрядного шифрования RSA, используя открытый ключ шифрования графического драйвера. Открытый ключ шифрования содержится в сертификате, возвращенном в параметре VarLenCertGH метода KeyExchange .

Требования

Требование Значение
Минимальная версия клиента Windows XP с пакетом обновления 2 (SP2) [только классические приложения]
Минимальная версия сервера Windows Server 2003 R2 [только классические приложения]
Целевая платформа Windows
Header strmif.h (включая Dshow.h)
Библиотека Strmiids.lib

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

Интерфейс IAMCertifiedOutputProtection

Использование сертифицированного протокола защиты выходных данных (COPP)