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

Статья
08/07/2023

Структура 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 (включая Dxva.h)