struktur KSCAMERA_MAXVIDEOFPS_FORPHOTORES (ksmedia.h)

  • Artikel

Struktur KSCAMERA_MAXVIDEOFPS_FORPHOTORES berisi data properti untuk kecepatan bingkai maksimum pada resolusi tertentu untuk pratinjau dan pengambilan pendukung kamera. Struktur ini digunakan saat mengatur atau mengambil data untuk properti kontrol KSPROPERTY_CAMERACONTROL_EXTENDED_MAXVIDFPS_PHOTORES diperluas.

Sintaks

typedef struct tagKSCAMERA_MAXVIDEOFPS_FORPHOTORES {
  ULONG PhotoResWidth;
  ULONG PhotoResHeight;
  ULONG PreviewFPSNum;
  ULONG PreviewFPSDenom;
  ULONG CaptureFPSNum;
  ULONG CaptureFPSDenom;
} KSCAMERA_MAXVIDEOFPS_FORPHOTORES, *PKSCAMERA_MAXVIDEOFPS_FORPHOTORES;

Anggota

PhotoResWidth

Lebar resolusi foto dalam piksel.

PhotoResHeight

Tinggi resolusi foto dalam piksel.

PreviewFPSNum

Nilai pembilai dari kecepatan bingkai pratinjau.

PreviewFPSDenom

Nilai denominator dari kecepatan bingkai pratinjau.

CaptureFPSNum

Nilai pembimbing dari laju bingkai pengambilan.

CaptureFPSDenom

Nilai denominator laju bingkai pengambilan.

Keterangan

Saat mengatur properti, menggunakan permintaan KSPROPERTY_TYPE_SET, anggota PhotoResWidth dan PhotoResHeight disediakan oleh aplikasi berdasarkan jenis media foto yang tersedia. Driver kamera harus menyimpan informasi resolusi ini secara internal. Anggota laju bingkai pratinjau dan pengambilan harus diabaikan oleh driver pada permintaan KSPROPERTY_TYPE_SET.

Untuk setiap permintaan KSPROPERTY_TYPE_GET berikutnya, driver kamera, berdasarkan resolusi yang disediakan dalam permintaan KSPROPERTY_TYPE_SET sebelumnya, harus memberikan kecepatan bingkai untuk pratinjau dan menangkap aliran. Selain itu, driver kamera harus mengatur PhotoResWidth dan PhotoResHeight ke resolusi yang disediakan dengan permintaan KSPROPERTY_TYPE_SET.

Jika tidak ada permintaan KSPROPERTY_TYPE_SET yang dibuat untuk sesi tersebut, driver kamera mengatur semua anggota struktur KSCAMERA_MAXVIDEOFPS_FORPHOTORES ke 0.

Jika pratinjau atau pengambilan tidak didukung, seperti kasus ketika kamera adalah kamera yang disematkan ganda hanya dengan satu pin video, itu harus menggunakan anggota CaptureFPSNum dan CaptureFPSDenom dan mengatur anggota PreviewFPSNum dan PreviewFPSDenom ke 0.

Jika KSCAMERA_EXTENDEDPROP_PHOTOMODE_SEQUENCE didukung pada Kontrol Mode Foto oleh driver kamera, kontrol ini wajib.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 8.1
Server minimum yang didukung Windows Server 2012 R2
Header ksmedia.h (termasuk Ksmedia.h)