Fungsi OPMGetVideoOutputsFromHMONITOR (opmapi.h)

Artikel
08/25/2023

Membuat objek Output Protection Manager (OPM) untuk setiap monitor fisik yang terkait dengan handel HMONITOR tertentu.

Sintaks

HRESULT OPMGetVideoOutputsFromHMONITOR(
  [in]  HMONITOR                   hMonitor,
  [in]  OPM_VIDEO_OUTPUT_SEMANTICS vos,
  [out] ULONG                      *pulNumVideoOutputs,
  [out] IOPMVideoOutput            ***pppOPMVideoOutputArray
);

Parameter

[in] hMonitor

Handel monitor untuk membuat objek OPM. Ada beberapa fungsi yang mengembalikan nilai HMONITOR . Untuk informasi selengkapnya, lihat topik Fungsi Beberapa Monitor Tampilan dalam dokumentasi antarmuka perangkat grafis (GDI) Windows.

[in] vos

Anggota enumerasi OPM_VIDEO_OUTPUT_SEMANTICS .

Nilai	Makna
OPM_VOS_OPM_SEMANTICS	Pointer IOPMVideoOutput yang dikembalikan akan menggunakan semantik OPM.
OPM_VOS_COPP_SEMANTICS	Pointer IOPMVideoOutput yang dikembalikan akan menggunakan semantik Certified Output Protection Protocol (COPP).

[out] pulNumVideoOutputs

Menerima jumlah pointer IOPMVideoOutput yang dikembalikan dalam parameter pppOPMVideoOutputArray .

[out] pppOPMVideoOutputArray

Menerima penunjuk ke array penunjuk IOPMVideoOutput . Setiap pointer IOPMVideoOutput dikaitkan dengan satu monitor fisik. Pemanggil harus melepaskan setiap pointer dalam array, dan memanggil CoTaskMemFree untuk membebaskan array.

Nilai kembali

Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Satu handel HMONITOR dapat dikaitkan dengan beberapa monitor fisik. Setiap monitor fisik memiliki konektornya sendiri. Aplikasi harus mengatur mekanisme perlindungan satu per satu untuk setiap monitor fisik, menggunakan pointer IOPMVideoOutput yang dikembalikan dalam pppOPMVideoOutputArray.

Antarmuka IOPMVideoOutput memiliki dua mode perilaku, tergantung pada nilai parameter vos . Jika vosOPM_VOS_COPP_SEMANTICS, IOPMVideoOutput menggunakan semantik COPP. Mode ini ditujukan untuk kompatibilitas mundur dengan COPP. Jika vosOPM_VOS_OPM_SEMANTICS, IOPMVideoOutput menggunakan semantik OPM yang lebih baru. Perbedaan perilaku dicatat pada halaman referensi untuk setiap metode. Mode tidak berubah selama masa pakai objek.

Persyaratan


Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	opmapi.h
Pustaka	Dxva2.lib
DLL	Dxva2.dll

Lihat juga

Fungsi OPM

Bagikan melalui