структура DXVA_COPPStatusData (dxva.h)

Статья
02/06/2025

Структура DXVA_COPPStatusData содержит сведения о состоянии, возвращаемые из запроса на защищенном видеосеансе, связанном с устройством DIRECTX VA COPP.

Синтаксис

typedef struct _DXVA_COPPStatusData {
  GUID  rApp;
  ULONG dwFlags;
  ULONG dwData;
  ULONG ExtendedInfoValidMask;
  ULONG ExtendedInfoData;
} DXVA_COPPStatusData;

Члены

rApp

Указывает 128-разрядное случайное число, которое используется один раз. Это случайное число создается запрашивающим приложением и предоставляется драйверу отображения в элементе rApp структуры DXVA_COPPStatusInput.

dwFlags

Указывает дополнительные сведения о состоянии, которые могут быть релевантны для вызывающего приложения. Драйвер отображения должен задать dwFlags значение COPP_StatusNormal (0x00) из типа перечисления COPP_StatusFlags или допустимое сочетание ORed следующего COPP_StatusFlags:

COPP_LinkLost (0x01)
COPP_RenegotiationRequired (0x02)

dwData

Указывает 32-разрядные данные состояния, возвращаемые из одного из следующих запросов, переданных в параметре pInput функции COPPQueryStatus.

DXVA_COPPQueryProtectionType

Возвращает допустимое сочетание ORed следующих значений, указывающих доступные типы механизмов защиты на физическом соединителе, связанном с устройством COPP:

COPP_ProtectionType_Unknown (0x80000000)
COPP_ProtectionType_None (0x00)
COPP_ProtectionType_HDCP (0x01)
COPP_ProtectionType_ACP (0x02)
COPP_ProtectionType_CGMSA (0x04)

DXVA_COPPQueryConnectorType

Возвращает одно из следующих значений из типа перечисления COPP_ConnectorType, определяющего тип физического соединителя, который использует видеосеанс:

COPP_ConnectorType_Unknown (-1)
COPP_ConnectorType_VGA (0)
COPP_ConnectorType_SVideo (1)
COPP_ConnectorType_CompositeVideo (2)
COPP_ConnectorType_ComponentVideo (3)
COPP_ConnectorType_DVI (4)
COPP_ConnectorType_HDMI (5)
COPP_ConnectorType_LVDS (6)
COPP_ConnectorType_TMDS (7)
COPP_ConnectorType_D_JPN (8)

Значение COPP_ConnectorType_Internal (0x80000000) объединяется только с одним из предыдущих значений типа соединителя, чтобы указать, что соединение между графическим адаптером и монитором отображения является постоянным и недоступен из-за пределов корпуса, отличного от пользователя.

DXVA_COPPQueryLocalProtectionLevel

Возвращает текущий уровень защиты для видеосеанса. Значение уровня защиты зависит от типа защиты, указанного в элементе StatusData структуры DXVA_COPPStatusInput. Возможные уровни защиты см. в разделе ProtLevel члена структуры DXVA_COPPSetProtectionLevelCmdData.

DXVA_COPPQueryGlobalProtectionLevel

Возвращает текущий уровень защиты для физического соединителя. Возвращаемое значение уровня должно отражать уровень защиты, применяемый в данный момент через соединитель, независимо от того, как драйвер был указан для применения уровня защиты. Например, если ACP был включен с помощью функции Win32 ChangeDisplaySettingsEx, а не через интерфейс IAMCertifiedOutputProtection, Глобальный уровень защиты, возвращенный через вызов функции COPPQueryStatus соединителя, должен указывать, что ACP включен, даже если ACP не включен через интерфейс IAMCertifiedOutputProtection.

Значение уровня защиты зависит от типа защиты, указанного в элементе StatusData структуры DXVA_COPPStatusInput. Возможные уровни защиты см. в разделе ProtLevel члена структуры DXVA_COPPSetProtectionLevelCmdData.

DXVA_COPPQueryBusData

Возвращает одно из следующих значений из типа перечисления COPP_BusType, определяющего тип шины, используемой графическим оборудованием, связанным с устройством COPP:

COPP_BusType_Unknown (0)
COPP_BusType_PCI (1)
COPP_BusType_PCIX (2)
COPP_BusType_PCIExpress (3)
COPP_BusType_AGP (4)

Значение COPP_BusType_Integrated (0x80000000) можно сочетать только с одним из предыдущих значений типа шины, если ни один из сигналов интерфейса команды и состояния между графическим адаптером и другими подсистемами доступен на шине расширения, которая использует общедоступную спецификацию и стандартный тип соединителя. Автобусы памяти исключены из этого определения.

ExtendedInfoValidMask

Указывает значение, указывающее допустимые битовые поля в следующем элементе ExtendedInfoData.

ExtendedInfoData

Указывает дополнительные 32-разрядные данные для состояния. В настоящее время не используется.

Замечания

Драйвер отображения возвращает сведения о состоянии через параметр pOutputCOPPQueryStatus. Структура DXVA_COPPStatusOutput описывает возвращаемые сведения о состоянии. Драйвер отображения должен привести сведения о состоянии к указателю на структуру DXVA_COPPStatusData и вернуть сведения о состоянии в COPPStatus члена DXVA_COPPStatusOutput.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Эта структура применяется только к Windows Server 2003 с пакетом обновления 1 (SP1) и более поздней версии, а Windows XP — с пакетом обновления 2 (SP2) и более поздней версии.
заголовка	dxva.h (include Dxva.h)