Bagikan melalui

KSPROPERTY_CAMERACONTROL_EXTENDED_HISTOGRAM

  • Artikel

KSPROPERTY_CAMERACONTROL_EXTENDED_HISTOGRAM adalah ID properti yang akan digunakan untuk mengontrol metadata histogram yang dihasilkan oleh driver. Ini adalah kontrol tingkat pin hanya untuk pin pratinjau.

Tabel ringkasan penggunaan

Cakupan Kontrol Jenis

Versi 1

Menyematkan

Sinkron

Bendera berikut dapat ditempatkan di KSCAMERA_EXTENDEDPROP_HEADER. Bendera bidang untuk mengontrol metadata histogram dalam driver. Defaultnya adalah HISTOGRAM_OFF.

#define KSCAMERA_EXTENDEDPROP_HISTOGRAM_OFF      0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_HISTOGRAM_ON       0x0000000000000001

Kontrol ini harus digunakan sebelum kontrol KSPROPERTY_CAMERACONTROL_EXTENDED_METADATA untuk memastikan buffer metadata berukuran tepat dialokasikan.

Jika diatur ke HISTOGRAM_OFF, driver tidak akan mengirimkan metadata histogram pada pin pratinjau. Driver tidak boleh menyertakan ukuran metadata histogram dalam persyaratan ukuran buffer metadatanya.

Jika diatur ke HISTOGRAM_ON, driver akan mengirimkan metadata histogram pada pin pratinjau. Driver harus menyertakan ukuran metadata histogram dalam persyaratan ukuran buffer metadatanya.

Jika driver tidak memiliki kemampuan untuk menghasilkan metadata histogram, driver tidak boleh menerapkan kontrol ini. Jika driver mendukung kontrol ini, driver juga harus mendukung kontrol KSPROPERTY_CAMERACONTROL_EXTENDED_METADATA .

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

Tabel berikut 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 pratinjau.

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 0.

Bendera

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

Persyaratan

Header

 Ksmedia.h