MediaCapture.SetEncodingPropertiesAsync Metodo

Riferimento

Definizione

Spazio dei nomi:: Windows.Media.Capture

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

Imposta in modo asincrono le proprietà di codifica multimediale.

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

Parametri

mediaStreamType: MediaStreamType

Il tipo di dati multimediali rappresentato dal flusso, ad esempio video o audio.

mediaEncodingProperties: IMediaEncodingProperties

Proprietà per la codifica multimediale.

encoderProperties: MediaPropertySet

Proprietà per il codificatore.

Restituisce

IAsyncAction

Oggetto utilizzato per controllare l'operazione asincrona.

Requisiti Windows

Funzionalità dell'app

backgroundMediaRecording

Commenti

Questo metodo imposta le proprietà di codifica del codificatore che elabora i dati prima che vengano passati a un oggetto CaptureElement da visualizzare, scrivere in un oggetto IRandomAccessStream o StorageFile o recapitato a un sink multimediale personalizzato. Questo metodo non modifica la configurazione dell'origine dei dati, ovvero il dispositivo fotocamera. È possibile impostare le proprietà di codifica su una risoluzione non supportata in modo nativo dalla fotocamera. In questo caso, la pipeline MediaCapture userà un codificatore per eseguire la conversione nel formato richiesto. Si noti che questa conversione utilizza le risorse di sistema e può comportare prestazioni scarse o anche errori, in particolare nei dispositivi con accelerazione grafica limitata o senza accelerazione grafica. Per gli scenari tipici, è consigliabile scegliere una risoluzione supportata dalla fotocamera più vicina alla risoluzione desiderata. Puoi ottenere un elenco delle risoluzioni supportate di un dispositivo di acquisizione chiamando VideoDeviceController.GetAvailableMediaStreamProperties. Per altre informazioni, vedere Impostare il formato, la risoluzione e la frequenza dei fotogrammi per MediaCapture e l'esempio di risoluzione della fotocamera.

Nota

SetEncodingPropertiesAsync avrà esito positivo solo quando il flusso di anteprima predefinito è in uno stato di streaming, ad esempio dopo che StartPreviewAsync è stato chiamato correttamente. Se SetEncodingPropertiesAsync viene chiamato mentre l'oggetto MediaCapture esegue lo streaming di video da MediaFrameSource tramite MediaPlayerElement o MediaFrameReader, questa chiamata avrà esito negativo.

Per ruotare il flusso di record o di anteprima, usare il GUID definito da MF_MT_VIDEO_ROTATION per aggiungere metadati al flusso. Si noti che questa rotazione viene eseguita dal consumer del flusso, ad esempio CaptureElement o un'app lettore video, mentre i pixel effettivi nel flusso mantengono ancora l'orientamento originale. Per indicazioni sulla gestione dell'orientamento quando si usa la fotocamera, vedi Gestire l'orientamento del dispositivo con MediaCapture.

Per modificare le proprietà del dispositivo di acquisizione, usare VideoDeviceController.SetMediaStreamPropertiesAsync.

Si applica a