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 | |
|---|---|---|
.gif "Public property") .gif "Static member") .gif "Supported 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 | |
|---|---|---|
.gif "Public method") |
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 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.