KSPROPERTY_CAMERACONTROL_EXTENDED_OPTIMIZATIONHINT (strategi performa aplikasi)

Driver kamera dapat mengoptimalkan operasi penangkapan mereka berdasarkan petunjuk yang disediakan oleh aplikasi. Properti ini menginformasikan driver untuk mengatur strategi performanya berdasarkan operasi apa yang paling mungkin digunakan. Misalnya, ketika dioptimalkan untuk foto, driver kamera dapat memprogram sensor untuk mengoptimalkan kecepatan pencahayaan sensor dan resolusi untuk latensi yang lebih rendah dari pemicu tangkapan foto hingga pengambilan gambar. Demikian pula, ketika dioptimalkan untuk video, driver kamera dapat memprogram sensor untuk kecepatan bingkai yang lebih tinggi tetapi pada resolusi yang lebih rendah.

Tabel ringkasan penggunaan

Get	Set	Target	Jenis deskriptor properti	Jenis nilai properti
Ya	Ya	Filter	KSPROPERTY	KSCAMERA_EXTENDEDPROP_HEADER

Nilai properti (data operasi) berisi struktur KSCAMERA_EXTENDEDPROP_HEADER dan struktur KSCAMERA_EXTENDEDPROP_VALUE .

Ukuran total data properti adalah sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE). Anggota UkuranKSCAMERA_EXTENDEDPROP_HEADER diatur ke ukuran total data properti ini.

Anggota KemampuanKSCAMERA_EXTENDEDPROP_HEADER berisi kombinasi BITWISE OR dari satu atau beberapa petunjuk pengoptimalan berikut.

Petunjuk pengoptimalan	Deskripsi
KSCAMERA_EXTENDEDPROP_OPTIMIZATION_PHOTO	Operasi kamera dioptimalkan untuk foto
KSCAMERA_EXTENDEDPROP_OPTIMIZATION_VIDEO	Operasi kamera dioptimalkan untuk video

Anggota BenderaKSCAMERA_EXTENDEDPROP_HEADER berisi pengoptimalan yang saat ini diatur untuk kamera (satu nilai).

Jenis pengoptimalan default adalah KSCAMERA_EXTENDEDPROP_OPTIMIZATION_PHOTO. Jika properti ini didukung oleh driver kamera, kedua jenis pengoptimalan harus didukung.

Kontrol properti ini sinkron dan tidak dapat dibatalkan.

Keterangan

Mode pengoptimalan

KSCAMERA_EXTENDEDPROP_OPTIMIZATION_PHOTO

Semua driver kamera harus dalam mode ini sampai secara eksplisit diinformasikan untuk menggunakan mode KSCAMERA_EXTENDEDPROP_OPTIMIZATION_VIDEO. Tujuan dari mode ini adalah untuk mengoptimalkan perangkat keras kamera untuk operasi foto. Operasi video masih harus berfungsi dalam mode ini.

KSCAMERA_EXTENDEDPROP_OPTIMIZATION_VIDEO

Mode ini menunjukkan bahwa kamera kemungkinan akan digunakan untuk operasi video. Driver kamera harus mengoptimalkan perangkat keras untuk operasi video untuk mode ini. Operasi foto harus berfungsi, tetapi ada prioritas penggunaan sumber daya adalah untuk operasi video.

Mendapatkan properti

Saat menanggapi permintaan KSPROPERTY_TYPE_GET, driver mengatur anggota KSCAMERA_EXTENDEDPROP_HEADER ke yang berikut.

Anggota	Nilai
Versi	1
PinId	KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF)
Ukuran	sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE)
Hasil	0
Kemampuan	Nilai pengoptimalan didukung
Bendera	Pengaturan nilai pengoptimalan saat ini

Jika sebelumnya tidak ada mode pengoptimalan yang diatur, maka driver mengatur Bendera ke KSCAMERA_EXTENDEDPROP_OPTIMIZATION_PHOTO (default).

Mengatur properti

Saat properti diatur, permintaan KSPROPERTY_TYPE_SET, anggota BenderaKSCAMERA_EXTENDEDPROP_HEADER akan berisi mode pengoptimalan yang akan diatur.

Persyaratan

Versi: Tersedia dimulai dengan Windows 8.1

Header: Ksmedia.h (termasuk Ksmedia.h)

Lihat juga

KSCAMERA_EXTENDEDPROP_HEADER

KSCAMERA_EXTENDEDPROP_VALUE