MediaCapture.SetEncodingPropertiesAsync Método

public:
 virtual IAsyncAction ^ SetEncodingPropertiesAsync(MediaStreamType mediaStreamType, IMediaEncodingProperties ^ mediaEncodingProperties, MediaPropertySet ^ encoderProperties) = SetEncodingPropertiesAsync;

IAsyncAction SetEncodingPropertiesAsync(MediaStreamType const& mediaStreamType, IMediaEncodingProperties const& mediaEncodingProperties, MediaPropertySet const& encoderProperties);

public IAsyncAction SetEncodingPropertiesAsync(MediaStreamType mediaStreamType, IMediaEncodingProperties mediaEncodingProperties, MediaPropertySet encoderProperties);

function setEncodingPropertiesAsync(mediaStreamType, mediaEncodingProperties, encoderProperties)

Public Function SetEncodingPropertiesAsync (mediaStreamType As MediaStreamType, mediaEncodingProperties As IMediaEncodingProperties, encoderProperties As MediaPropertySet) As IAsyncAction

Parâmetros

Retornos

Objeto usado para controlar a operação assíncrona.

Requisitos do Windows

Comentários

Esse método define as propriedades de codificação do codificador que processa os dados antes de serem passados para um CaptureElement a serem exibidos, gravados em um IRandomAccessStream ou StorageFile ou entregues a um coletor de mídia personalizado. Esse método não altera a configuração da origem dos dados, que é o dispositivo de câmera. É possível definir as propriedades de codificação para uma resolução que não tem suporte nativo pela câmera. Nesse caso, o pipeline MediaCapture usará um codificador para executar a conversão no formato solicitado. Observe que essa conversão consome recursos do sistema e pode resultar em baixo desempenho ou até mesmo erros, especialmente em dispositivos com aceleração de elementos gráficos limitados ou sem aceleração gráfica. Para cenários típicos, é recomendável que você escolha uma resolução compatível com a câmera mais próxima da resolução desejada. Você pode obter uma lista das resoluções com suporte de um dispositivo de captura chamando VideoDeviceController.GetAvailableMediaStreamProperties. Para obter mais informações, consulte Definir formato, resolução e taxa de quadros para MediaCapture e o Exemplo de Resolução da Câmera.

Para girar o registro ou o fluxo de visualização, use o GUID definido por MF_MT_VIDEO_ROTATION para adicionar metadados ao fluxo. Observe que essa rotação é executada pelo consumidor do fluxo, como CaptureElement ou um aplicativo player de vídeo, enquanto os pixels reais no fluxo ainda mantêm sua orientação original. Para obter diretrizes sobre como lidar com a orientação ao usar a câmera, consulte Manipular a orientação do dispositivo com MediaCapture.

Para modificar as propriedades do dispositivo de captura, use VideoDeviceController.SetMediaStreamPropertiesAsync.

Aplica-se a

Confira também

• GetAvailableMediaStreamProperties(MediaStreamType)
• SetMediaStreamPropertiesAsync(MediaStreamType, IMediaEncodingProperties)
• Definir o formato, a resolução e a taxa de quadros para o MediaCapture
• Tratar a orientação do dispositivo com MediaCapture
• Exemplo de resolução da câmera