Справочник по запросам COPP
[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует использовать в новом коде MediaPlayer, IMFMediaEngine и аудио/видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, в котором используются устаревшие API, чтобы по возможности использовать новые API.]
В этом разделе описываются запросы состояния, поддерживаемые протоколом COPP. Для каждого запроса указывается GUID, определяющий запрос, а также входные данные и возвращаемые данные.
Запрос | GUID |
---|---|
Данные шины | DXVA_COPPQueryBusData |
Тип соединителя | DXVA_COPPQueryConnectorType |
Отображение данных | DXVA_COPPQueryDisplayData |
Данные ключа HDCP | DXVA_COPPQueryHDCPKeyData |
Уровень глобальной защиты | DXVA_COPPQueryGlobalProtectionLevel |
Уровень локальной защиты | DXVA_COPPQueryLocalProtectionLevel |
Тип защиты | DXVA_COPPQueryProtectionType |
Сигнальный NaN | DXVA_COPPQuerySignaling |
Запрос данных шины
Возвращает тип шины ввода-вывода, используемой графическим адаптером.
- GUID: DXVA_COPPQueryBusData
- Входные данные: нет.
- Возврат данных. Возвращает структуру DXVA_COPPStatusData . Тип шины возвращается в элементе dwData в виде флага из перечисления COPP_BusType .
Запрос типа соединителя
Возвращает тип физического соединителя.
- GUID: DXVA_COPPQueryConnectorType
- Входные данные: нет.
- Возврат данных. Возвращает структуру DXVA_COPPStatusData . Тип соединителя возвращается в элементе dwData в виде флага из перечисления COPP_ConnectorType .
Запрос на отображение данных
Возвращает описание видеосигнала, передаваемого через соединитель.
Видеосигнал, передаваемый через соединитель, не обязательно имеет тот же формат, что и режим отображения рабочего стола. Например, режим отображения рабочего стола может быть 1024 x 768 пикселей с частотой 85 Гц, а соединитель может быть соединителем S-Video, который передает видеосигнал с частотой 720 x 480 пикселей с чередованием 60/1,01 Гц. В этом случае драйвер будет возвращать разрешение сигнала S-Video, а не разрешение рабочего стола.
- GUID: DXVA_COPPQueryDisplayData
- Входные данные: нет.
- Возврат данных. Возвращает структуру DXVA_COPPStatusDisplayData .
Запрос данных ключа HDCP
Возвращает вектор выбора ключа HDCP устройства (B-KSV).
KSV — это идентификатор, предоставленный изготовителю устройства и используемый в процессе проверки подлинности и настройки HDCP. Приложение должно проверка это значение в списке отозванных KSV. Механизм получения списка отзыва KSV находится вне область протокола COPP. Дополнительные сведения см. в спецификации HDCP.
Этот запрос также определяет, является ли подключенное устройство HDCP монитором или повторителем HDCP. Приложение не должно воспроизводить защищенное содержимое, если устройство HDCP является повторителем HDCP, так как оно не поддерживается COPP.
- GUID: DXVA_COPPQueryHDCPKeyData
- Входные данные: нет.
- Возврат данных. Возвращает структуру DXVA_COPPStatusHDCPKeyData .
Глобальный запрос уровня защиты
Возвращает глобальный уровень защиты для указанного механизма защиты.
Глобальный уровень защиты — это уровень защиты, который в настоящее время применяется к соединителю независимо от того, как графический драйвер получил указание применить защиту. Например, приложение может задать уровень защиты ACP, вызвав функцию ChangeDisplaySettingsEx . В этом случае глобальный уровень защиты будет отражать этот параметр, даже если он не был запрошен через COPP.
GUID: DXVA_COPPQueryGlobalProtectionLevel
Входные данные: механизм защиты для запроса, указанный в виде 32-разрядного целого числа. См. раздел Флаги типов защиты COPP.
Возврат данных. Возвращает структуру DXVA_COPPStatusData . Текущий уровень защиты возвращается в элементе dwData . Значение этого значения зависит от запрашиваемого механизма защиты. Для каждого механизма защиты значение члена dwData является флагом из другого перечисления, как показано в следующей таблице.
Механизм защиты Перечисление ACP COPP_ACP_Protection_Level CGMS-A COPP_CGMSA_Protection_Level HDCP COPP_HDCP_Protection_Level
Запрос уровня локальной защиты
Возвращает локальный уровень защиты для указанного механизма защиты.
Локальный уровень защиты — это уровень защиты, запрошенный в рамках текущего сеанса COPP. Драйвер может установить более высокий уровень защиты.
GUID: DXVA_COPPQueryLocalProtectionLevel
Входные данные: механизм защиты для запроса в виде 32-разрядного целого числа. См. раздел Флаги типов защиты COPP.
Возврат данных. Возвращает структуру DXVA_COPPStatusData . Текущий уровень защиты возвращается в элементе dwData . Значение этого значения зависит от запрашиваемого механизма защиты. Для каждого механизма защиты значение члена dwData является флагом из другого перечисления, как показано в следующей таблице.
Механизм защиты Перечисление ACP COPP_ACP_Protection_Level CGMS-A COPP_CGMSA_Protection_Level HDCP COPP_HDCP_Protection_Level
Запрос типа защиты
Возвращает механизмы защиты, доступные для соединителя.
- GUID: DXVA_COPPQueryProtectionType
- Входные данные: нет.
- Возврат данных. Возвращает структуру DXVA_COPPStatusData . Механизмы защиты возвращаются в элементе dwData в виде сочетания нулевых или нескольких флагов. См. раздел Флаги типов защиты COPP. Если доступно несколько механизмов защиты, флаги объединяются с побитовой ИЛИ.
Запрос сигналов
Возвращает список всех стандартов защиты, поддерживаемых драйвером, стандарта, который в настоящее время активен, а также текущих пропорций или других сигнальных данных.
- GUID: DXVA_COPPQuerySignaling
- Входные данные: нет.
- Возврат данных. Возвращает структуру DXVA_COPPStatusSignalingCmdData .
Связанные темы