DXGKDDI_OPM_GET_COPP_COMPATIBLE_INFORMATION fungsi panggilan balik (dispmprt.h)

Artikel
03/08/2023

Fungsi DXGKDDI_OPM_GET_COPP_COMPATIBLE_INFORMATION mengambil informasi yang kompatibel dengan Certified Output Protection Protocol (COPP) dari objek output yang dilindungi.

Sintaks

DXGKDDI_OPM_GET_COPP_COMPATIBLE_INFORMATION DxgkddiOpmGetCoppCompatibleInformation;

NTSTATUS DxgkddiOpmGetCoppCompatibleInformation(
  [in]  PVOID MiniportDeviceContext,
  [in]  HANDLE ProtectedOutputHandle,
  [in]  const DXGKMDT_OPM_COPP_COMPATIBLE_GET_INFO_PARAMETERS *Parameters,
  [out] PDXGKMDT_OPM_REQUESTED_INFORMATION RequestedInformation
)
{...}

Parameter

[in] MiniportDeviceContext

Handel ke blok konteks yang terkait dengan adaptor tampilan. Sebelumnya, fungsi DxgkDdiAddDevice driver miniport tampilan memberikan handel ini ke subsistem kernel grafis DirectX.

[in] ProtectedOutputHandle

Handel ke objek output yang dilindungi. Fungsi DxgkDdiOPMCreateProtectedOutput membuat objek output yang dilindungi dan mengembalikan handel ke objek . Objek output yang dilindungi yang sesuai dengan handel ini harus memiliki semantik COPP.

[in] Parameters

Penunjuk ke struktur DXGKMDT_OPM_COPP_COMPATIBLE_GET_INFO_PARAMETERS yang berisi jenis informasi yang kompatibel dengan COPP untuk diambil dari objek output terproteksi yang handelnya ditentukan dalam parameter ProtectedOutputHandle . DxgkDdiOPMGetCOPPCompatibleInformation menentukan apakah parameter berisi permintaan yang valid dari aplikasi yang secara tidak langsung membuat objek output yang dilindungi. Untuk informasi lebih lanjut, lihat bagian Keterangan.

[out] RequestedInformation

Penunjuk ke struktur DXGKMDT_OPM_REQUESTED_INFORMATION yang menerima informasi kompatibel COPP objek output yang dilindungi jika DxgkDdiOPMGetCOPPCompatibleInformation berhasil dikembalikan.

Jika DxgkDdiOPMGetCOPPCompatibleInformation gagal, nilai yang dirujuk RequestedInformation tidak berubah.

Mengembalikan nilai

DxgkDdiOPMGetCOPPCompatibleInformation mengembalikan kode kesalahan STATUS_SUCCESS atau Ntstatus.h .

Keterangan

Subsistem kernel grafis DirectX harus memanggil DxgkDdiOPMGetCOPPCompatibleInformation hanya jika output memiliki semantik COPP.

Sebelum subsistem kernel grafis DirectX meneruskan handel output yang dilindungi ke parameter ProtectedOutputHandle dalam panggilan ke DxgkDdiOPMGetCOPPCompatibleInformation, subsistem kernel grafis DirectX selalu meneruskan handel output yang dilindungi ke fungsi DxgkDdiOPMSetSigningKeyAndSequenceNumbers dan DxgkDdiOPMGetRandomNumber .

Berikut adalah beberapa fakta yang berkaitan dengan DxgkDdiOPMGetCOPPCompatibleInformation dan yang tidak berkaitan dengan fungsi DxgkDdiOPMGetInformation :

Subsistem kernel grafis DirectX dapat meneruskan handel ke output yang dilindungi hanya dengan semantik COPP.
Struktur DXGKMDT_OPM_COPP_COMPATIBLE_GET_INFO_PARAMETERS yang dituju parameter Parameter tidak ditandatangani.
Subsistem kernel grafis DirectX dapat meneruskan GUID DXGKMDT_OPM_GET_ACP_AND_CGMSA_SIGNALING dan DXGKMDT_OPM_GET_CONNECTED_HDCP_DEVICE_INFORMATION di anggota guidInformation DXGKMDT_OPM_COPP_COMPATIBLE_GET_INFO_PARAMETERS.
Subsistem kernel grafis DirectX tidak dapat meneruskan GUID DXGKMDT_OPM_GET_CURRENT_HDCP_SRM_VERSION di anggota guidInformation DXGKMDT_OPM_COPP_COMPATIBLE_GET_INFO_PARAMETERS.
Subsistem kernel grafik DirectX dapat menentukan DXGKMDT_OPM_PROTECTION_TYPE_COPP_COMPATIBLE_HDCP dalam 4 byte pertama anggota DXGKMDT_OPM_COPP_COMPATIBLE_GET_INFO_PARAMETERS abParameters bersama dengan GUID DXGKMDT_OPM_GET_VIRTUAL_PROTECTION_LEVEL atau DXGKMDT_OPM_GET_ACTUAL_PROTECTION_LEVEL di anggota guidInformation DXGKMDT_OPM_COPP_COMPATIBLE_GET_INFO_PARAMETERS.
Subsistem kernel grafik DirectX tidak dapat menentukan DXGKMDT_OPM_PROTECTION_TYPE_HDCP dalam 4 byte pertama anggota DXGKMDT_OPM_COPP_COMPATIBLE_GET_INFO_PARAMETERS abParameters bersama dengan GUID DXGKMDT_OPM_GET_VIRTUAL_PROTECTION_LEVEL atau DXGKMDT_OPM_GET_ACTUAL_PROTECTION_LEVEL di anggota guidInformation DXGKMDT_OPM_COPP_COMPATIBLE_GET_INFO_PARAMETERS.

Driver harus melakukan urutan berikut ketika fungsi DxgkDdiOPMGetCOPPCompatibleInformation dipanggil.

Verifikasi bahwa handel output yang dilindungi yang diteruskan ke parameter ProtectedOutputHandle dari DxgkDdiOPMGetCOPPCompatibleInformation memiliki semantik COPP.
Ambil informasi yang diminta.
Salin angka acak yang ditentukan anggota rnRandomNumberdari DXGKMDT_OPM_COPP_COMPATIBLE_GET_INFO_PARAMETERS ke anggota rnRandomNumber dari struktur DXGKMDT_OPM_STANDARD_INFORMATION, DXGKMDT_OPM_ACTUAL_OUTPUT_FORMAT, DXGKMDT_OPM_ACP_AND_CGMSA_SIGNALING, atau DXGKMDT_OPM_CONNECTED_HDCP_DEVICE_INFORMATION. Struktur yang digunakan tergantung pada jenis informasi yang diminta pemanggil. Struktur diatur dalam anggota abRequestedInformation dari struktur DXGKMDT_OPM_REQUESTED_INFORMATION yang ditunjuk oleh parameter RequestedInformation .
Tanda tangani struktur DXGKMDT_OPM_REQUESTED_INFORMATION dan letakkan tanda tangan di anggota omac DXGKMDT_OPM_REQUESTED_INFORMATION. Cipher blok AES dan algoritma penandatanganan OMAC-1 harus digunakan untuk menandatangani struktur. Untuk informasi tentang AES, lihat situs web Laboratorium RSA . Untuk informasi tentang OMAC-1, lihat halaman referensi DXGKMDT_OPM_OMAC .

Awalnya, subsistem kernel grafis DirectX memanggil DxgkDdiOPMGetCOPPCompatibleInformation untuk mengambil informasi tentang output dan kemudian memanggil DxgkDdiOPMConfigureProtectedOutput satu atau beberapa kali untuk mengonfigurasi output. Selanjutnya, subsistem kernel grafis DirectX memanggil DxgkDdiOPMGetCOPPCompatibleInformation tanpa juga memanggil DxgkDdiOPMConfigureProtectedOutput.

DxgkDdiOPMGetCOPPCompatibleInformation harus dibuat dapat dipaginasi.