DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT fungsi panggilan balik (dispmprt.h)

Artikel
02/26/2024

Fungsi DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT mengonfigurasi objek output yang dilindungi yang diberikan.

Sintaks

DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT DxgkddiOpmConfigureProtectedOutput;

NTSTATUS DxgkddiOpmConfigureProtectedOutput(
  [in] PVOID MiniportDeviceContext,
  [in] HANDLE ProtectedOutputHandle,
  [in] const DXGKMDT_OPM_CONFIGURE_PARAMETERS *Parameters,
  [in] ULONG AdditionalParametersSize,
  [in] const VOID *AdditionalParameters
)
{...}

Parameter

[in] MiniportDeviceContext

Handel ke blok konteks yang terkait dengan adaptor tampilan. Fungsi DxgkDdiAddDevice driver miniport tampilan sebelumnya menyediakan 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 .

[in] Parameters

Penunjuk ke struktur DXGKMDT_OPM_CONFIGURE_PARAMETERS yang berisi parameter yang digunakan untuk mengonfigurasi objek output terproteksi yang handelnya ditentukan dalam parameter ProtectedOutputHandle .

[in] AdditionalParametersSize

Ukuran, dalam byte, dari parameter tambahan dalam buffer yang diacu oleh AdditionalParameters. Untuk emulasi Certified Output Protection Protocol (COPP), ini adalah 0.

[in] AdditionalParameters

Penunjuk ke buffer yang menyimpan parameter tambahan yang digunakan untuk mengonfigurasi objek output terproteksi yang handelnya ditentukan dalam parameter ProtectedOutputHandle . Untuk emulasi COPP, ini adalah NULL. Jika parameter AdditionalParametersSize diatur ke 0, AdditionalParameters selalu diatur ke NULL.

Nilai kembali

DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT mengembalikan salah satu nilai berikut:

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Fungsi berhasil mengonfigurasi objek output yang dilindungi.
STATUS_NO_MEMORY	DxgkDdiOPMConfigureProtectedOutput tidak dapat mengalokasikan memori yang diperlukan untuk menyelesaikannya.

Fungsi ini mungkin juga mengembalikan kode kesalahan lain yang ditentukan dalam Ntstatus.h.

Keterangan

Subsistem kernel grafis DirectX memanggil DxgkDdiOPMGetInformation atau DxgkDdiOPMGetCOPPCompatibleInformation untuk mengambil informasi tentang output lalu memanggil DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT satu atau beberapa kali untuk mengonfigurasi output.

DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT harus dibuat dapat diperbaharui.