struktur KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_S (ksmedia.h)

Menjelaskan properti kontrol wilayah yang menarik (ROI) dalam kumpulan properti kontrol kamera PROPSETID_VIDCAP_CAMERACONTROL_REGION_OF_INTEREST . Wilayah yang diminati adalah persegi panjang dalam gambar yang digunakan untuk memfokuskan kamera. Struktur ini menentukan nilai properti yang digunakan dalam permintaan ke driver kamera.

Sintaks

typedef struct {
  RECT  FocusRect;
  BOOL  AutoFocusLock;
  BOOL  AutoExposureLock;
  BOOL  AutoWhitebalanceLock;
  union {
    ULONG Capabilities;
    ULONG Configuration;
  };
} KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_S, *PKSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_S;

Anggota

FocusRect

Struktur RECT yang menentukan wilayah persegi panjang tempat perangkat harus mengatur fokus. Struktur ini hanya tersedia untuk aplikasi Windows.

Jika FocusRect bukan nilai yang valid, atau jika semua anggota struktur RECT nol, perangkat harus memfokuskan pusat gambar dan anggota struktur ini yang tersisa dapat diabaikan.

Koordinat persegi panjang berkaitan dengan resolusi video pratinjau.

AutoFocusLock

Jika TRUE, perangkat harus mengunci fokus ke nilai saat ini.

Anggota ini harus diabaikan jika FocusRect bukan nilai yang valid.

AutoExposureLock

Jika TRUE, perangkat harus mengunci paparan ke nilai saat ini.

Anggota ini harus diabaikan jika FocusRect bukan nilai yang valid.

AutoWhitebalanceLock

Jika TRUE, perangkat harus mengunci pengaturan keseimbangan putih ke nilai saat ini.

Anggota ini harus diabaikan jika FocusRect bukan nilai yang valid.

Capabilities

Menunjukkan apakah perangkat dan driver mendukung pengaturan wilayah yang menarik secara otomatis atau manual. Anggota ini bitwise ATAU dari nilai-nilai yang mungkin ini:

Nilai	Makna
KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_FLAGS_AUTO	Perangkat dan driver dapat secara otomatis mengatur wilayah yang diinginkan.
KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_FLAGS_MANUAL	Pengguna dapat mengatur wilayah yang diminati secara manual.
KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_FLAGS_ASYNC	Fitur kontrol ROI dijalankan secara asinkron. Kemampuan ini tersedia dimulai dengan Windows 8.1.

Configuration

Bendera konfigurasi untuk operasi kontrol untuk wilayah tersebut. Ini adalah kombinasi bitwise OR dari nilai berikut.

Anggota ini tersedia dimulai dengan Windows 8.1.

Nilai	Makna
KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_CONFIG_FOCUS	Atur fokus otomatis untuk wilayah tersebut.
KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_CONFIG_EXPOSURE	Atur paparan otomatis untuk wilayah tersebut.
KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_CONFIG_WB	Atur keseimbangan putih otomatis untuk wilayah tersebut.
KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_CONVERGEMODE	Aktifkan konvergensi objek di wilayah tersebut.

Persyaratan

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

Lihat juga

KSPROPERTY_CAMERACONTROL_FLASH_PROPERTY

RECT