DXVA_COPPStatusData構造体 (dxva.h)

[アーティクル]
02/06/2025

DXVA_COPPStatusData構造体には、DirectX VA COPP デバイスに関連付けられている保護されたビデオセッションのクエリから返される状態情報が含まれています。

構文

typedef struct _DXVA_COPPStatusData {
  GUID  rApp;
  ULONG dwFlags;
  ULONG dwData;
  ULONG ExtendedInfoValidMask;
  ULONG ExtendedInfoData;
} DXVA_COPPStatusData;

メンバーズ

rApp

1 回使用される 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

COPP デバイスに関連付けられている物理コネクタで使用可能な保護メカニズムの種類を示す、次の値の有効な ORed の組み合わせを返します。

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

物理コネクタの現在設定されている保護レベルを返します。返されるレベルの値は、ドライバーが保護レベルを適用するように指示された方法に関係なく、コネクタを通じて現在適用されている保護レベルを反映する必要があります。たとえば、IAMCertifiedOutputProtection インターフェイスではなく、Win32 ChangeDisplaySettingsEx 関数を使用して ACP を有効にした場合、コネクタの COPPQueryStatus 関数の呼び出しによって返されたグローバル保護レベルは、IAMCertifiedOutputProtection インターフェイスを介して ACP が有効になっていない場合でも、ACP が有効になっていることを示す必要があります。

保護レベルの値は、DXVA_COPPStatusInput 構造体の StatusData メンバーで指定された保護の種類によって異なります。考えられる保護レベルについては、DXVA_COPPSetProtectionLevelCmdData 構造体の ProtLevel メンバーを参照してください。

DXVA_COPPQueryBusData

COPP デバイスに関連付けられているグラフィックスハードウェアによって使用されるバスの種類を識別する COPP_BusType 列挙型から、次のいずれかの値を返します。

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 メンバーの状態情報を返す必要があります。

必要条件

要件	価値
サポートされる最小クライアント	この構造は、WINDOWS Server 2003 SP1 以降、Windows XP SP2 以降にのみ適用されます。
ヘッダー	dxva.h (Dxva.h を含む)

次の方法で共有