Metode IMFSinkWriter::SetInputMediaType (mfreadwrite.h)

Artikel
03/04/2024

Mengatur format input untuk aliran pada penulis sink.

Sintaks

HRESULT SetInputMediaType(
  [in] DWORD         dwStreamIndex,
  [in] IMFMediaType  *pInputMediaType,
  [in] IMFAttributes *pEncodingParameters
);

Parameter

[in] dwStreamIndex

Indeks aliran berbasis nol. Indeks diterima oleh parameter pdwStreamIndex dari metode IMFSinkWriter::AddStream .

[in] pInputMediaType

Penunjuk ke antarmuka IMFMediaType dari jenis media. Jenis media menentukan format input.

[in] pEncodingParameters

Penunjuk ke antarmuka IMFAttributes dari penyimpanan atribut. Gunakan penyimpanan atribut untuk mengonfigurasi encoder. Parameter ini bisa NULL.

Nilai kembali

Metode mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
MF_E_INVALIDMEDIATYPE	Sink media yang mendasar tidak mendukung format, tidak ada konversi yang dimungkinkan, atau perubahan format dinamis tidak dimungkinkan.
MF_E_INVALIDSTREAMNUMBER	Parameter dwStreamIndex tidak valid.
MF_E_TOPO_CODEC_NOT_FOUND	Tidak dapat menemukan encoder untuk format yang dikodekan.

Keterangan

Format input tidak harus cocok dengan format target yang ditulis ke sink media. Jika format tidak cocok, metode mencoba memuat encoder yang dapat mengodekan dari format input ke format target.

Setelah streaming dimulai—yaitu, setelah panggilan pertama ke IMFSinkWriter::WriteSample—Anda dapat memanggil metode ini kapan saja untuk mengubah format input. Namun, encoder dan sink media yang mendasar harus mendukung perubahan format dinamis.

Antarmuka ini tersedia di Windows Vista jika Suplemen Pembaruan Platform untuk Windows Vista diinstal.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7, Windows Vista, dan Suplemen Pembaruan Platform untuk Windows Vista [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 R2 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	mfreadwrite.h

Lihat juga

IMFSinkWriter

Penulis Sink