Edit

Share via

KSCAMERA_PROFILE_INFO structure (ksmedia.h)

  • Article

The KSCAMERA_PROFILE_INFO structure is used to uniquely identify a given profile.

Syntax

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

Members

ProfileId

GUID representing a unique ID for the profile. This GUID may be a unique IHV/OEM created GUID representing a custom profile or it may a pre-defined GUID.

This field must not be set to KSCAMERAPROFILE_Legacy. The legacy profile must not be published by the camera driver. The legacy profile ID will be sent to the camera driver during capture engine/media capture initialization if the application has not indicated that it can support profiles.

In such cases, the camera driver must revert its behavior to the Windows 8.1 mode of operation and expose only the reduced set media types along with the corresponding KSPROPERTY_CAMERACONTROL_IMAGE_PIN_CAPABILITY_EXCLUSIVE_WITH_RECORD and KSPROPERTY_CAMERACONTROL_IMAGE_PIN_CAPABILITY_SEQUENCE_EXCLUSIVE_WITH_RECORD capability bits indicating whether the camera driver is capable of supporting simultaneous recording/photo and/or recording/photo sequence within the reduced set media type.

Index

Each profile within a given ProfileId group must have a unique Index value. This allows any profile for a device to be uniquely identified with ProfileId + Index.

PinCount

The number of KSCAMERA_PROFILE_PININFO structures pointed to by Pins. This value must be greater than 0.

Pins

An array of KSCAMERA_PROFILE_PININFO structures defining the supported media types on each of the pins of this profile. This field must not be NULL.

Requirements

Requirement Value
Header ksmedia.h (include Ksmedia.h)