COPP 查詢參考
[與此頁面相關聯的功能，DirectShow是舊版功能。 它已被 MediaPlayer、imfMediaEngine 取代，並在媒體基金會 音訊/視訊擷取。 這些功能已針對 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 |
| 信號 | DXVA_COPPQuerySignaling |
總線數據查詢
傳回圖形配接器所使用的 I/O 總線類型。
- GUID： DXVA_COPPQueryBusData
- 輸入數據：無。
- 傳回數據：傳回 DXVA_COPPStatusData 結構。 總線類型會在 dwData 成員中傳回，做為來自 COPP_BusType 列舉的旗標。
連接器類型查詢
傳回實體連接器類型。
- GUID： DXVA_COPPQueryConnectorType
- 輸入數據：無。
- 傳回數據：傳回 DXVA_COPPStatusData 結構。 連接器類型會在 dwData 成員中傳回，做為來自 COPP_ConnectorType 列舉的旗標。
顯示數據查詢
傳回透過連接器傳輸的視訊訊描述。
透過連接器傳輸的視訊訊不一定具有與桌面顯示模式相同的格式。 例如，桌面顯示模式在 85 Hz 上可能是 1024x768 圖元，而連接器可能是 S-Video 連接器，以 720x480 像素、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 結構。
相關主題