MF_CAPTURE_METADATA_FRAME_ILLUMINATION attribute

[Some information relates to pre-released product which may be substantially modified before it's commercially released. Microsoft makes no warranties, express or implied, with respect to the information provided here.]

A value indicating whether a frame was captured using active infrared (IR) illumination.

Data type

UINT64

Remarks

This attribute is a bitmask. It is a 64 bit value for backward compatibility.

Active illumination is when a device has a light emitter close to the IR camera emitting a beam of light to illuminate the scene, typically emitting IR light so it won’t disturb human eyes. Set value to (value & 0x1) != 0 if frame was captured when active illumination was on and set (value & 0x1) == 0 if active illumination was off.

Requirements

Requirement Value
Minimum supported client
Windows 10, version 1709 [desktop apps only]
Minimum supported server
Windows Server, version 1709 [desktop apps only]
Header
Mfapi.h