MediaCapture.SetEncoderProperty(MediaStreamType, Guid, Object) Méthode

Définition

Espace de noms:

Windows.Media.Capture

Définit une propriété d’encodage.

public:
 virtual void SetEncoderProperty(MediaStreamType mediaStreamType, Platform::Guid propertyId, Platform::Object ^ propertyValue) = SetEncoderProperty;

void SetEncoderProperty(MediaStreamType const& mediaStreamType, winrt::guid const& propertyId, IInspectable const& propertyValue);

public void SetEncoderProperty(MediaStreamType mediaStreamType, Guid propertyId, object propertyValue);

function setEncoderProperty(mediaStreamType, propertyId, propertyValue)

Public Sub SetEncoderProperty (mediaStreamType As MediaStreamType, propertyId As Guid, propertyValue As Object)

Paramètres

mediaStreamType

MediaStreamType

Type de données multimédias que le flux représente, comme la vidéo ou l’audio.

propertyId

Guid

Platform::Guid

winrt::guid

Propriété d’encodage à définir.

propertyValue

Object

Platform::Object

IInspectable

Nouvelle valeur de la propriété d’encodage.

Configuration requise pour Windows

Fonctionnalités de l’application

backgroundMediaRecording microphone webcam

Remarques

Vous pouvez uniquement appeler SetEncoderProperty avec mediaStreamType égal à MediaStreamType.Audio, si la propriété d’encodeur est appliquée uniquement à l’encodeur audio dans le récepteur d’enregistrements. Le récepteur d’aperçu ne vous permet pas de définir un profil d’encodage avec de l’audio compressé.

Pour les caméras non-H.264, lorsque vous appelez SetEncoderProperty avant le démarrage de l’enregistrement ou de l’aperçu, la propriété est stockée localement. Lorsque vous commencez l’enregistrement, la propriété est appliquée à l’encodeur au moment de l’initialisation de l’encodeur. Pour configurer les propriétés d’encodage statique, vous devez appeler SetEncoderProperty avant le démarrage de l’enregistrement ou de l’aperçu. Avant le démarrage de l’enregistrement ou de l’aperçu, GetEncoderProperty retourne la valeur de la propriété stockée localement.

Si la caméra est une caméra H.264 et que le flux sur lequel SetEncoderProperty est appelé est de type MediaStreamType.VideoRecord, la propriété est appliquée directement à la caméra. Cela est vrai avant et après le démarrage de l’enregistrement.

Pour les caméras non-H.264, lorsque vous appelez SetEncoderProperty après avoir obtenu le rappel d’achèvement de l’enregistrement ou de l’aperçu démarré, la propriété est définie directement sur l’encodeur et est donc utilisée pour configurer les propriétés d’encodage dynamique.

Si vous appelez SetEncoderProperty après avoir lancé un appel pour démarrer l’enregistrement ou l’aperçu et avant que vous obteniez l’enregistrement ou le rappel d’achèvement de l’aperçu, vous recevrez une erreur MF_E_INVALIDREQUEST , car la propriété ne peut pas être appliquée aux paramètres statiques ou dynamiques.

Pour faire pivoter le flux d’aperçu, utilisez le GUID défini comme MF_MT_VIDEO_ROTATION. Pour obtenir des conseils pratiques sur la gestion de l’orientation lors de l’utilisation de l’appareil photo, consultez Gérer l’orientation de l’appareil avec MediaCapture.