DXGKDDI_OPM_CREATE_PROTECTED_OUTPUT fungsi panggilan balik (dispmprt.h)

Artikel
04/03/2024

Fungsi DxgkDdiOPMCreateProtectedOutput membuat objek output baru yang dilindungi dengan semantik Certified Output Protection Protocol (COPP) atau OPM.

Sintaks

DXGKDDI_OPM_CREATE_PROTECTED_OUTPUT DxgkddiOpmCreateProtectedOutput;

NTSTATUS DxgkddiOpmCreateProtectedOutput(
  [in]  PVOID MiniportDeviceContext,
  [in]  D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId,
  [in]  DXGKMDT_OPM_VIDEO_OUTPUT_SEMANTICS NewVideoOutputSemantics,
  [out] PHANDLE NewProtectedOutputHandle
)
{...}

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] VidPnTargetId

Bilangan bulat yang secara unik mengidentifikasi target video yang ada yang sesuai dengan objek output baru yang dilindungi. Setiap target video yang ada harus sesuai dengan satu konektor monitor fisik. Jika VidPnTargetId sesuai dengan beberapa konektor monitor fisik, DxgkDdiOPMCreateProtectedOutput harus mengembalikan kode kesalahan STATUS_GRAPHICS_OPM_SPANNING_MODE_ENABLED atau STATUS_GRAPHICS_OPM_THEATER_MODE_ENABLED.

[in] NewVideoOutputSemantics

Nilai jenis DXGKMDT_OPM_VIDEO_OUTPUT_SEMANTICS yang menentukan apakah output baru yang dilindungi memiliki semantik COPP atau OPM.

[out] NewProtectedOutputHandle

Penunjuk ke variabel yang menerima handel ke objek output baru yang dilindungi jika DxgkDdiOPMCreateProtectedOutput berhasil dikembalikan. Subsistem kernel grafis DirectX meneruskan handel ini dalam panggilan ke DxgkDdiOPMGetRandomNumber driver miniport tampilan, DxgkDdiOPMSetSigningKeyAndSequenceNumbers DxgkDdiOPMGetInformation, DxgkDdiOPMGetCOPPCompatibleInformation, DxgkDdiOPMConfigureProtectedOutput, dan DxgkDdiOPMDestroyProtectedOutput.

Jika DxgkDdiOPMCreateProtectedOutput gagal, nilai variabel tidak berubah.

Menampilkan nilai

DxgkDdiOPMCreateProtectedOutput mengembalikan salah satu nilai berikut.

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Fungsi berhasil membuat objek output baru yang dilindungi.
STATUS_GRAPHICS_OPM_NOT_SUPPORTED	Driver miniport tampilan tidak mendukung OPM baik karena vendor perangkat keras tidak pernah menandatangani perjanjian lisensi OPM atau perangkat keras grafis driver miniport tidak mematuhi aturan OPM.
STATUS_GRAPHICS_COPP_NOT_SUPPORTED	Driver miniport tampilan tidak mendukung COPP baik karena vendor perangkat keras tidak pernah menandatangani perjanjian lisensi COPP atau perangkat keras grafis driver miniport tidak mematuhi aturan COPP.
STATUS_NO_MEMORY	DxgkDdiOPMCreateProtectedOutput tidak dapat mengalokasikan memori yang diperlukan untuk menyelesaikannya.
STATUS_GRAPHICS_OPM_SPANNING_MODE_ENABLED	DxgkDdiOPMCreateProtectedOutput tidak dapat membuat output yang dilindungi karena target video yang ada dalam mode rentang. Ketika target video yang ada dalam mode rentang, itu sesuai dengan beberapa konektor monitor fisik dan setiap konektor menampilkan bagian terpisah dari buffer bingkai. Untuk diagram bagaimana driver miniport tampilan biasanya menerapkan mode rentang, lihat bagian Keterangan. Driver miniport tampilan menginformasikan sistem operasi tentang bagaimana buffer bingkai sesuai dengan monitor tertentu. Bagian kiri buffer bingkai ditampilkan pada satu monitor, dan setengah kanan buffer bingkai ditampilkan di monitor lainnya.
STATUS_GRAPHICS_OPM_THEATER_MODE_ENABLED	DxgkDdiOPMCreateProtectedOutput tidak dapat membuat output yang dilindungi karena target video yang ada dalam mode teater. Ketika target video yang ada berada dalam mode bioskop, itu sesuai dengan dua konektor monitor fisik; satu konektor menampilkan seluruh buffer bingkai dan konektor lainnya hanya menampilkan bagian dari buffer bingkai. Mode teater juga dikenal sebagai mode cermin. Untuk diagram bagaimana driver miniport tampilan biasanya mengimplementasikan mode teaer, lihat bagian Keterangan. Driver miniport tampilan menginformasikan sistem operasi tentang bagaimana buffer bingkai sesuai dengan monitor tertentu. Seluruh buffer bingkai ditampilkan pada satu monitor, dan hanya sebagian buffer bingkai yang ditampilkan pada monitor lainnya.