METODE IMFSourceReader::GetNativeMediaType (mfreadwrite.h)

Mendapatkan format yang didukung secara asli oleh sumber media.

Syntax

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

Parameter-parameternya

[in] dwStreamIndex

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

Nilai	Meaning
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	Meaning
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.

Mengembalikan kode	Description
S_OK	Metode berhasil.
MF_E_INVALIDSTREAMNUMBER	Parameter dwStreamIndex tidak valid.
MF_E_NO_MORE_TYPES	Parameter dwMediaTypeIndex berada di luar rentang.

Komentar

Metode ini mengkueri sumber media yang mendasari untuk format output aslinya. Berpotensi, setiap aliran sumber dapat menghasilkan lebih dari satu format output. Gunakan parameter dwMediaTypeIndex untuk mengulangi format yang tersedia. Umumnya, sumber file hanya menawarkan satu format per streaming, tetapi perangkat pengambilan 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 Platform Update Supplement untuk Windows Vista [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 R2 [aplikasi desktop | Aplikasi UWP]
Platform Target	Windows
Header	mfreadwrite.h

Lihat juga

IMFSourceReader

Pembaca Sumber