Partager via


MediaCaptureVideoProfile Classe

Définition

Représente un profil vidéo qui indique une configuration prise en charge par l’appareil de capture vidéo.

public ref class MediaCaptureVideoProfile sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class MediaCaptureVideoProfile final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class MediaCaptureVideoProfile
Public NotInheritable Class MediaCaptureVideoProfile
Héritage
Object Platform::Object IInspectable MediaCaptureVideoProfile
Attributs

Configuration requise pour Windows

Famille d’appareils
Windows 10 (introduit dans 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v1.0)
Fonctionnalités de l’application
backgroundMediaRecording

Remarques

Les profils vidéo fournissent un moyen simple de configurer l’appareil de capture vidéo avec un groupe de paramètres qui fonctionnent avec un appareil de capture particulier et qui sont optimisés pour le scénario de capture souhaité. Il existe un ensemble de profils vidéo connus que le système fournit pour des scénarios courants, tels que la capture de photos ou de vidéos de haute qualité, la capture d’une séquence photo ou la visioconférence. Pour obtenir la liste des profils vidéo connus pour un appareil vidéo donné, utilisez MediaCapture.FindKnownVideoProfiles. Certains fournisseurs de matériel peuvent exposer d’autres profils vidéo que vous pouvez obtenir en appelant MediaCapture.FindAllVideoProfiles.

Un profil vidéo expose trois listes d’objets MediaCaptureVideoProfileMediaDescription , SupportedPhotoMediaDescription, SupportedPreviewMediaDescription et SupportedRecordMediaDescription. Chaque élément de ces listes est un groupe de paramètres pris en charge pour l’opération correspondante. Par exemple, un profil vidéo unique peut prendre en charge l’enregistrement vidéo 720p à 30 fps avec la prise en charge de la vidéo HDR et également l’enregistrement vidéo 1080p à 30 fps sans prise en charge de la vidéo HDR. Dans ce cas, chacun d’eux est représenté par un objet MediaCaptureVideoProfileMediaDescription dans la liste SupportedRecordMediaDescription du profil vidéo.

Vous configurez l’appareil de capture pour utiliser un profil vidéo particulier à l’aide de l’objet MediaCaptureInitializationSettings . Il est important que le profil vidéo que vous utilisez lors de la configuration de l’appareil soit compatible avec les autres paramètres d’initialisation. Pour plus d’informations sur l’utilisation correcte des descriptions de profil multimédia dans MediaCaptureInitializationSettings, consultez MediaCaptureInitializationSettings.VideoProfile.

Avant d’utiliser des profils vidéo, vous devez case activée la valeur retournée par MediaCapture.IsVideoProfileSupported pour vous assurer que les profils vidéo sont pris en charge par l’appareil de capture.

Pour obtenir des conseils pratiques sur l’utilisation des profils vidéo, consultez Découvrir et sélectionner des fonctionnalités d’appareil photo avec des profils d’appareil photo.

Historique des versions

Version de Windows Version du SDK Valeur ajoutée
1803 17134 FrameSourceInfos
1803 17134 Propriétés

Propriétés

FrameSourceInfos

Obtient une liste en lecture seule d’objets MediaFrameSourceInfo qui fournissent des détails sur les fonctionnalités d’un MediaFrameSource.

Id

Obtient l’identificateur unique du profil vidéo.

Properties

Obtient une carte en lecture seule des attributs personnalisés fournis par le fabricant de l’appareil de capture.

SupportedPhotoMediaDescription

Obtient la liste des objets MediaCaptureVideoProfileMediaDescription qui représentent les paramètres d’appareil vidéo pris en charge pour la capture photo.

SupportedPreviewMediaDescription

Obtient la liste des objets MediaCaptureVideoProfileMediaDescription qui représentent les paramètres d’appareil vidéo pris en charge pour la préversion vidéo.

SupportedRecordMediaDescription

Obtient la liste des objets MediaCaptureVideoProfileMediaDescription qui représentent les paramètres d’appareil vidéo pris en charge pour l’enregistrement vidéo.

VideoDeviceId

Obtient l’ID d’appareil de l’appareil vidéo associé au profil vidéo.

Méthodes

GetConcurrency()

Obtient la liste des objets MediaCaptureVideoProfile qui peuvent être utilisés simultanément avec ce profil vidéo.

S’applique à

Voir aussi