Bagikan melalui

KSPROPERTY_CAMERACONTROL_EXTENDED_IRTORCHMODE

  • Artikel

Kontrol properti yang diperluas ini digunakan oleh klien untuk mengontrol tingkat daya dan siklus tugas obor inframerah kamera IR. Ini dikirim ke driver bersama dengan struktur KSCAMERA_EXTENDEDPROP_HEADER standar diikuti dengan struktur KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING .

Tabel Ringkasan Penggunaan

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

Keterangan

Permintaan properti berisi struktur KSCAMERA_EXTENDEDPROP_HEADER dan struktur KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING .

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

Berikut ini adalah bendera yang dapat ditempatkan di KSCAMERA_EXTENDEDPROP_HEADER. Bendera dan KSCAMERA_EXTENDEDPROP_HEADER. Bidang kemampuan . Mereka mendefinisikan mode operasi obor IR.

Mode obor Deskripsi
KSCAMERA_EXTENDEDPROP_IRTORCHMODE_OFF Nonaktif
KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALWAYS_ON Selalu aktif
KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALTERNATING_FRAME_ILLUMINATION Aktif untuk setiap bingkai lainnya

KSCAMERA_EXTENDEDPROP_IRTORCHMODE selalu merupakan kontrol sinkron. Kontrol tidak memiliki perilaku yang ditentukan ketika kamera tidak mengalir.

Untuk permintaan GET, driver mengatur bidang berikut:

  • KSCAMERA_EXTENDEDPROP_HEADER. Kemampuan dengan bitmask bendera KSCAMERA_EXTENDEDPROP_IRTORCHMODE_XXX di atas mewakili mode operasi yang didukung oleh kamera.
  • KSCAMERA_EXTENDEDPROP_HEADER. Bendera ke salah satu bendera KSCAMERA_EXTENDEDPROP_IRTORCHMODE_XXX di atas untuk menunjukkan mode operasi saat ini.
  • KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. Mode ke 0.
  • KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. Min ke tingkat daya minimum yang tersedia.
  • KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. Maks ke tingkat daya maksimum yang tersedia.
  • KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. Melangkah ke tahapan minimum antara tingkat daya.
  • KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. VideoProc.ul ke tingkat daya saat ini. Nilai ini harus default ke tingkat daya yang sama yang biasanya digunakan oleh kontrol autentikasi wajah.

Untuk permintaan SET, driver menggunakan bidang berikut:

  • KSCAMERA_EXTENDEDPROP_HEADER. Bendera untuk mengatur mode operasi.
  • KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. VideoProc.ul untuk mengatur tingkat daya. Nilai ini tidak berpengaruh pada KSCAMERA_EXTENDEDPROP_IRTORCHMODE_OFF.

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

Anggota Deskripsi

Versi

Ini harus 1.

PinId

KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF).

Ukuran

Ini harus ukuranof(KSCAMERA_EXTENDEDPROP_HEADER)+sizeof([KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING](/windows-hardware/drivers/ddi/ksmedia/ns-ksmedia-tagkscamera_extendedprop_videoprocsetting)),

Hasil

Nilai ini diabaikan untuk kontrol sinkron.

Kemampuan

Mungkin kombinasi KSCAMERA_EXTENDEDPROP_IRTORCHMODE_OFF, KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALWAYS_ON , atau KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALTERNATIVE_FRAME_ILLUMINATION. Bidang ini harus melaporkan setidaknya satu kapabilitas. Bidang harus melaporkan KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALWAYS_ON atau KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALTERNATIVE_FRAME_ILLUMINATION atau keduanya. Nilai KSCAMERA_EXTENDEDPROP_IRTORCHMODE_OFF bersifat opsional.

Bendera

Harus salah satu bendera yang dilaporkan dalam Kapabilitas. Nilai default harus berupa KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALWAYS_ON atau KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALTERNATIVE_FRAME_ILLUMINATION.

Tabel di bawah ini berisi deskripsi dan persyaratan untuk bidang struktur KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING saat menggunakan kontrol mode obor IR.

Anggota Deskripsi

Mode

Tidak digunakan. Harus 0.

Min/Maks/Langkah

Min/Maks/Langkah berisi minimum/maksimum/kenaikan pengaturan daya runtime integrasi. Driver harus mengembalikannya untuk operasi GET. (Maks – Min) harus dapat dibagi secara merata berdasarkan Langkah. Langkah mungkin bukan nol (0).

VideoProc

Untuk operasi SET, VideoProc.Value.ul harus menentukan tingkat daya dalam rentang yang dijelaskan oleh parameter Min/Max/Step. Untuk operasi GET, driver harus mengembalikan tingkat daya saat ini.

Dicadangkan

Tidak digunakan. Harus diabaikan oleh driver.

Persyaratan

Header

 Ksmedia.h