KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOMODE
This property sets or retrieves the photo mode setting for the camera.
Usage summary table
| Get | Set | Target | Property descriptor type | Property value type |
|---|---|---|---|---|
| Yes | Yes | Filter | KSPROPERTY | KSCAMERA_EXTENDEDPROP_HEADER |
The property value (operation data) contains a KSCAMERA_EXTENDEDPROP_HEADER structure and a KSCAMERA_EXTENDEDPROP_PHOTOMODE structure. These specify the photo mode and the history frame counts when sequence mode is set.
The desired photo mode is set in the Flags member of KSCAMERA_EXTENDEDPROP_HEADER. The photo mode is set to one of the following.
| Photo mode | Description |
|---|---|
| KSCAMERA_EXTENDEDPROP_PHOTOMODE_NORMAL | Normal still photo operation |
| KSCAMERA_EXTENDEDPROP_PHOTOMODE_SEQUENCE | Photo sequence capture operation |
The total property data size is sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_PHOTOMODE). The Size member of KSCAMERA_EXTENDEDPROP_HEADER is set to this total property data size.
Note
Setting the photo mode is an asynchronous control operation and KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL must be set in the Capability member of KSCAMERA_EXTENDEDPROP_HEADER.
Remarks
When responding to a KSPROPERTY_TYPE_GET request, the driver sets the members of the KSCAMERA_EXTENDEDPROP_HEADER to the following.
| Member | Value |
|---|---|
| Version | 1 |
| PinId | The pin ID for the photo pin |
| Size | sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_PHOTOMODE) |
| Result | An error value resulting from the attempt to acquire the photo mode data. Otherwise, 0. |
| Capability | KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL |
| Flags | Current photo mode |
Requirements
Version: Available starting with Windows 8.1
Header: Ksmedia.h (include Ksmedia.h)