METODE IMFSourceReaderEx::GetTransformForStream (mfreadwrite.h)

Artikel
03/15/2023

Mendapatkan penunjuk ke transformasi Media Foundation (MFT) untuk aliran tertentu.

Sintaks

HRESULT GetTransformForStream(
  [in]  DWORD        dwStreamIndex,
  [in]  DWORD        dwTransformIndex,
  [out] GUID         *pGuidCategory,
  [out] IMFTransform **ppTransform
);

Parameter

[in] dwStreamIndex

Aliran yang akan dikueri untuk MFT. Nilainya bisa salah satu dari yang berikut ini.

Nilai	Makna
0–0xFFFFFFFB	Indeks aliran berbasis nol.
MF_SOURCE_READER_FIRST_VIDEO_STREAM 0xFFFFFFFC	Streaming video pertama.
MF_SOURCE_READER_FIRST_AUDIO_STREAM 0xFFFFFFFD	Aliran audio pertama.

[in] dwTransformIndex

Indeks berbasis nol dari MFT yang akan diambil.

[out] pGuidCategory

Menerima GUID yang menentukan kategori MFT. Untuk daftar nilai yang mungkin, lihat MFT_CATEGORY.

[out] ppTransform

Menerima penunjuk ke antarmuka IMFTransform MFT. Pemanggil harus merilis antarmuka.

Mengembalikan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Berhasil.
MF_E_INVALIDINDEX	Parameter dwTransformIndex berada di luar rentang.
MF_E_INVALIDSTREAMNUMBER	Parameter dwStreamIndex tidak valid.

Keterangan

Anda dapat menggunakan metode ini untuk mengonfigurasi MFT setelah dimasukkan ke dalam rantai pemrosesan. Jangan gunakan penunjuk yang dikembalikan dalam ppTransform untuk mengatur jenis media pada MFT atau untuk memproses data. Secara khusus, memanggil salah satu metode IMFTransform berikut dapat memiliki hasil yang tidak terduga.

Jika ada dekoder, dekoder muncul pada posisi indeks nol.

Untuk menghindari kehilangan data apa pun, Anda harus menguras pembaca sumber sebelum memanggil metode ini. Untuk informasi selengkapnya, lihat Menguras Alur Data.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2012 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	mfreadwrite.h

Lihat juga

IMFSourceReaderEx

Bagikan melalui