MediaCapture.SetEncoderProperty(MediaStreamType, Guid, Object) Metodo

Definizione

Spazio dei nomi:

Windows.Media.Capture

Imposta una proprietà di codifica.

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)

Parametri

mediaStreamType

MediaStreamType

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

propertyId

Guid

Platform::Guid

winrt::guid

Proprietà di codifica da impostare.

propertyValue

Object

Platform::Object

IInspectable

Nuovo valore della proprietà di codifica.

Requisiti Windows

Funzionalità dell'app

backgroundMediaRecording microphone webcam

Commenti

È possibile chiamare SetEncoderProperty con mediaStreamType uguale a MediaStreamType.Audio, se la proprietà del codificatore viene applicata solo al codificatore audio nel sink di record. Il sink di anteprima non consente di impostare un profilo di codifica con audio compresso.

Per le fotocamere non H.264, quando chiami SetEncoderProperty prima dell'avvio della registrazione o dell'anteprima, la proprietà viene archiviata localmente. Quando si avvia la registrazione, la proprietà viene applicata al codificatore al momento dell'inizializzazione del codificatore. Per configurare le proprietà di codifica statiche, è necessario chiamare SetEncoderProperty prima dell'avvio della registrazione o dell'anteprima. Prima dell'avvio della registrazione o dell'anteprima, GetEncoderProperty restituirà il valore della proprietà archiviata in locale.

Se la fotocamera è una fotocamera H.264 e il flusso su cui viene chiamato SetEncoderProperty è di tipo MediaStreamType.VideoRecord, la proprietà viene applicata direttamente alla fotocamera. Questo vale sia prima che dopo l'avvio della registrazione.

Per le fotocamere non H.264, quando chiami SetEncoderProperty dopo aver visualizzato il callback di completamento del record o dell'anteprima, la proprietà viene impostata direttamente sul codificatore e quindi viene usata per configurare le proprietà di codifica dinamica.

Se chiami SetEncoderProperty dopo aver eseguito una chiamata per avviare la registrazione o l'anteprima e prima di ottenere il callback di completamento del record o dell'anteprima, riceverai un errore di MF_E_INVALIDREQUEST perché la proprietà non può essere applicata alle impostazioni statiche né dinamiche.

Per ruotare il flusso di anteprima, usare il GUID definito come MF_MT_VIDEO_ROTATION. Per indicazioni sulla gestione dell'orientamento quando si usa la fotocamera, vedi Gestire l'orientamento del dispositivo con MediaCapture.