KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOCONFIRMATION
The KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOCONFIRMATION property ID that is defined in the KSPROPERTY_CAMERACONTROL_EXTENDED_PROPERTY enumeration is used to set and get the photo confirmation settings in the driver.
Usage summary table
Scope | Control | Type |
---|---|---|
Version 1 |
Filter |
Synchronous |
For the KSCAMERA_EXTENDEDPROP_HEADER, the following flag values are used to turn photo confirmation on or off. By default, the driver should have KSPROPERTY_PHOTOCONFIRMATION_ON set. The flag values are defined as follows.
#define KSCAMERA_EXTENDEDPROP_PHOTOCONFIRMATION_OFF 0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_PHOTOCONFIRMATION_ON 0x0000000000000001
If the photo confirmation is set to KSCAMERA_EXTENDEDPROP_PHOTOCONFIRMATION_OFF, the driver preview pin must not produce a photo frame or produce the KSCAMERA_METADATA_PHOTOCONFIRMATION structure that contains photo confirmation metadata. If the photo confirmation is set to KSCAMERA_EXTENDEDPROP_PHOTOCONFIRMATION_ON, the driver preview pin must produce a photo frame and produce the KSCAMERA_METADATA_PHOTOCONFIRMATION structure that contains photo confirmation metadata.
The table below contains the descriptions and requirements for the KSCAMERA_EXTENDEDPROP_HEADER structure fields when using the KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOCONFIRMATION property.
Member | Description |
---|---|
Version |
This must be 1, |
PinId |
This must be KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF), |
Size |
This must be sizeof(KSCAMERA_EXTENDEDPROP_HEADER)+sizeof(KSCAMERA_EXTENDEDPROP_VALUE). |
Result |
This contains the error results of the last SET operation. If no SET operation has taken place, this must be 0. |
Capability |
This must be 0. |
Flags |
This is a read/write field. This can be any of the KSCAMERA_EXTENDEDPROP_PHOTOCONFIRMATION_Xxx flags defined above. |
Requirements
Header |
Ksmedia.h |