MediaCapture.AddEffectAsync(MediaStreamType, String, IPropertySet) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Adds an audio or video effect.
public:
virtual IAsyncAction ^ AddEffectAsync(MediaStreamType mediaStreamType, Platform::String ^ effectActivationID, IPropertySet ^ effectSettings) = AddEffectAsync;/// [Windows.Foundation.Metadata.Deprecated("AddEffectAsync might not be available in future versions of Windows. Starting with Windows Threshold, use AddAudioEffectAsync and AddVideoEffectAsync instead", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, Windows.Foundation.UniversalApiContract)]
IAsyncAction AddEffectAsync(MediaStreamType const& mediaStreamType, winrt::hstring const& effectActivationID, IPropertySet const& effectSettings);/// [Windows.Foundation.Metadata.Deprecated("AddEffectAsync might not be available in future versions of Windows. Starting with Windows Threshold, use AddAudioEffectAsync and AddVideoEffectAsync instead", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.Foundation.UniversalApiContract")]
IAsyncAction AddEffectAsync(MediaStreamType const& mediaStreamType, winrt::hstring const& effectActivationID, IPropertySet const& effectSettings);[Windows.Foundation.Metadata.Deprecated("AddEffectAsync might not be available in future versions of Windows. Starting with Windows Threshold, use AddAudioEffectAsync and AddVideoEffectAsync instead", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, typeof(Windows.Foundation.UniversalApiContract))]
public IAsyncAction AddEffectAsync(MediaStreamType mediaStreamType, string effectActivationID, IPropertySet effectSettings);[Windows.Foundation.Metadata.Deprecated("AddEffectAsync might not be available in future versions of Windows. Starting with Windows Threshold, use AddAudioEffectAsync and AddVideoEffectAsync instead", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.Foundation.UniversalApiContract")]
public IAsyncAction AddEffectAsync(MediaStreamType mediaStreamType, string effectActivationID, IPropertySet effectSettings);function addEffectAsync(mediaStreamType, effectActivationID, effectSettings)Public Function AddEffectAsync (mediaStreamType As MediaStreamType, effectActivationID As String, effectSettings As IPropertySet) As IAsyncActionParameters
- mediaStreamType
- MediaStreamType
Specifies the streams to which the effect will be applied.
- effectActivationID
-
String
Platform::String
winrt::hstring
The class identifier of the activatable runtime class that implements the effect. The runtime class must implement the IMediaExtension interface.
- effectSettings
- IPropertySet
Configuration parameters for the effect.
Returns
Returns an IAsyncAction object that is used to control the asynchronous operation.
- Attributes
Windows requirements
| App capabilities |
backgroundMediaRecording
microphone
webcam
|
Remarks
As of Windows 10, this method is deprecated. Use AddAudioEffectAsync or AddVideoEffectAsync instead. For how-to guidance on adding effects to the camera capture and preview streams, see Effects for video capture.