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 位随机数。此随机数由请求应用程序生成，并提供给DXVA_COPPStatusInput结构的 rApp 成员中的显示驱动程序。

dwFlags

指定可能与调用应用程序相关的其他状态信息。显示驱动程序应将 dwFlags 设置为COPP_StatusFlags枚举类型的 COPP_StatusNormal (0x00) 值，或设置为以下COPP_StatusFlags的有效 ORed 组合：

COPP_LinkLost (0x01)
COPP_RenegotiationRequired (0x02)

dwData

指定从以下请求之一返回的 32 位状态数据，这些请求在 COPPQueryStatus 函数的 pInput 参数中传递。

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

返回视频会话当前设置的保护级别。保护级别值取决于DXVA_COPPStatusInput结构的 StatusData 成员中指定的保护类型。有关可能的保护级别，请参阅 DXVA_COPPSetProtectionLevelCmdData 结构的 ProtLevel 成员。

DXVA_COPPQueryGlobalProtectionLevel

返回物理连接器当前设置的保护级别。无论驱动程序如何指示应用保护级别，返回的级别值都必须反映当前通过连接器应用的保护级别。例如，如果 ACP 是通过 Win32 ChangeDisplaySettingsEx 函数而不是通过 IAMCertifiedOutputProtection 接口启用的，则通过调用连接器的 COPPQueryStatus 函数返回的全局保护级别必须指示已启用 ACP，即使未通过 IAMCertifiedOutputProtection 接口启用 ACP。

保护级别值取决于DXVA_COPPStatusInput结构的 StatusData 成员中指定的保护类型。有关可能的保护级别，请参阅 DXVA_COPPSetProtectionLevelCmdData 结构的 ProtLevel 成员。

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 位数据。当前未使用。

注解

显示驱动程序通过 COPPQueryStatus 的 pOutput 参数返回状态信息。 DXVA_COPPStatusOutput结构描述返回的状态信息。显示驱动程序应将状态信息强制转换为指向DXVA_COPPStatusData结构的指针，并在 DXVA_COPPStatusOutput 的 COPPStatus 成员中返回状态信息。

要求

要求	值
最低受支持的客户端	此结构仅适用于带 SP1 及更高版本的 Windows Server 2003 以及 SP2 及更高版本的 Windows XP。
标头	dxva.h (包括 Dxva.h)