VideoEncodingProperties Classe

Définition

Espace de noms:

Windows.Media.MediaProperties

Décrit les propriétés d’encodage d’un flux vidéo.

public ref class VideoEncodingProperties 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)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class VideoEncodingProperties 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)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class VideoEncodingProperties

function VideoEncodingProperties()

Public NotInheritable Class VideoEncodingProperties

Héritage

Object Platform::Object IInspectable VideoEncodingProperties

Attributs

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implémente

IMediaEncodingProperties

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Remarques

Les propriétés définies manuellement sont ignorées pour VideoEncodingProperties créées à partir de l’un des profils d’encodage prédéfinis : CreateH264 et CreateMpeg2.

La qualité d’encodage Auto est une présélection spéciale qui remplit les paramètres appropriés en fonction des paramètres actuels de l’appareil photo. Les paramètres modifiés manuellement sont ignorés. Par exemple, si vous créez un profil prédéfini à l’aide de l’une des méthodes de création statique, telles que CreateM4a, et que vous spécifiez Auto comme qualité d’encodage, toutes les modifications que vous apportez aux propriétés seront remplacées par des valeurs basées sur les paramètres de caméra actuels.

Notes

Il est possible de créer un VideoEncodingProperties qui n’est pas pris en charge sur un appareil particulier. Par exemple, vous pouvez appeler CreateH264, mais si aucun encodeur h264 n’est présent sur l’appareil, la tentative d’encodage vidéo avec les propriétés retournées par cette méthode échoue. Pour obtenir la liste des codecs présents par défaut pour chaque famille d’appareils, consultez Codecs pris en charge.

Pour obtenir des conseils pratiques sur la définition des propriétés d’encodage de la vidéo capturée, consultez Capture photo, vidéo et audio de base avec MediaCapture.

Historique des versions

Version de Windows	Version du SDK	Valeur ajoutée
1607	14393	StereoscopicVideoPackingMode
1703	15063	CreateHevc
1703	15063	SphericalVideoFrameFormat
1803	17134	Copier

Constructeurs

VideoEncodingProperties()

Crée une instance de la classe VideoEncodingProperties.

Propriétés

Bitrate	Obtient ou définit la vitesse de transmission vidéo.
FrameRate	Obtient ou définit la fréquence d’images vidéo.
Height	Obtient ou définit la hauteur de l’image vidéo.
PixelAspectRatio	Obtient ou définit les proportions des pixels.
ProfileId	Obtient ou définit le profil de format multimédia.
Properties	Obtient des propriétés de format supplémentaires pour le flux vidéo.
SphericalVideoFrameFormat	Obtient une valeur qui spécifie le format vidéo sphérique d’une trame vidéo.
StereoscopicVideoPackingMode	Obtient une valeur indiquant le mode d’empaquetage vidéo stéréoscopique du flux vidéo.
Subtype	Obtient ou définit le sous-type du format.
Type	Obtient le type de format.
Width	Obtient ou définit la largeur de l’image vidéo.

Méthodes

Copy()	Crée une copie de l’objet VideoEncodingProperties .
CreateAv1()	Crée une instance de VideoEncodingProperties pour une vidéo AOMedia Video 1 (AV1).
CreateH264()	Crée une instance de VideoEncodingProperties pour une vidéo H.264.
CreateHevc()	Crée un instance de VideoEncodingProperties pour le codage vidéo à haute efficacité (HEVC).
CreateMpeg2()	Crée une instance de VideoEncodingProperties pour une vidéo MPEG-2.
CreateUncompressed(String, UInt32, UInt32)	Crée une instance de VideoEncodingProperties pour une vidéo non compressée.
CreateVp9()	Crée un instance de VideoEncodingProperties pour une vidéo VP9.
GetFormatUserData(Byte[])	Obtient les données utilisateur au format multimédia.
SetFormatUserData(Byte[])	Définit les données utilisateur du format multimédia.

Voir aussi

• Capture photo, vidéo et audio de base à l’aide de MediaCapture