struktur DXVA_COPPStatusData (dxva.h)

Artikel
03/08/2023

Struktur DXVA_COPPStatusData berisi informasi status yang dikembalikan dari kueri pada sesi video yang dilindungi yang terkait dengan perangkat COPP Va DirectX.

Sintaks

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

Anggota

rApp

Menentukan angka acak 128-bit yang digunakan sekali. Angka acak ini dihasilkan oleh aplikasi yang meminta dan diberikan ke driver tampilan di anggota rApp dari struktur DXVA_COPPStatusInput .

dwFlags

Menentukan informasi status tambahan yang mungkin relevan dengan aplikasi panggilan. Driver tampilan harus mengatur dwFlags ke nilai COPP_StatusNormal (0x00) dari jenis enumerasi COPP_StatusFlags atau ke kombinasi ORed yang valid dari COPP_StatusFlags berikut:

COPP_LinkLost (0x01)
COPP_RenegotiationRequired (0x02)

dwData

Menentukan data status 32-bit yang dikembalikan dari salah satu permintaan berikut yang diteruskan dalam parameter pInput fungsi COPPQueryStatus .

DXVA_COPPQueryProtectionType

Mengembalikan kombinasi ORed yang valid dari nilai berikut yang menunjukkan jenis mekanisme perlindungan yang tersedia pada konektor fisik yang terkait dengan perangkat COPP:

COPP_ProtectionType_Unknown (0x80000000)
COPP_ProtectionType_None (0x00)
COPP_ProtectionType_HDCP (0x01)
COPP_ProtectionType_ACP (0x02)
COPP_ProtectionType_CGMSA (0x04)

DXVA_COPPQueryConnectorType

Mengembalikan salah satu nilai berikut dari jenis enumerasi COPP_ConnectorType yang mengidentifikasi jenis konektor fisik yang digunakan sesi video:

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)

Nilai COPP_ConnectorType_Internal (0x80000000) hanya dikombinasikan dengan salah satu nilai jenis konektor sebelumnya untuk menunjukkan bahwa koneksi antara adaptor grafis dan monitor tampilan bersifat permanen dan tidak dapat diakses dari luar penutup yang tidak dapat dilayankan pengguna.

DXVA_COPPQueryLocalProtectionLevel

Mengembalikan tingkat perlindungan yang saat ini ditetapkan untuk sesi video. Nilai tingkat perlindungan tergantung pada jenis perlindungan yang ditentukan dalam anggota StatusData dari struktur DXVA_COPPStatusInput . Untuk kemungkinan tingkat perlindungan, lihat anggota ProtLevel dari struktur DXVA_COPPSetProtectionLevelCmdData .

DXVA_COPPQueryGlobalProtectionLevel

Mengembalikan tingkat perlindungan yang saat ini ditetapkan untuk konektor fisik. Nilai tingkat yang dikembalikan harus mencerminkan tingkat perlindungan yang saat ini diterapkan melalui konektor, terlepas dari bagaimana driver diinstruksikan untuk menerapkan tingkat perlindungan. Misalnya, jika ACP diaktifkan melalui fungsi Win32 ChangeDisplaySettingsEx dan bukan melalui antarmuka IAMCertifiedOutputProtection , tingkat perlindungan global yang dikembalikan melalui panggilan ke fungsi COPPQueryStatus untuk konektor harus menunjukkan bahwa ACP diaktifkan, meskipun ACP tidak diaktifkan melalui antarmuka IAMCertifiedOutputProtection .

Nilai tingkat perlindungan tergantung pada jenis perlindungan yang ditentukan dalam anggota StatusData dari struktur DXVA_COPPStatusInput . Untuk kemungkinan tingkat perlindungan, lihat anggota ProtLevel dari struktur DXVA_COPPSetProtectionLevelCmdData .

DXVA_COPPQueryBusData

Mengembalikan salah satu nilai berikut dari jenis enumerasi COPP_BusType yang mengidentifikasi jenis bus yang digunakan oleh perangkat keras grafis yang terkait dengan perangkat COPP:

COPP_BusType_Unknown (0)
COPP_BusType_PCI (1)
COPP_BusType_PCIX (2)
COPP_BusType_PCIExpress (3)
COPP_BusType_AGP (4)

Nilai COPP_BusType_Integrated (0x80000000) hanya dapat dikombinasikan dengan salah satu nilai jenis bus sebelumnya ketika tidak ada sinyal antarmuka perintah dan status antara adaptor grafis dan subsistem lainnya yang tersedia pada bus ekspansi yang menggunakan spesifikasi yang tersedia untuk umum dan jenis konektor standar. Bus memori dikecualikan dari definisi ini.

ExtendedInfoValidMask

Menentukan nilai yang menunjukkan bitfields yang valid di anggota ExtendedInfoData berikut.

ExtendedInfoData

Menentukan data 32-bit tambahan untuk status tersebut. Saat ini tidak digunakan.

Keterangan

Driver tampilan mengembalikan informasi status melalui parameter pOutput dari COPPQueryStatus. Struktur DXVA_COPPStatusOutput menjelaskan informasi status yang dikembalikan. Driver tampilan harus mentransmisikan informasi status ke penunjuk ke struktur DXVA_COPPStatusData dan mengembalikan informasi status di anggota COPPStatus dari DXVA_COPPStatusOutput.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Struktur ini hanya berlaku untuk Windows Server 2003 dengan SP1 dan yang lebih baru, dan Windows XP dengan SP2 dan yang lebih baru.
Header	dxva.h (termasuk Dxva.h)