COPP クエリ リファレンス
[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、および Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 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 構造体を返します。 バスの種類は、COPP_BusType列挙体からフラグとして dwData メンバーで返されます。
コネクタの種類のクエリ
物理コネクタの種類を返します。
- GUID: DXVA_COPPQueryConnectorType
- 入力データ: なし。
- データを返す: DXVA_COPPStatusData 構造体を返します。 コネクタの種類は、 dwData メンバーで 、COPP_ConnectorType 列挙体からフラグとして返されます。
データ クエリの表示
コネクタ経由で送信されるビデオ信号の説明を返します。
コネクタ経由で送信されるビデオ信号は、必ずしもデスクトップ表示モードと同じ形式であるとは限りません。 たとえば、デスクトップ表示モードは 85 Hz で 1024 x 768 ピクセル、コネクタは 720 x 480 ピクセル、60/1.01 Hz インターレースでビデオ信号を送信する S-Video コネクタです。 その場合、ドライバーはデスクトップの解像度ではなく、S-Video 信号の解像度を返します。
- GUID: DXVA_COPPQueryDisplayData
- 入力データ: なし。
- データを返す: DXVA_COPPStatusDisplayData 構造体を返します。
HDCP キー データ クエリ
デバイスの HDCP キー選択ベクトル (B-KSV) を返します。
KSV はデバイスの製造元に提供される識別子であり、HDCP 認証とセットアップ プロセスで使用されます。 アプリケーションでは、取り消された CSV の一覧に対してこの値をチェックする必要があります。 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 構造体を返します。 保護メカニズムは、0 個以上のフラグの組み合わせとして dwData メンバーで返されます。 「COPP 保護の種類のフラグ」を参照してください。 複数の保護メカニズムが使用可能な場合、フラグはビットごとの OR と組み合わされます。
シグナルクエリ
ドライバーでサポートされているすべての保護標準、現在アクティブな標準、および現在の縦横比またはその他のシグナリング データの一覧を返します。
- GUID: DXVA_COPPQuerySignaling
- 入力データ: なし。
- データを返す: DXVA_COPPStatusSignalingCmdData 構造体を返します。
関連トピック