MediaCapture.SetEncoderProperty(MediaStreamType, Guid, Object) Metodo
Definizione
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.
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.