struktur DXGKMDT_OPM_CONFIGURE_PARAMETERS (d3dkmdt.h)

Artikel
03/08/2023

Struktur DXGKMDT_OPM_CONFIGURE_PARAMETERS berisi parameter yang digunakan untuk mengonfigurasi objek output yang dilindungi dalam panggilan ke fungsi DxgkDdiOPMConfigureProtectedOutput .

Sintaks

typedef struct _DXGKMDT_OPM_CONFIGURE_PARAMETERS {
  DXGKMDT_OPM_OMAC omac;
  GUID             guidSetting;
  ULONG            ulSequenceNumber;
  ULONG            cbParametersSize;
  BYTE             abParameters[DXGKMDT_OPM_CONFIGURE_SETTING_DATA_SIZE];
} DXGKMDT_OPM_CONFIGURE_PARAMETERS, *PDXGKMDT_OPM_CONFIGURE_PARAMETERS;

Anggota

omac

Struktur DXGKMDT_OPM_OMAC yang berisi kode autentikasi pesan mode One-key Cipher Block Chaining (CBC) (OMAC) untuk keaslian pesan. Untuk informasi selengkapnya tentang OMAC, lihat algoritma OMAC-1. Parameter OMAC-1 yang digunakan OPM dan COPP adalah:

E = AES (Standar Enkripsi Lanjutan)

t = 128 bit

K = Kunci 128-bit yang diterima driver miniport tampilan saat DxgkDdiOPMSetSigningKeyAndSequenceNumbers dipanggil.

n = 128 bit

Untuk informasi tentang AES, lihat situs web Laboratorium RSA .

guidSetting

GUID yang digunakan untuk mengonfigurasi objek output yang dilindungi. guidSetting dapat diatur ke salah satu GUID berikut:

DXGKMDT_OPM_SET_PROTECTION_LEVEL
DXGKMDT_OPM_SET_ACP_AND_CGMSA_SIGNALING
DXGKMDT_OPM_SET_HDCP_SRM
DXGKMDT_OPM_SET_PROTECTION_LEVEL_ACCORDING_TO_CSS_DVD. Didukung di Windows 7 dan versi yang lebih baru.

ulSequenceNumber

Sebuah nomor urut. Agar fungsi DxgkDdiOPMConfigureProtectedOutput memproses permintaan konfigurasi, nilai dalam ulSequenceNumber harus cocok dengan nomor urutan 4 byte saat ini yang disimpan driver miniport tampilan. Jika kecocokan tidak terdeteksi, DxgkDdiOPMConfigureProtectedOutput mengembalikan kode kesalahan. Jika kecocokan terdeteksi, DxgkDdiOPMConfigureProtectedOutput meningkatkan nomor urutan yang disimpan sebelum kembali. Nomor urutan 4 byte awal adalah bagian dari array 256-byte yang ditunjukkan oleh parameter EncryptedParameters dari fungsi DxgkDdiOPMSetSigningKeyAndSequenceNumbers .

cbParametersSize

Ukuran, dalam byte, dari data konfigurasi valid yang dirujuk anggota abParameters .

abParameters[DXGKMDT_OPM_CONFIGURE_SETTING_DATA_SIZE]

Array 4056-byte yang menentukan cara mengonfigurasi objek output yang dilindungi.

Parameter abParameters ditransmisikan ke salah satu struktur berikut yang berisi informasi konfigurasi, tergantung pada GUID yang ditentukan dalam anggota guidSetting dari DXGKMDT_OPM_CONFIGURE_PARAMETERS bahwa parameter ParameterDxgkDdiOPMConfigureProtectedOutput menunjuk ke.

Ini adalah guid dan struktur yang mungkin untuk informasi konfigurasi:

GUID	Struktur untuk informasi yang diambil
DXGKMDT_OPM_SET_PROTECTION_LEVEL atau DXGKMDT_OPM_SET_PROTECTION_LEVEL_ACCORDING_TO_CSS_DVD	DXGKMDT_OPM_SET_PROTECTION_LEVEL_PARAMETERS
DXGKMDT_OPM_SET_ACP_AND_CGMSA_SIGNALING	DXGKMDT_OPM_SET_ACP_AND_CGMSA_SIGNALING_PARAMETERS
DXGKMDT_OPM_SET_HDCP_SRM	DXGKMDT_OPM_SET_HDCP_SRM_PARAMETERS