struktur DXGKMDT_OPM_GET_INFO_PARAMETERS (d3dkmdt.h)
Struktur DXGKMDT_OPM_GET_INFO_PARAMETERS berisi parameter yang digunakan untuk mengambil informasi dari objek output yang dilindungi dalam panggilan ke fungsi DxgkDdiOPMGetInformation .
Sintaks
typedef struct _DXGKMDT_OPM_GET_INFO_PARAMETERS {
DXGKMDT_OPM_OMAC omac;
DXGKMDT_OPM_RANDOM_NUMBER rnRandomNumber;
GUID guidInformation;
ULONG ulSequenceNumber;
ULONG cbParametersSize;
BYTE abParameters[DXGKMDT_OPM_GET_INFORMATION_PARAMETERS_SIZE];
} DXGKMDT_OPM_GET_INFO_PARAMETERS, *PDXGKMDT_OPM_GET_INFO_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 .
rnRandomNumber
Struktur DXGKMDT_OPM_RANDOM_NUMBER yang berisi angka acak 128-bit yang aman secara kriptografis objek output yang dilindungi. Nomor acak ini dihasilkan oleh aplikasi dan diberikan ke driver miniport tampilan di rnRandomNumber dalam panggilan ke fungsi DxgkDdiOPMGetInformation driver.
guidInformation
GUID yang digunakan untuk mengambil informasi. guidInformation dapat diatur ke salah satu GUID berikut:
- DXGKMDT_OPM_GET_CURRENT_HDCP_SRM_VERSION
- DXGKMDT_OPM_GET_CONNECTOR_TYPE
- DXGKMDT_OPM_GET_SUPPORTED_PROTECTION_TYPES
- DXGKMDT_OPM_GET_VIRTUAL_PROTECTION_LEVEL
- DXGKMDT_OPM_GET_ACTUAL_PROTECTION_LEVEL
- DXGKMDT_OPM_GET_ACTUAL_OUTPUT_FORMAT
- DXGKMDT_OPM_GET_ADAPTER_BUS_TYPE
- DXGKMDT_OPM_GET_DVI_CHARACTERISTICS. Didukung di Windows 7 dan versi yang lebih baru.
- DXGKMDT_OPM_GET_OUTPUT_ID. Didukung di Windows 7 dan versi yang lebih baru.
ulSequenceNumber
Sebuah nomor urut. Agar fungsi DxgkDdiOPMGetInformation memproses permintaan informasi, nilai dalam ulSequenceNumber harus cocok dengan nomor urutan 4 byte saat ini yang disimpan driver miniport tampilan. Jika kecocokan tidak terdeteksi, DxgkDdiOPMGetInformation mengembalikan kode kesalahan. Jika kecocokan terdeteksi, DxgkDdiOPMGetInformation 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 valid yang dirujuk anggota abParameters .
abParameters[DXGKMDT_OPM_GET_INFORMATION_PARAMETERS_SIZE]
Array 4056-byte yang berisi data yang menyertai permintaan informasi yang diidentifikasi oleh anggota guidInformation .
Tidak diperlukan data untuk permintaan DXGKMDT_OPM_GET_CONNECTOR_TYPE, DXGKMDT_OPM_GET_SUPPORTED_PROTECTION_TYPES, DXGKMDT_OPM_GET_ACTUAL_OUTPUT_FORMAT, DXGKMDT_OPM_GET_ADAPTER_BUS_TYPE, DXGKMDT_OPM_GET_DVI_CHARACTERISTICS, DXGKMDT_OPM_GET_OUTPUT_ID, dan DXGKMDT_OPM_GET_CURRENT_HDCP_SRM_VERSION.
Permintaan DXGKMDT_OPM_GET_ACTUAL_PROTECTION_LEVEL dan DXGKMDT_OPM_GET_VIRTUAL_PROTECTION_LEVEL memerlukan data yang mengidentifikasi jenis perlindungan yang diminta tingkat perlindungannya. Oleh karena itu, permintaan ini mengharuskan 4 byte pertama dalam array abParameters berisi jenis perlindungan.
Keterangan
Semua data setelah anggota omac di DXGKMDT_OPM_GET_INFO_PARAMETERS ditandatangani; tanda tangan adalah OMAC dan disimpan dalam anggota omac . Data ditandatangani dengan menggunakan algoritma OMAC-1.
DXGKMDT_OPM_GET_INFO_PARAMETERS tidak digunakan untuk emulasi COPP; sebaliknya, struktur DXGKMDT_OPM_COPP_COMPATIBLE_GET_INFO_PARAMETERS digunakan untuk COPP.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows Vista |
| Header | d3dkmdt.h |