MediaCapture.SetEncoderProperty(MediaStreamType, Guid, Object) Methode

Definition

Namespace:

Windows.Media.Capture

Legt eine Codierungseigenschaft fest.

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)

Parameter

mediaStreamType

MediaStreamType

Der Typ der Mediendaten, die der Stream darstellt, z. B. Video oder Audio.

propertyId

Guid

Platform::Guid

winrt::guid

Die festzulegende Codierungseigenschaft.

propertyValue

Object

Platform::Object

IInspectable

Der neue Wert der Codierungseigenschaft.

Windows-Anforderungen

App-Funktionen

backgroundMediaRecording microphone webcam

Hinweise

Sie können SetEncoderProperty nur aufrufen, wenn mediaStreamType gleich MediaStreamType.Audio ist, wenn die Encodereigenschaft nur auf den Audioencoder in der Datensatzsenke angewendet wird. Mit der Vorschausenke können Sie kein Codierungsprofil mit komprimiertem Audio festlegen.

Bei Nicht-H.264-Kameras wird die Eigenschaft lokal gespeichert, wenn Sie SetEncoderProperty aufrufen, bevor die Aufzeichnung oder Vorschau gestartet wurde. Wenn Sie mit der Aufzeichnung beginnen, wird die Eigenschaft zum Zeitpunkt der Encoderinitialisierung auf den Encoder angewendet. Zum Konfigurieren statischer Codierungseigenschaften müssen Sie SetEncoderProperty aufrufen, bevor die Aufzeichnung oder Vorschau gestartet wird. Vor Beginn der Aufzeichnung oder Vorschau gibt GetEncoderProperty den Wert der lokal gespeicherten Eigenschaft zurück.

Wenn die Kamera eine H.264-Kamera ist und der Stream, auf dem SetEncoderProperty aufgerufen wird, vom Typ MediaStreamType.VideoRecord ist, wird die Eigenschaft direkt auf die Kamera angewendet. Dies gilt sowohl vor als auch nach beginn der Aufzeichnung.

Wenn Sie bei Nicht-H.264-Kameras SetEncoderProperty aufrufen, nachdem Sie den Aufruf des Datensatzes oder der Vorschau gestarteten Abschlussrückrufs erhalten haben, wird die Eigenschaft direkt auf dem Encoder festgelegt und wird daher zum Konfigurieren dynamischer Codierungseigenschaften verwendet.

Wenn Sie SetEncoderProperty aufrufen, nachdem Sie einen Aufruf zum Starten der Aufzeichnung oder Vorschau ausgegeben haben, und bevor Sie den Rückruf für datensatz- oder vorschaubasierten Abschluss erhalten, erhalten Sie einen MF_E_INVALIDREQUEST Fehler, da die Eigenschaft nicht auf statische oder dynamische Einstellungen angewendet werden kann.

Um den Vorschaudatenstrom zu rotieren, verwenden Sie die GUID , die als MF_MT_VIDEO_ROTATION definiert ist. Anleitungen zur Handhabung der Ausrichtung bei Verwendung der Kamera finden Sie unter Behandeln der Geräteausrichtung mit MediaCapture.