MediaCaptureSettings class

0 out of 1 rated this helpful - Rate this topic

Contains read-only configuration settings for the MediaCapture object.

Syntax


/* For information about creating or accessing this object, see Remarks. */

Attributes

DualApiPartitionAttribute()
MarshalingBehaviorAttribute(Standard)
ThreadingAttribute(MTA)
VersionAttribute(NTDDI_WIN8)

Members

The MediaCaptureSettings class has these types of members:

Methods

The MediaCaptureSettings class inherits methods from the Object class (C#/VB/C++).

Properties

The MediaCaptureSettings class has these properties.

PropertyAccess typeDescription

AudioDeviceId

Read-onlyGets the DeviceInformation.Id of the microphone.

PhotoCaptureSource

Read-onlyGets the stream that is used for photo capture.

StreamingCaptureMode

Read-onlyGets the streaming mode.

VideoDeviceCharacteristic

Read-onlyGets a value that indicates which video streams are independent of each other.

VideoDeviceId

Read-onlyGets the DeviceInformation.Id of the video camera.

 

Remarks

To get this object, retrieve the MediaCapture.MediaCaptureSettings property.

Note  : This class is not agile, which means that you need to consider its threading model and marshaling behavior. For more info, see Threading and Marshaling (C++/CX) and Using Windows Runtime objects in a multithreaded environment (.NET).

Examples

The following example shows how to create and set a MediaCaptureSettings. See Quickstart: capturing video using the MediaCapture API for the full example.


// Initialize the MediaCaptureInitialzationSettings.
function initCaptureSettings() {
    captureInitSettings = null;
    captureInitSettings = new Windows.Media.Capture.MediaCaptureInitializationSettings();
    captureInitSettings.audioDeviceId = "";
    captureInitSettings.videoDeviceId = "";
    captureInitSettings.streamingCaptureMode = Windows.Media.Capture.StreamingCaptureMode.audioAndVideo;
    captureInitSettings.photoCaptureSource = Windows.Media.Capture.PhotoCaptureSource.videoPreview;
    captureInitSettings.realTimeModeEnabled = true;
    if (deviceList.length > 0)
        captureInitSettings.videoDeviceId = deviceList[0].id;
}



See the Media Capture Sample for an example of using media capture.

Requirements

Minimum supported client

Windows 8 [Windows Store apps, desktop apps]

Minimum supported server

Windows Server 2012 [Windows Store apps, desktop apps]

Namespace

Windows.Media.Capture
Windows::Media::Capture [C++]

Metadata

Windows.winmd

Capabilities

webcam
microphone

 

 

Build date: 12/4/2012

Did you find this helpful?
(1500 characters remaining)
© 2013 Microsoft. All rights reserved.