KSPROPERTY_CAMERACONTROL_EXTENDED_OPTIMIZATIONHINT (pengoptimalan perangkat keras yang diperluas)

KSPROPERTY_CAMERACONTROL_EXTENDED_OPTIMIZATIONHINT digunakan untuk mengontrol kasus penggunaan utama pengambilan foto vs. pengambilan video. Dalam Windows 10, kontrol ini diperluas untuk mendukung petunjuk pengoptimalan perangkat keras yang diperluas.

Tabel ringkasan penggunaan

Cakupan	Kontrol	Jenis
Versi 1	Filter	Sinkron

Bendera berikut dapat ditempatkan di KSCAMERA_EXTENDEDPROP_HEADER. Menandai bidang ke petunjuk pengoptimalan perangkat keras di driver.

#define KSCAMERA_EXTENDEDPROP_OPTIMIZATION_DEFAULT      0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_OPTIMIZATION_PHOTO        0x0000000000000001
#define KSCAMERA_EXTENDEDPROP_OPTIMIZATION_VIDEO        0x0000000000000002
#define KSCAMERA_EXTENDEDPROP_OPTIMIZATION_QUALITY      0x0000000000000004
#define KSCAMERA_EXTENDEDPROP_OPTIMIZATION_LATENCY      0x0000000000000008
#define KSCAMERA_EXTENDEDPROP_OPTIMIZATION_POWER        0x0000000000000010

Petunjuk FOTO dan VIDEO akan terus digunakan untuk menentukan kasus penggunaan utama.

Untuk Windows 10, bendera bit tambahan membantu tradeoff kualitas, kecepatan, dan konsumsi daya di pengemudi. Secara default, driver harus memiliki KSCAMERA_EXTENDEDPROP_OPTIMIZATION_PHOTO.

Jika driver mendukung kontrol ini, driver harus mendukung KSCAMERA_EXTENDEDPROP_OPTIMIZATION_PHOTO dan KSCAMERA_EXTENDEDPROP_OPTIMIZATION_VIDEO.

Jika driver tidak mendukung petunjuk pengoptimalan, driver tidak boleh menerapkan kontrol ini.

Tabel berikut ini menjelaskan kapabilitas bendera.

Bendera	Deskripsi
KSCAMERA_EXTENDEDPROP_OPTIMIZATION_DEFAULT	Ini adalah kemampuan wajib. Ketika ditentukan, driver harus membersihkan petunjuk yang sebelumnya diatur pada driver dan menerapkan daya default, kualitas, tradeoff latensi driver.
KSCAMERA_EXTENDEDPROP_OPTIMIZATION_PHOTO	Ini adalah kemampuan wajib. Jika ditentukan, kasus penggunaan utama adalah pengambilan foto dan driver harus memprioritaskan pengambilan foto melalui rekaman video. Bendera ini dapat ditentukan ketika pin pratinjau dalam status berhenti untuk memilih mode sensor demi kualitas foto, atau dalam status berjalan untuk pengambilan foto selama perekaman video saja. Ketika ditentukan untuk pengambilan foto selama perekaman video, kesalahan dalam streaming video dapat diterima demi kualitas foto yang lebih baik. Bendera ini saling eksklusif dengan bendera VIDEO dan dapat digunakan dengan satu atau dua bendera QUALITY, LATENCY, dan POWER.
KSCAMERA_EXTENDEDPROP_OPTIMIZATION_VIDEO	Ini adalah kemampuan wajib. Jika ditentukan, kasus penggunaan utama adalah pengambilan video dan driver harus memprioritaskan perekaman video melalui pengambilan foto. Bendera ini dapat ditentukan ketika pin pratinjau dalam status berhenti untuk memilih mode sensor demi perekaman video, atau dalam status berjalan untuk pengambilan foto selama perekaman video saja. Ketika ditentukan untuk pengambilan foto selama perekaman video, kesalahan dalam aliran video tidak diizinkan. Bendera ini saling eksklusif dengan bendera PHOTO dan dapat digunakan dengan satu atau dua bendera QUALITY, LATENCY, dan POWER.
KSCAMERA_EXTENDEDPROP_OPTIMIZATION_QUALITY	Kemampuan ini bersifat opsional. Ketika ditentukan, driver harus mengoptimalkan kualitas gambar untuk pengambilan foto dan kualitas video untuk perekaman video. Bendera ini dapat ditentukan sebelum pengambilan foto (termasuk foto biasa, VPS, dan PS tanpa bingkai riwayat) dan/atau perekaman video dimulai, atau ketika pin dalam status berhenti. Bendera ini dapat digunakan dengan bendera PHOTO, atau dengan bendera LATENSI atau POWER bersama dengan bendera VIDEO.
KSCAMERA_EXTENDEDPROP_OPTIMIZATION_LATENCY	Kemampuan ini bersifat opsional. Ketika ditentukan, driver harus mengoptimalkan kecepatan dan latensi untuk pengambilan foto dan rekaman video. Bendera ini dapat ditentukan sebelum pengambilan foto (termasuk foto biasa, VPS, dan PS tanpa bingkai riwayat) dan\atau perekaman video dimulai, atau ketika pin dalam status berhenti. Bendera ini dapat digunakan dengan bendera PHOTO, atau dengan bendera QUALITY atau POWER bersama dengan bendera VIDEO.
KSCAMERA_EXTENDEDPROP_OPTIMIZATION_POWER	Kemampuan ini bersifat opsional. Ketika ditentukan, driver harus mengoptimalkan konsumsi daya untuk pengambilan foto dan perekaman video. Bendera ini dapat ditentukan sebelum pengambilan foto (termasuk foto reguler, VPS, dan PS tanpa riwayat) dan/atau perekaman video dimulai, atau ketika pin dalam status berhenti. Bendera ini dapat digunakan dengan bendera QUALITY atau LATENCY, bersama dengan bendera VIDEO.

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

Anggota	Nilai
Versi	1
PinId	KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF)
Ukuran	sizeof(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 bitwise ATAU dari bendera KSCAMERA_EXTENDEDPROP_OPTIMIZATION_* yang didukung seperti yang didefinisikan di atas.
Bendera	Ini adalah bidang baca/tulis. Ini bisa menjadi kombinasi yang valid dari bendera KSCAMERA_EXTENDEDPROP_OPTIMIZATION_* yang didukung yang ditentukan di atas.

Keterangan

Ingatlah item berikut saat menggunakan petunjuk pengoptimalan:

• KUALITAS/LATENSI/DAYA dan FOTO/VIDEO adalah dua set petunjuk independen. Mereka dapat ditentukan bersama-sama pada saat yang sama atau secara independen pada waktu yang berbeda. Pengaturan KUALITAS/LATENSI/DAYA tidak menimpa FOTO/VIDEO dan sebaliknya. Ketika ditentukan pada waktu yang berbeda, driver harus mengembalikan pengaturan saat ini dari kedua set petunjuk dalam panggilan GET.

• Untuk KUALITAS/LATENSI/DAYA, ketika petunjuk diatur, driver harus mengoptimalkan dalam batasannya. Jika tidak ada pengoptimalan yang tersedia, driver harus mengabaikan petunjuk.

• Ketika dua petunjuk ditentukan pada saat yang sama untuk kasus penggunaan video, pengoptimalan setiap petunjuk mungkin kurang dari ketika hanya satu petunjuk yang ditentukan. Lebih spesifik:

  • LATENSI lebih diutamakan daripada KUALITAS atau DAYA ketika KUALITAS atau DAYA juga ditentukan. Dalam kasus seperti itu, kualitasnya mungkin kurang dari ketika hanya KUALITAS yang ditentukan, dan konsumsi daya mungkin lebih tinggi daripada ketika hanya DAYA yang ditentukan.

  • Ketika KUALITAS dan DAYA ditentukan, kualitas mungkin kurang dari ketika hanya KUALITAS yang ditentukan, dan konsumsi daya mungkin lebih tinggi daripada ketika hanya DAYA yang ditentukan.

• Petunjuk pengoptimalan hanya dilayani sebagai petunjuk kepada driver untuk memfasilitasi tradeoff pemrosesan di 3A, pemrosesan ISP, pemilihan sensor, dll., dalam batasan skenario pengambilan yang ditentukan oleh aplikasi. Penting bagi pengembang aplikasi untuk memilih dan mengonfigurasi kontrol dan API yang paling cocok untuk skenario pengambilan tertentu untuk mencapai hasil terbaik. Jika tidak, petunjuk pengoptimalan saja mungkin memiliki efek yang berkurang. Misalnya, untuk pengambilan foto berkualitas tinggi, VPS atau LowLagPhoto/TakePhoto harus digunakan alih-alih PS pada platform IHV tertentu untuk menggunakan petunjuk QUALITY. Demikian pula, stabilisasi video harus dinonaktifkan jika latensi atau konsumsi daya yang lebih rendah diinginkan.

• Petunjuk pengoptimalan harus diabaikan jika diterima pada waktu/status selain apa yang ditentukan di bawah setiap bendera kemampuan.

Ketika kontrol stabilisasi video juga diaktifkan pada driver (AKTIF atau OTOMATIS):

• Driver dapat menerapkan stabilisasi video agresif terendah yang mencakup latensi rendah dan/atau algoritma stabilisasi video berdaya rendah untuk mengurangi latensi pemrosesan dan/atau konsumsi daya jika petunjuk LATENSI dan/atau DAYA diatur. Saat stabilisasi video diatur ke AUTO, driver dapat mematikan stabilisasi video untuk mengurangi latensi dan/atau konsumsi daya lebih lanjut.

• Driver dapat menerapkan stabilisasi video agresif tertinggi untuk meningkatkan kualitas video jika petunjuk KUALITAS ditetapkan.

Persyaratan

Header: Ksmedia.h (termasuk Ksmedia.h)