DXVA_COPPStatusData 構造体 (dxva.h)

[アーティクル]
03/08/2023

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

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

要件

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