KSPROPERTY_CAMERACONTROL_EXTENDED_ZOOM

KSPROPERTY_CAMERACONTROL_EXTENDED_ZOOM digunakan untuk mengontrol zoom digital. Ini didefinisikan dalam enumerasi KSPROPERTY_CAMERACONTROL_EXTENDED_PROPERTY dan digunakan untuk mendapatkan dan mengatur rasio zoom dan mendapatkan rentang zoom dari driver. Dalam Windows 10, kontrol ini diperluas untuk juga mendukung zoom yang halus.

Tabel ringkasan penggunaan

Cakupan	Kontrol	Jenis
Versi 1	Filter	Sinkron

Bendera berikut dapat ditempatkan di KSCAMERA_EXTENDEDPROP_HEADER. Bendera bidang untuk mengontrol zoom halus vs. zoom langsung. Default didefinisikan oleh driver.

#define KSCAMERA_EXTENDEDPROP_ZOOM_DEFAULT  0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_ZOOM_DIRECT   0x0000000000000001
#define KSCAMERA_EXTENDEDPROP_ZOOM_SMOOTH   0x0000000000000002

Jika driver mendukung kontrol ini, driver harus mendukung KSCAMERA_EXTENDEDPROP_ZOOM_DEFAULT.

Jika driver tidak mendukung zoom digital, driver tidak boleh menerapkan kontrol ini.

Tabel berikut ini menjelaskan kapabilitas bendera.

Bendera	Deskripsi
KSCAMERA_EXTENDEDPROP_ZOOM_DEFAULT	Ini adalah kemampuan wajib. Ketika ditentukan, driver akan memutuskan apakah zoom langsung atau zoom halus harus diterapkan dan memperbesar ke faktor zoom target yang ditentukan dalam VideoProc.Value.ul yang sesuai. Bendera ini saling eksklusif dengan bendera DIRECT dan SMOOTH.
KSCAMERA_EXTENDEDPROP_ZOOM_DIRECT	Ini adalah kemampuan wajib. Ketika ditentukan, driver akan memperbesar ke faktor zoom target yang ditentukan dalam VideoProc.Value.ul secepat mungkin. Bendera ini saling eksklusif dengan bendera AUTO dan SMOOTH.
KSCAMERA_EXTENDEDPROP_ZOOM_SMOOTH	Kemampuan ini bersifat opsional. Ketika ditentukan, driver akan memperbesar ke faktor zoom target yang ditentukan dalam VideoProc.Value.ul secara bertahap dengan cara yang lancar. Jumlah bingkai yang diperlukan untuk mencapai faktor zoom yang ditentukan hingga driver. Bendera ini saling eksklusif dengan bendera AUTO dan DIRECT.

Untuk setiap panggilan GET , driver harus melaporkan rentang zoom saat ini yang diizinkan berdasarkan konfigurasi atau penyiapan saat ini.

Tabel berikut berisi deskripsi dan persyaratan untuk bidang struktur KSCAMERA_EXTENDEDPROP_HEADER saat menggunakan properti KSPROPERTY_CAMERACONTROL_EXTENDED_ZOOM .

Anggota	Deskripsi
Versi	Ini harus 1,
PinId	Ini harus KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF),
Ukuran	Ini harus ukuranof(KSCAMERA_EXTENDEDPROP_HEADER)+sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING),
Hasil	Ini menunjukkan hasil kesalahan dari operasi SET terakhir. Jika tidak ada operasi SET yang terjadi, ini harus 0.
Kemampuan	Harus bitwise ATAU dari bendera yang didukung yang ditentukan di atas.
Bendera	Ini adalah bidang baca/tulis. Ini bisa menjadi salah satu bendera yang didukung yang ditentukan di atas.

Tabel di bawah ini berisi deskripsi dan persyaratan untuk bidang struktur KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING untuk properti KSPROPERTY_CAMERACONTROL_EXTENDED_ZOOM .

Anggota	Deskripsi
Mode	Ini tidak digunakan dan harus 0.
Min/Maks/Langkah	Min/Max/Step berisi minimum/maksimum/kenaikan rasio zoom yang didukung oleh driver kamera dalam format Q16. Driver harus mengembalikan nilai-nilai ini untuk operasi GET .
VideoProc	Untuk operasi SET , VideoProc.Value.ul harus menentukan rasio zoom dalam rentang yang dijelaskan oleh parameter Min/Max/Step. Untuk operasi GET , driver harus mengembalikan rasio zoom saat ini.
Dicadangkan	Ini tidak digunakan. Ini harus diabaikan oleh driver.

Kontrol properti ini sinkron dan tidak dapat dibatalkan.

Persyaratan

Header

Ksmedia.h