Share via


CaptureDeviceConfiguration Class

Microsoft Silverlight will reach end of support after October 2021. Learn more.

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

'Declaration
Public NotInheritable Class CaptureDeviceConfiguration
public static class CaptureDeviceConfiguration

The CaptureDeviceConfiguration type exposes the following members.

Properties

  Name Description
Public propertyStatic memberSupported by Silverlight for Windows Phone 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
Public methodStatic memberSupported by Silverlight for Windows Phone GetAvailableAudioCaptureDevices Returns a collection of AudioCaptureDevice objects that represent the available audio capture devices on the client system.
Public methodStatic memberSupported by Silverlight for Windows Phone GetAvailableVideoCaptureDevices Returns a collection of VideoCaptureDevice objects that represent the available video capture devices on the client system.
Public methodStatic memberSupported by Silverlight for Windows Phone GetDefaultAudioCaptureDevice Returns the AudioCaptureDevice object that represent the default audio capture devices on the client system.
Public methodStatic memberSupported by Silverlight for Windows Phone GetDefaultVideoCaptureDevice Returns the VideoCaptureDevice object that represent the default video capture devices on the client system.
Public methodStatic memberSupported by Silverlight for Windows Phone 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 Silverlight 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

Silverlight

Supported in: 5, 4

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

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.