Share via

IPropertyStore Interface

  • Article

Kinect for Windows 1.6, 1.7, 1.8

Provides a property store for the KinectAudio DMO configuration properties.

Syntax

interface IPropertyStore : public IUnknown

Remarks

This interface provides a property store for the KinectAudio DMO configuration properties. Methods for this interface can be found here. For more information, see Audio Stream.

The KinectAudio DMO configuration properties are the same as those for the standard Windows 7 and Windows 8 Voice Capture DMO. These configuration properties are here. The defaults for the KinectAudio DMO configuration properties are the same as those for the standard Windows 7 and Windows 8 Voice Capture DMO.

The Kinect for Windows samples use the following properties.

Note

The KinectAudio DMO is NOT restricted to just these properties; these are just the most commonly used ones.

Property Name Purpose Default Setting
MFPKEY_WMAAECMA_FEATR_AES Specifies how many times the DMO performs acoustic echo suppression (AES) on the residual signal.

0. Before setting this property, you must set the MFPKEY_WMAAECMA_FEATURE_MODE property to VARIANT_TRUE.
MFPKEY_WMAAECMA_FEATR_AGC Specifies whether the DMO performs automatic gain control. VARIANT_FALSE. (Disable gain control).
MFPKEY_WMAAECMA_FEATR_FRAME_SIZE Specifies the audio frame size.

The acoustic echo cancellation (AEC) algorithm processes PCM audio samples one frame at a time. The value of this property is the size of the audio frame, in samples. Before setting this property, you must set the MFPKEY_WMAAECMA_FEATURE_MODE property to VARIANT_TRUE.

If the processing mode is microphone array only, the default value is 320 samples. For all other processing modes, the default value is 160 samples.
MFPKEY_WMAAECMA_FEATR_NS Specifies whether the DMO performs noise suppression. 1. (Enable noise suppression.)
MFPKEY_WMAAECMA_FEATURE_MODE Enables the application to override the default settings on various properties of the DMO. VARIANT_FALSE.
MFPKEY_WMAAECMA_SYSTEM_MODE Sets the processing mode for the KinectAudio DMO.

No default. You must set this property before using the DMO. After you set this property, you can use the DMO with its default settings, or set additional properties.

For a description of IUnknown, see the IUnknown interface.

Requirements

Header: Declared in NuiSensor.h.