Edit

KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOCONFIRMATION

  • Article

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