Bagikan melalui

KSPROPERTY_CAMERACONTROL_EXTENDED_VIDEOHDR

  • Artikel

KSPROPERTY_CAMERACONTROL_EXTENDED_VIDEOHDR digunakan untuk mengaktifkan atau menonaktifkan video rentang dinamis tinggi (HDR) pada driver. Ini adalah kontrol tingkat pin hanya untuk pin video.

Tabel ringkasan penggunaan

Dapatkan Set Target Tipe Deskriptor Properti
Ya Ya Menyematkan KSPROPERTY_CAMERACONTROL_EXTENDED_VIDEOHDR

Bendera berikut dapat ditempatkan di KSCAMERA_EXTENDEDPROP_HEADER. Bendera bidang untuk mengontrol VIDEO HDR. Secara default, driver harus diatur ke VIDEOHDR_OFF.

#define KSCAMERA_EXTENDEDPROP_VIDEOHDR_OFF      0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_VIDEOHDR_ON       0x0000000000000001 
#define KSCAMERA_EXTENDEDPROP_VIDEOHDR_AUTO     0x0000000000000002

Jika driver mendukung kontrol ini, driver harus mendukung VIDEOHDR_ON/VIDEOHDR_OFF.

Jika driver tidak mendukung HDR video, driver tidak boleh menerapkan kontrol ini.

Kontrol ini berfungsi sebagai petunjuk untuk pengemudi. Ketika diatur ke VIDEOHDR_ON, driver harus melakukan HDR video sebagai upaya terbaik.

Panggilan SET kontrol ini tidak berpengaruh ketika pin video KSSTATE_RUN status. Driver akan menolak panggilan SET yang diterima jika pin video dalam keadaan berjalan dan mengembalikan STATUS_INVALID_DEVICE_STATE. Dalam panggilan GET, driver harus mengembalikan pengaturan saat ini di bidang Bendera.

Tabel berikut ini menjelaskan kapabilitas bendera.

Bendera Deskripsi
KSCAMERA_EXTENDEDPROP_VIDEOHDR_OFF Ini adalah kemampuan wajib. Ketika ditentukan, VIDEO HDR dinonaktifkan di driver dan driver tidak akan melakukan HDR video pada aliran video.
KSCAMERA_EXTENDEDPROP_VIDEOHDR_ON Ini adalah kemampuan wajib. Ketika ditentukan, VIDEO HDR diaktifkan di driver dan driver harus melakukan HDR video sebagai upaya terbaik. Bendera ini saling eksklusif dengan bendera VIDEOHDR_AUTO dan VIDEOHDR_OFF.
KSCAMERA_EXTENDEDPROP_VIDEOHDR_AUTO Kemampuan ini bersifat opsional. Ketika ditentukan, driver yang mendukung kemampuan tersebut akan menentukan apakah HDR video harus dilakukan berdasarkan analisis adegan. Bendera ini saling eksklusif dengan bendera VIDEOHDR_ON dan VIDEOHDR_OFF.

Tabel di bawah ini berisi deskripsi dan persyaratan untuk bidang struktur KSCAMERA_EXTENDEDPROP_HEADER saat menggunakan kontrol.

Anggota Deskripsi
Versi Ini harus 1.
PinId Harus berupa ID Pin yang terkait dengan pin video.
Ukuran Ini harus ukuranof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE).
Hasil Menunjukkan hasil kesalahan dari operasi SET terakhir. Jika tidak ada operasi SET yang terjadi, ini harus 0.
Kemampuan Harus berupa bitwise OR dari bendera KSCAMERA_EXTENDEDPROP_VIDEOHDR_* yang didukung yang ditentukan di atas.
Bendera Ini adalah bidang baca/tulis. Ini bisa menjadi salah satu bendera KSCAMERA_EXTENDEDPROP_VIDEOHDR_* yang ditentukan di atas.

Persyaratan

Klien minimum yang didukung: Windows 11

Header: ksmedia.h (termasuk Ksmedia.h)

Lihat juga

2.2.2.13 Kontrol HDR Video