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

Definición

Espacio de nombres:

Windows.Media.Capture

Establece una propiedad de codificación.

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)

Parámetros

mediaStreamType

MediaStreamType

Tipo de datos multimedia que representa la secuencia, como vídeo o audio.

propertyId

Guid

Platform::Guid

winrt::guid

Propiedad de codificación que se va a establecer.

propertyValue

Object

Platform::Object

IInspectable

Nuevo valor de la propiedad de codificación.

Requisitos de Windows

Características de aplicaciones

backgroundMediaRecording microphone webcam

Comentarios

Solo puede llamar a SetEncoderProperty con mediaStreamType igual a MediaStreamType.Audio, si la propiedad del codificador se aplica solo al codificador de audio en el receptor de registros. El receptor de vista previa no permite establecer un perfil de codificación con audio comprimido.

En el caso de las cámaras que no son H.264, cuando se llama a SetEncoderProperty antes de que se inicie la grabación o vista previa, la propiedad se almacena localmente. Al iniciar la grabación, la propiedad se aplica al codificador en el momento de la inicialización del codificador. Para configurar las propiedades de codificación estáticas, debe llamar a SetEncoderProperty antes de que se inicie la grabación o la vista previa. Antes de que se inicie la grabación o vista previa, GetEncoderProperty devolverá el valor de la propiedad almacenada localmente.

Si la cámara es una cámara H.264 y la secuencia en la que se llama a SetEncoderProperty es de tipo MediaStreamType.VideoRecord, la propiedad se aplica directamente a la cámara. Esto es cierto tanto antes como después de que se haya iniciado la grabación.

En el caso de las cámaras que no son H.264, cuando se llama a SetEncoderProperty después de obtener la devolución de llamada de finalización iniciada del registro o la vista previa, la propiedad se establece directamente en el codificador y, por tanto, se usa para configurar propiedades de codificación dinámicas.

Si llama a SetEncoderProperty después de emitir una llamada para iniciar la grabación o la vista previa y antes de obtener la devolución de llamada de finalización iniciada del registro o la vista previa, recibirá un error de MF_E_INVALIDREQUEST , ya que la propiedad no se puede aplicar a la configuración estática ni dinámica.

Para rotar la secuencia de vista previa, use el GUID definido como MF_MT_VIDEO_ROTATION. Para obtener instrucciones sobre cómo controlar la orientación al usar la cámara, consulta Controlar la orientación del dispositivo con MediaCapture.