Fungsi VideoPortCreateSecondaryDisplay (video.h)

Fungsi VideoPortCreateSecondaryDisplay memungkinkan dukungan dual-view dengan membuat objek perangkat sekunder untuk perangkat tertentu.

Sintaks

VIDEOPORT_DEPRECATED VIDEOPORT_API VP_STATUS VideoPortCreateSecondaryDisplay(
  [in]      IN PVOID     HwDeviceExtension,
  [in, out] IN OUT PVOID *SecondaryDeviceExtension,
  [in]      IN ULONG     ulFlag
);

Parameter

[in] HwDeviceExtension

Arahkan ke ekstensi perangkat driver miniport. Ini adalah ekstensi perangkat keras untuk perangkat yang ingin membuat objek perangkat tampilan tambahan.

[in, out] SecondaryDeviceExtension

Arahkan ke lokasi untuk menyimpan ekstensi perangkat keras untuk perangkat tampilan sekunder.

[in] ulFlag

Adalah sekumpulan atribut untuk perangkat tampilan sekunder. Parameter ini dibatasi untuk nilai berikut:

Nilai	Makna
VIDEO_DUALVIEW_REMOVABLE	Tampilan sekunder dapat dihapus.

Mengembalikan nilai

VideoPortCreateSecondaryDisplay mengembalikan NO_ERROR jika perangkat tampilan sekunder berhasil dibuat. Jika tidak, fungsi ini mengembalikan kode kesalahan.

Keterangan

Di Windows XP dan yang lebih baru, perangkat logis yang dapat dilepas tidak akan pernah menjadi tampilan utama.

Perhatikan bahwa pada beberapa edisi Windows XP, VideoPortCreateSecondaryDisplay sengaja dapat gagal mengaktifkan Dualview. Dalam kasus seperti itu, driver tampilan harus tetap dalam mode SingleView.

Ketika driver minport video memanggil VideoPortCreateSecondaryDisplay, nilai parameter ulFlags harus sama dengan VIDEO_DUALVIEW_REMOVABLE, yang didefinisikan dalam ntddvdeo.h.

Bendera VIDEO_DUALVIEW_PRIMARY dan VIDEO_DUALVIEW_SECONDARY, yang didefinisikan dalam ntddvdeo.h, hanya untuk penggunaan internal. Driver miniport video tidak boleh mengatur bendera ini.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows XP dan versi yang lebih baru dari sistem operasi Windows.
Target Platform	Desktop
Header	video.h (sertakan Video.h)
Pustaka	Videoprt.lib
DLL	Videoprt.sys
IRQL	PASSIVE_LEVEL