Share via

Metode IMFSourceReader::GetNativeMediaType (mfreadwrite.h)

  • Artikel

Mendapatkan format yang didukung secara asli oleh sumber media.

Sintaks

HRESULT GetNativeMediaType(
  [in]  DWORD        dwStreamIndex,
  [in]  DWORD        dwMediaTypeIndex,
  [out] IMFMediaType **ppMediaType
);

Parameter

[in] dwStreamIndex

Menentukan aliran mana yang akan dikueri. 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] dwMediaTypeIndex

Menentukan tipe media mana yang akan dikueri. Nilainya bisa salah satu dari yang berikut ini.

Nilai Makna
0–0xFFFFFFFE
 Indeks berbasis nol dari jenis media
MF_SOURCE_READER_CURRENT_TYPE_INDEX
0xFFFFFFFF
 Jenis media asli saat ini.

[out] ppMediaType

Menerima penunjuk ke antarmuka IMFMediaType . Pemanggil harus merilis antarmuka.

Mengembalikan nilai

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_INVALIDSTREAMNUMBER
 Parameter dwStreamIndex tidak valid.
MF_E_NO_MORE_TYPES
 Parameter dwMediaTypeIndex berada di luar rentang.

Keterangan

Metode ini meminta sumber media yang mendasari untuk format output aslinya. Berpotensi, setiap aliran sumber dapat menghasilkan lebih dari satu format output. Gunakan parameter dwMediaTypeIndex untuk mengulang format yang tersedia. Umumnya, sumber file hanya menawarkan satu format per aliran, tetapi mengambil perangkat mungkin menawarkan beberapa format.

Metode mengembalikan salinan jenis media, sehingga aman untuk memodifikasi objek yang diterima dalam parameter ppMediaType .

Untuk mengatur jenis output untuk aliran, panggil metode IMFSourceReader::SetCurrentMediaType .

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

IMFSourceReader

Pembaca Sumber