Bagikan melalui

KSPROPERTY_CAMERACONTROL_EXTENDED_VIDEOSTABILIZATION

  • Artikel

Kontrol properti yang diperluas ini digunakan untuk mengontrol stabilisasi video digital di driver\MFT0.

Tabel ringkasan penggunaan

Cakupan Kontrol Jenis

Versi 1

Menyematkan

Sinkron

Bendera berikut yang dapat ditempatkan di KSCAMERA_EXTENDEDPROP_HEADER. Menandai bendera bidang untuk mengontrol stabilisasi video digital di driver\MFT0. Secara default, driver harus menonaktifkan stabilisasi video.

#define KSCAMERA_EXTENDEDPROP_VIDEOSTABILIZATION_OFF       0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_VIDEOSTABILIZATION_ON        0x0000000000000001
#define KSCAMERA_EXTENDEDPROP_VIDEOSTABILIZATION_AUTO      0x0000000000000002

Jika driver tidak mendukung stabilisasi video digital, driver tidak boleh menerapkan kontrol ini.

Jika driver mendukung kontrol ini, driver harus mendukung VIDEOSTABILIZATION_ON\OFF.

Panggilan SET kontrol ini tidak berpengaruh ketika pin video berada dalam status apa pun yang lebih tinggi dari status KSSTATE_STOP. Driver akan menolak panggilan SET yang diterima jika pin video tidak dalam status berhenti dan mengembalikan STATUS_INVALID_DEVICE_STATE. Dalam panggilan GET, driver harus mengembalikan pengaturan saat ini di bidang Bendera.

Ketika kontrol ini digunakan dalam konteks profil, profil akan berfungsi sebagai petunjuk bagi driver untuk mode kualitas. Driver dapat menentukan apakah akan mengoptimalkan latensi rendah atau berkualitas tinggi ketika stabilisasi video diaktifkan berdasarkan profil yang dipilih, misalnya, konferensi video atau perekaman video berkualitas tinggi.

Catatan

PROPSETID_VIDCAP_CAMERACONTROL_VIDEO_STABILIZATION tidak digunakan lagi untuk Windows 10.

Tabel berikut ini menjelaskan kapabilitas bendera.

Bendera Deskripsi

KSCAMERA_EXTENDEDPROP_VIDEOSTABILIZATION_OFF

Ini adalah kemampuan wajib. Ketika ditentukan, stabilisasi video digital dinonaktifkan di driver\MFT0.

KSCAMERA_EXTENDEDPROP_VIDEOSTABILIZATION_ON

Ini adalah kemampuan wajib. Ketika ditentukan, stabilisasi video digital diaktifkan di driver\MFT0 dan pengaturan padding overscan default disetel ke driver. Bendera ini saling eksklusif dengan bendera AUTO dan OFF.

KSCAMERA_EXTENDEDPROP_VIDEOSTABILIZATION_AUTO

Kemampuan ini bersifat opsional. Ketika ditentukan, driver yang mendukung kemampuan tersebut akan menentukan apakah stabilisasi video harus dilakukan dan berapa banyak stabilisasi yang akan diterapkan berdasarkan analisis adegan dan skenario pengambilan. Bendera ini saling eksklusif dengan bendera ON dan OFF.

Catatan

Tergantung pada implementasinya, buffer overscanned dapat dialokasikan baik oleh driver secara internal atau oleh alur.

Jika buffer overscanned akan dialokasikan oleh driver, driver harus mengiklankan jenis media reguler dan jenis media overscanned. MFT0 harus mengiklankan jenis media reguler. Setelah mengatur jenis media reguler pada jenis media output MFT0, MFT0 harus memilih jenis media overscanned yang sesuai dari jenis media yang diiklankan driver sebagai jenis media inputnya, jika stabilisasi video diaktifkan. Jika stabilisasi video dimatikan, MFT0 harus memilih jenis media reguler sebagai jenis media inputnya. MFT0 harus mengembalikan MF_E_INVALIDMEDIATYPE jika jenis media overscanned diatur sebagai jenis media outputnya saat stabilisasi video diaktifkan.

Jika buffer overscanned dialokasikan oleh driver, driver dan MFT0 harus mengiklankan jenis media reguler. MFT0 harus mengatur jenis media reguler untuk jenis media input dan jenis media outputnya.

Untuk mendukung stabilisasi video berbasis efek (yaitu, stabilisasi video yang dilakukan baik di driver maupun di MFT0), driver dan MFT0 juga harus mengiklankan jenis media overscanned terlepas dari itu. Dalam hal ini, jenis media reguler dan overscanned diekspos oleh driver dan MFT0. Aturan berikut akan berlaku untuk memastikan stabilisasi video berbasis efek dan driver\MFT0 berfungsi dengan benar.

  • Jika jenis media overscanned diatur sebagai jenis media output MFT0 saat stabilisasi video berbasis driver\MFT0 aktif, MFT0 harus mengembalikan MF_E_INVALIDMEDIATYPE.

  • Jika jenis media reguler ditetapkan sebagai jenis media output MFT0, aplikasi harus mengembalikan kesalahan dalam upaya mengaktifkan stabilisasi video berbasis efek jika stabilisasi video berbasis efek hanya dapat mengambil jenis media yang dipindai.

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

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

Ini harus berupa bitwise ATAU dari bendera KSCAMERA_EXTENDEDPROP_VIDEOSTABILIZATION_XXX yang didukung seperti yang didefinisikan di atas.

Bendera

Ini adalah bidang baca/tulis. Ini bisa menjadi salah satu bendera KSCAMERA_EXTENDEDPROP_VIDEOSTABILIZATION_XXX yang ditentukan di atas.

Persyaratan

Header

 Ksmedia.h