Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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)