MediaCapture.FindKnownVideoProfiles(String, KnownVideoProfile) Method

Definition

Retrieves the list of all video profiles supported by the specified video capture device that match the specified KnownVideoProfile value.

public:
 static IVectorView<MediaCaptureVideoProfile ^> ^ FindKnownVideoProfiles(Platform::String ^ videoDeviceId, KnownVideoProfile name);
 static IVectorView<MediaCaptureVideoProfile> FindKnownVideoProfiles(winrt::hstring const& videoDeviceId, KnownVideoProfile const& name);
public static IReadOnlyList<MediaCaptureVideoProfile> FindKnownVideoProfiles(string videoDeviceId, KnownVideoProfile name);
function findKnownVideoProfiles(videoDeviceId, name)
Public Shared Function FindKnownVideoProfiles (videoDeviceId As String, name As KnownVideoProfile) As IReadOnlyList(Of MediaCaptureVideoProfile)

Parameters

videoDeviceId
String

The identifier of the video device for which supported video profiles are queried. For information on getting the video device ID, see DeviceInformation.FindAllAsync.

name
KnownVideoProfile

A value specifying one of the profile names known by the system.

Returns

IVectorView<MediaCaptureVideoProfile>

IReadOnlyList<MediaCaptureVideoProfile>

The list of video profiles supported by the specified video capture device that match the specified known profile name.

Windows requirements

App capabilities
backgroundMediaRecording

Remarks

Before calling this method, call IsVideoProfileSupported to make sure that the capture device supports video profiles.

This method allows you to request profiles with specific functionality by using one of the KnownVideoProfile values. Some hardware may support additional profiles that do not correspond to any of the known profile names. Use FindAllVideoProfiles to retrieve all video profiles supported by the video capture device.

For how-to guidance for working with camera profiles, see Discover and select camera capabilities with camera profiles.

Applies to

See also