METODE IMFSourceReader::SetCurrentPosition (mfreadwrite.h)

Mencari posisi baru di sumber media.

Sintaks

HRESULT SetCurrentPosition(
  [in] REFGUID        guidTimeFormat,
  [in] REFPROPVARIANT varPosition
);

Parameter

[in] guidTimeFormat

GUID yang menentukan format waktu. Format waktu menentukan unit untuk parameter varPosition . Nilai berikut didefinisikan untuk semua sumber media:

Nilai	Makna
GUID_NULL	100 unit nanodetik.

 

Beberapa sumber media mungkin mendukung nilai tambahan.

[in] varPosition

Posisi dari mana pemutaran akan dimulai. Unit ditentukan oleh parameter guidTimeFormat . Jika parameter guidTimeFormatGUID_NULL, atur jenis varian ke VT_I8.

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_INVALIDREQUEST	Satu atau beberapa permintaan sampel masih tertunda.

Keterangan

Metode SetCurrentPosition tidak menjamin pencarian yang tepat. Akurasi pencarian tergantung pada konten media. Jika konten media berisi aliran video, metode SetCurrentPosition biasanya mencari bingkai kunci terdekat sebelum posisi yang diinginkan. Jarak antara bingkai kunci tergantung pada beberapa faktor, termasuk implementasi encoder, konten video, dan pengaturan pengodean tertentu yang digunakan untuk mengodekan konten. Jarak antara bingkai kunci dapat bervariasi dalam satu file video (misalnya, tergantung pada kompleksitas adegan).

Setelah mencari, aplikasi harus memanggil IMFSourceReader::ReadSample dan maju ke posisi yang diinginkan.

Antarmuka ini tersedia pada Windows Vista jika Pelengkap 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