COPP 查詢參考
[與此頁面相關的功能 DirectShow是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ，而不是 DirectShow。 Microsoft 建議使用舊版 API 的現有程式碼盡可能重寫為使用新的 API。
本節說明認證輸出保護通訊協定所支援的狀態查詢， (COPP) 。 針對每個查詢，會列出定義查詢的 GUID，以及輸入資料並傳回資料。
| 查詢 | GUID |
|---|---|
| 匯流排資料 | DXVA_COPPQueryBusData |
| 連接器類型 | DXVA_COPPQueryConnectorType |
| 顯示資料 | DXVA_COPPQueryDisplayData |
| HDCP 金鑰資料 | DXVA_COPPQueryHDCPKeyData |
| 全域保護等級 | DXVA_COPPQueryGlobalProtectionLevel |
| 本機保護層級 | DXVA_COPPQueryLocalProtectionLevel |
| 保護類型 | DXVA_COPPQueryProtectionType |
| Signaling | DXVA_COPPQuerySignaling |
匯流排資料查詢
傳回圖形配接器所使用的 I/O 匯流排類型。
- GUID：DXVA_COPPQueryBusData
- 輸入資料：無。
- 傳回資料：傳回 DXVA_COPPStatusData 結構。 匯流排類型會在 dwData 成員中傳回，做為 來自COPP_BusType 列舉的旗標。
連接器類型查詢
傳回實體連接器類型。
- GUID：DXVA_COPPQueryConnectorType
- 輸入資料：無。
- 傳回資料：傳回 DXVA_COPPStatusData 結構。 連接器類型會在 dwData 成員中傳回為 來自COPP_ConnectorType 列舉的旗標。
顯示資料查詢
傳回透過連接器傳輸的視訊訊號描述。
透過連接器傳輸的視訊訊訊不一定與桌面顯示模式的格式相同。 例如，桌面顯示器模式可能是 1024x768 圖元在 85 Hz，而連接器可能是以 720x480 圖元傳輸視訊訊號的 S-Video 連接器，60/1.01 Hz 交錯。 在此情況下，驅動程式會傳回 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 結構。
全域保護層級查詢
傳回指定保護機制的全域保護層級。
全域保護層級是目前在連接器上套用的保護層級，不論圖形驅動程式如何指示套用保護。 例如，應用程式可以藉由呼叫 ChangeDisplaySettingsEx 函式來設定 ACP 保護等級。 在此情況下，全域保護層級會反映此設定，即使未透過 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 保護類型旗標。 如果有一個以上的保護機制可用，旗標會與位 OR合併。
發出訊號查詢
傳回驅動程式支援的所有保護標準、目前作用中的標準，以及目前的外觀比例或其他訊號資料的清單。
- GUID：DXVA_COPPQuerySignaling
- 輸入資料：無。
- 傳回資料：傳回 DXVA_COPPStatusSignalingCmdData 結構。
相關主題