CaptureDeviceConfiguration Class

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

Represents a helper class for obtaining information about available capture devices (audio or video) and requesting client user permission to access the captures from available devices.

Inheritance Hierarchy

System..::.Object
System.Windows.Media..::.CaptureDeviceConfiguration

Namespace: System.Windows.Media
Assembly: System.Windows (in System.Windows.dll)

Syntax

Public NotInheritable Class CaptureDeviceConfiguration
public static class CaptureDeviceConfiguration

The CaptureDeviceConfiguration type exposes the following members.

Properties

Name Description
AllowedDeviceAccess Gets a value that reports whether a user has previously granted device access based on their stored response to the device access UI prompt.

Top

Methods

Name Description
GetAvailableAudioCaptureDevices Returns a collection of AudioCaptureDevice objects that represent the available audio capture devices on the client system.
GetAvailableVideoCaptureDevices Returns a collection of VideoCaptureDevice objects that represent the available video capture devices on the client system.
GetDefaultAudioCaptureDevice Returns the AudioCaptureDevice object that represent the default audio capture devices on the client system.
GetDefaultVideoCaptureDevice Returns the VideoCaptureDevice object that represent the default video capture devices on the client system.
RequestDeviceAccess Requests access for all possible capture devices (audio or video) that are available on the client system.

Top

Remarks

Client user permission to access the captures from available devices is scoped by sites in domains, and must be enabled per session.

If multiple devices are available, the user can select the device to use as part of the Windows Phone configuration dialog (Webcam/Mic tab). In configuration UI, audio devices and video devices are listed separately and each can have a default. If a device is unavailable in the configuration UI, no CaptureDevice instance represents it.

On some systems, audio devices are not reported unless a microphone is plugged in and enabled; the presence of a sound card but no plugged-in microphone for it does not appear as an audio capture device in the list.

Version Information

Windows Phone OS

Supported in: 8.1, 8.0, 7.1

Platforms

Windows Phone

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

See Also

Reference

System.Windows.Media Namespace

CaptureDevice..::.FriendlyName