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