struktur KSCAMERA_PROFILE_INFO (ksmedia.h)

Struktur KSCAMERA_PROFILE_INFO digunakan untuk mengidentifikasi profil tertentu secara unik.

Sintaks

typedef struct _KSCAMERA_PROFILE_INFO {
  GUID                      ProfileId;
  UINT32                    Index;
  UINT32                    PinCount;
  PKSCAMERA_PROFILE_PININFO Pins;
} KSCAMERA_PROFILE_INFO, *PKSCAMERA_PROFILE_INFO;

Anggota

ProfileId

GUID mewakili ID unik untuk profil. GUID ini mungkin GUID yang dibuat IHV/OEM unik yang mewakili profil kustom atau mungkin GUID yang telah ditentukan sebelumnya.

Bidang ini tidak boleh diatur ke KSCAMERAPROFILE_Legacy. Profil warisan tidak boleh diterbitkan oleh driver kamera. ID profil warisan akan dikirim ke driver kamera selama inisialisasi pengambilan mesin/media penangkapan jika aplikasi belum menunjukkan bahwa aplikasi dapat mendukung profil.

Dalam kasus seperti itu, driver kamera harus mengembalikan perilakunya ke mode operasi Windows 8.1 dan hanya mengekspos jenis media set yang dikurangi bersama dengan KSPROPERTY_CAMERACONTROL_IMAGE_PIN_CAPABILITY_EXCLUSIVE_WITH_RECORD dan KSPROPERTY_CAMERACONTROL_IMAGE_PIN_CAPABILITY_SEQUENCE_EXCLUSIVE_WITH_RECORD yang sesuai bit kemampuan yang menunjukkan apakah driver kamera mampu mendukung urutan perekaman/foto dan/atau perekaman/foto secara bersamaan dalam jenis media set yang dikurangi.

Index

Setiap profil dalam grup ProfileId tertentu harus memiliki nilai Indeks yang unik. Ini memungkinkan profil apa pun untuk perangkat diidentifikasi secara unik dengan ProfileId + Index.

PinCount

Jumlah struktur KSCAMERA_PROFILE_PININFO yang diacu oleh Pin. Nilai ini harus lebih besar dari 0.

Pins

Array struktur KSCAMERA_PROFILE_PININFO yang menentukan jenis media yang didukung pada setiap pin profil ini. Bidang ini tidak boleh NULL.

Persyaratan

Persyaratan	Nilai
Header	ksmedia.h (termasuk Ksmedia.h)