struktur KSCAMERA_EXTENDEDPROP_HEADER (ksmedia.h)

Struktur KSCAMERA_EXTENDEDPROP_HEADER adalah header payload untuk properti kontrol yang diperluas.

Sintaks

typedef struct tagKSCAMERA_EXTENDEDPROP_HEADER {
  ULONG     Version;
  ULONG     PinId;
  ULONG     Size;
  ULONG     Result;
  ULONGLONG Flags;
  ULONGLONG Capability;
} KSCAMERA_EXTENDEDPROP_HEADER, *PKSCAMERA_EXTENDEDPROP_HEADER;

Anggota

Version

Nomor versi properti yang diperluas. Ini diatur ke 1.

PinId

ID pin yang sesuai dengan properti . Jika PinId diatur ke (ULONG)-1, kontrol berlaku untuk filter. Jika tidak, driver kamera harus merutekan kontrol ini ke pin yang sesuai saat pin tersebut dibuat (atau jika sudah tersedia).

Size

Ukuran total, dalam byte dari seluruh payload. Ini termasuk struktur KSCAMERA_EXTENDEDPROP_HEADER dan data payload khusus kontrol berikut.

Result

Untuk operasi yang ditetapkan, ini adalah 0. Untuk kueri, Hasil berisi kode kegagalan yang disediakan driver untuk operasi kontrol terbaru.

Flags

Pengaturan dalam Bendera dapat bervariasi tergantung pada kontrol.

Bit urutan tinggi dari nilai Bendera dicadangkan. Bit ini berfungsi sebagai bendera pembatalan dan didefinisikan sebagai KSCAMERA_EXTENDEDPROP_FLAG_CANCELOPERATION. Bendera ini hanya bermakna untuk kontrol asinkron.

Capability

Anggota ini baca saja dan menunjukkan kemampuan standar kontrol.

Kapabilitas berikut didefinisikan.

Nilai	Deskripsi
KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL	Kontrol mendukung operasi asinkron.
KSCAMERA_EXTENDEDPROP_CAPS_CANCELLABLE	Hanya berlaku untuk kontrol asinkron. Bendera ini menandai operasi kontrol sebagai dapat dibatalkan. Jika kontrol sinkron mengatur bendera ini, kontrol tersebut ditandai sebagai tidak valid dan tidak diekspos ke aplikasi tingkat yang lebih tinggi.

Persyaratan

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

Lihat juga

KSCAMERA_EXTENDEDPROP_VALUE