DXVA_COPPStatusData 結構 (dxva.h)

發行項
02/26/2024

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

指定從 COPPQueryStatus 函式 pInput 參數中傳遞的下列其中一個要求傳回的 32 位狀態數據。

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，即使 ACP 未透過 IAMCertifiedOutputProtection 介面啟用也一樣。

保護層級值取決於 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，以及 Windows XP 與 SP2 和更新版本。
標頭	dxva.h (包含 Dxva.h)