struktur DXVA_COPPStatusInput (dxva.h)

Artikel
03/05/2024

Struktur DXVA_COPPStatusInput menjelaskan permintaan status pada sesi video yang dilindungi yang terkait dengan perangkat DIRECTX VA COPP.

Sintaks

typedef struct _DXVA_COPPStatusInput {
  GUID  rApp;
  GUID  guidStatusRequestID;
  ULONG dwSequence;
  ULONG cbSizeData;
  UCHAR StatusData[4056];
} DXVA_COPPStatusInput, *LPDXVA_COPPStatusInput;

Anggota

rApp

Menentukan angka acak 128-bit (digunakan sekali) yang dihasilkan oleh aplikasi pengirim. Angka acak ini juga dikembalikan oleh driver tampilan dengan data status di anggota rApp dari struktur DXVA_COPPStatusData . Driver tampilan juga menyediakan nomor acak ini ke generator kode autentikasi pesan (MAC) untuk menghasilkan MAC GUID.

guidStatusRequestID

Menentukan GUID yang mengidentifikasi permintaan status. GUID permintaan status berikut didukung:

DXVA_COPPQueryConnectorType

DEFINE_GUID(DXVA_COPPQueryConnectorType,
  0x81d0bfd5,0x6afe,0x48c2,0x99,0xc0,0x95,0xa0,0x8f,0x97,0xc5,0xda);

DXVA_COPPQueryProtectionType

DEFINE_GUID(DXVA_COPPQueryProtectionType,
  0x38f2a801,0x9a6c,0x48bb,0x91,0x07,0xb6,0x69,0x6e,0x6f,0x17,0x97);

DXVA_COPPQueryLocalProtectionLevel

DEFINE_GUID(DXVA_COPPQueryLocalProtectionLevel,
  0xb2075857,0x3eda,0x4d5d,0x88,0xdb,0x74,0x8f,0x8c,0x1a,0x05,0x49);

DXVA_COPPQueryGlobalProtectionLevel

DEFINE_GUID(DXVA_COPPQueryGlobalProtectionLevel,
  0x1957210a,0x7766,0x452a,0xb9,0x9a,0xd2,0x7a,0xed,0x54,0xf0,0x3a);

DXVA_COPPQueryDisplayData

DEFINE_GUID(DXVA_COPPQueryDisplayData,
  0xd7bf1ba3,0xad13,0x4f8e,0xaf,0x98,0x0d,0xcb,0x3c,0xa2,0x04,0xcc);

DXVA_COPPQueryHDCPKeyData

DEFINE_GUID(DXVA_COPPQueryHDCPKeyData,
  0xdb59d74,0xa992,0x492e,0xa0,0xbd,0xc2,0x3f,0xda,0x56,0x4e,0x0);

DXVA_COPPQueryBusData

DEFINE_GUID(DXVA_COPPQueryBusData,
  0xc6f4d673,0x6174,0x4184,0x8e,0x35,0xf6,0xdb,0x52, 0x0,0xbc,0xba);

DXVA_COPPQuerySignaling

DEFINE_GUID(DXVA_COPPQuerySignaling,
  0x6629a591,0x3b79,0x4cf3,0x92,0x4a,0x11,0xe8,0xe7,0x81,0x16,0x71);

dwSequence

Menentukan nomor urut. Agar fungsi COPPQueryStatus memproses permintaan status, nilai dalam dwSequence harus cocok dengan nomor urutan status awal acak 32-bit yang diteruskan dalam struktur DXVA_COPPSignature ke fungsi COPPSequenceStart .

cbSizeData

Menentukan ukuran, dalam byte, dari data permintaan status di StatusData.

StatusData[4056]

Menentukan array yang berisi data yang menyertai permintaan status yang diidentifikasi oleh guidStatusRequestID.

Tidak diperlukan data untuk permintaan DXVA_COPPQueryConnectorType, DXVA_COPPQueryProtectionType, DXVA_COPPQueryDisplayData, DXVA_COPPQueryHDCPKeyData, DXVA_COPPQueryBusData, dan DXVA_COPPQuerySignaling.

Permintaan DXVA_COPPQueryLocalProtectionLevel dan DXVA_COPPQueryGlobalProtectionLevel memerlukan data yang mengidentifikasi jenis perlindungan yang tingkat perlindungannya diminta. Oleh karena itu, permintaan ini mengharuskan 4 byte pertama dalam array StatusData berisi jenis perlindungan.

Keterangan

Permintaan status diteruskan dalam parameter pInput dari fungsi COPPQueryStatus . Informasi status dikembalikan melalui parameter pOutputcoppQueryStatus. Struktur DXVA_COPPStatusOutput menjelaskan informasi status yang dikembalikan.

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)