MediaCapture.SetEncoderProperty(MediaStreamType, Guid, Object) Metode

Definisi

Ruang nama:

Windows.Media.Capture

Mengatur properti pengodean.

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)

Parameter

mediaStreamType

MediaStreamType

Jenis data media yang diwakili aliran, seperti video atau audio.

propertyId

Guid

Platform::Guid

winrt::guid

Properti pengodean yang akan diatur.

propertyValue

Object

Platform::Object

IInspectable

Nilai baru properti pengodean.

Persyaratan Windows

Kemampuan aplikasi

backgroundMediaRecording microphone webcam

Keterangan

Anda hanya dapat memanggil SetEncoderProperty dengan mediaStreamType sama dengan MediaStreamType.Audio, jika properti encoder hanya diterapkan ke encoder audio di sink rekaman. Sink pratinjau tidak memungkinkan Anda mengatur profil pengodean dengan audio terkompresi.

Untuk kamera non-H.264, saat Anda memanggil SetEncoderProperty sebelum perekaman atau pratinjau dimulai, properti disimpan secara lokal. Saat Anda mulai merekam, properti diterapkan ke encoder pada saat inisialisasi encoder. Untuk mengonfigurasi properti pengodean statis, Anda harus memanggil SetEncoderProperty sebelum perekaman atau pratinjau dimulai. Sebelum perekaman atau pratinjau dimulai, GetEncoderProperty akan mengembalikan nilai properti yang disimpan secara lokal.

Jika kamera adalah kamera H.264 dan aliran yang dipanggil SetEncoderProperty adalah jenis MediaStreamType.VideoRecord, maka properti diterapkan langsung ke kamera. Ini benar baik sebelum dan sesudah perekaman dimulai.

Untuk kamera non-H.264, saat Anda memanggil SetEncoderProperty setelah Anda mendapatkan panggilan balik penyelesaian rekam atau pratinjau, properti diatur langsung pada encoder dan oleh karena itu digunakan untuk mengonfigurasi properti pengodean dinamis.

Jika Anda memanggil SetEncoderProperty setelah Anda mengeluarkan panggilan untuk mulai merekam atau mempratinjau dan sebelum Anda mendapatkan rekaman atau pratinjau memulai panggilan balik penyelesaian, Anda akan menerima kesalahan MF_E_INVALIDREQUEST karena properti tidak dapat diterapkan ke pengaturan statis atau dinamis.

Untuk memutar aliran pratinjau, gunakan GUID yang didefinisikan sebagai MF_MT_VIDEO_ROTATION. Untuk panduan cara menangani orientasi saat menggunakan kamera, lihat Menangani orientasi perangkat dengan MediaCapture.