MediaCaptureInitializationSettings.VideoProfile Propriété

Définition

Espace de noms:

Windows.Media.Capture

Obtient ou définit le profil vidéo qui fournit des conseils au pilote pour lui permettre d’optimiser pour différents scénarios de capture.

public:
 property MediaCaptureVideoProfile ^ VideoProfile { MediaCaptureVideoProfile ^ get(); void set(MediaCaptureVideoProfile ^ value); };

MediaCaptureVideoProfile VideoProfile();

void VideoProfile(MediaCaptureVideoProfile value);

public MediaCaptureVideoProfile VideoProfile { get; set; }

var mediaCaptureVideoProfile = mediaCaptureInitializationSettings.videoProfile;
mediaCaptureInitializationSettings.videoProfile = mediaCaptureVideoProfile;

Public Property VideoProfile As MediaCaptureVideoProfile

Valeur de propriété

MediaCaptureVideoProfile

Profil vidéo.

Configuration requise pour Windows

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 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 les scénarios courants, tels que la capture de photos de haute qualité pendant la capture vidéo ou la vidéoconférence. Pour obtenir la liste des profils vidéo connus pour un périphérique 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. Pour plus d’informations sur les profils vidéo, consultez MediaCaptureVideoProfile.

La valeur que vous utilisez pour cette propriété détermine comment le système gère les valeurs des autres propriétés de MediaCaptureInitializationSettings.

• Si vous définissez VideoProfile sur un objet MediaCaptureVideoProfile valide, le système utilise les indicateurs de pilote associés au profil et utilise les valeurs de description du média que vous spécifiez pour les propriétés PhotoMediaDescription, PreviewMediaDescription et RecordMediaDescription .
• Si vous définissez VideoProfile sur un objet MediaCaptureVideoProfile valide et que vous ne définissez pas les propriétés PhotoMediaDescription, PreviewMediaDescription ou RecordMediaDescription , le système utilise les indicateurs de pilote associés au profil et utilise la première entrée (0 index) dans les propriétés SupportedPhotoMediaDescription, SupportedPreviewMediaDescription et SupportedRecordMediaDescription du profil. répertorie en tant que description du média pour les propriétés respectives.
• Si la valeur de VideoProfile n’est pas définie du tout, le système ignore la valeur de PhotoMediaDescription, PreviewMediaDescription et RecordMediaDescription et rétablit le comportement hérité avant l’introduction des API de profil vidéo.

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 de profils vidéo, consultez Découvrir et sélectionner des fonctionnalités d’appareil photo avec des profils d’appareil photo