MediaCapture.InitializeAsync(MediaCaptureInitializationSettings) | initializeAsync(MediaCaptureInitializationSettings) method

Initializes the MediaCapture object.

Syntax

mediaCapture.initializeAsync(mediaCaptureInitializationSettings).done( /* Your success and error handlers */ );

Parameters

mediaCaptureInitializationSettings

Type: MediaCaptureInitializationSettings

The initialization settings.

Return value

Type: IAsyncAction

Returns a IAsyncAction object that is used to control the asynchronous operation.

Remarks

InitializeAsync will launch a consent prompt to get the user's permission for the app to access the microphone or camera. InitializeAsync should be called from the main UI thread of your app. For more information, see Guidelines for enabling sensitive devices.

In apps that use C# or C++ in Windows 8, the first use of the MediaCapture object to call InitializeAsync should be on the STA thread. Calls from an MTA thread may result in undefined behavior.

Examples

The following example creates a MediaCapture object and calls InitializeAsync to initialize it with MediaCaptureInitializationSettings.

// Create and initialze the MediaCapture object.
function initMediaCapture() {
    oMediaCapture = null;
    oMediaCapture = new Windows.Media.Capture.MediaCapture();
    oMediaCapture.initializeAsync(captureInitSettings).then (function (result) {
       createProfile();
    }, errorHandler);    
}

Requirements

See also

MediaCapture

InitializeAsync

Guidelines for enabling sensitive devices

Build date: 12/4/2012