MediaCapture.SetEncoderProperty(MediaStreamType, Guid, Object) Метод

Определение

Пространство имен:

Windows.Media.Capture

Задает свойство кодирования.

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)

Параметры

mediaStreamType

MediaStreamType

Тип данных мультимедиа, которые представляет поток, например видео или аудио.

propertyId

Guid

Platform::Guid

winrt::guid

Задается свойство кодировки.

propertyValue

Object

Platform::Object

IInspectable

Новое значение свойства кодирования.

Требования к Windows

Возможности приложения

backgroundMediaRecording microphone webcam

Комментарии

Метод SetEncoderProperty можно вызвать только с типом mediaStreamType , равным MediaStreamType.Audio, если свойство кодировщика применяется только к кодировщику звука в приемнике записей. Приемник предварительного просмотра не позволяет задать профиль кодирования со сжатым звуком.

Для камер, отличных от H.264, при вызове SetEncoderProperty перед началом записи или предварительного просмотра свойство сохраняется локально. При запуске записи свойство применяется к кодировщику во время инициализации кодировщика. Чтобы настроить свойства статического кодирования, необходимо вызвать Метод SetEncoderProperty перед началом записи или предварительного просмотра. Перед началом записи или предварительного просмотра GetEncoderProperty вернет значение свойства, сохраненное локально.

Если камера является камерой H.264 и поток, в который вызывается SetEncoderProperty, относится к типу MediaStreamType.VideoRecord, то свойство применяется непосредственно к камере. Это верно как до, так и после начала записи.

Для камер, отличных от H.264, при вызове SetEncoderProperty после получения обратного вызова завершения записи или предварительного просмотра свойство задается непосредственно в кодировщике и, следовательно, используется для настройки свойств динамического кодирования.

При вызове SetEncoderProperty после вызова для начала записи или предварительного просмотра и до получения обратного вызова завершения записи или предварительного просмотра вы получите ошибку MF_E_INVALIDREQUEST , так как свойство не может быть применено к статическим или динамическим параметрам.

Чтобы повернуть поток предварительного просмотра, используйте GUID , определенный как MF_MT_VIDEO_ROTATION. Инструкции по обработке ориентации при использовании камеры см. в разделе Обработка ориентации устройства с помощью MediaCapture.