METODE IMFSourceReader::SetCurrentPosition (mfreadwrite.h)

Mencari posisi baru di sumber media.

Syntax

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

Parameter-parameternya

[in] guidTimeFormat

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

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

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

Komentar

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 antar 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 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