IMFMediaSession::Metode mulai (mfidl.h)

Artikel
03/04/2024

Memulai Sesi Media.

Sintaks

HRESULT Start(
  [in] const GUID        *pguidTimeFormat,
  [in] const PROPVARIANT *pvarStartPosition
);

Parameter

[in] pguidTimeFormat

Penunjuk ke GUID yang menentukan format waktu untuk parameter pvarStartPosition . Parameter ini bisa NULL. Nilai NULL setara dengan meneruskan GUID_NULL.

GUID format waktu berikut didefinisikan:

Nilai	Makna
GUID_NULL	Waktu presentasi. Parameter pvarStartPosition harus memiliki salah satu jenis PROPVARIANT berikut. VT_I8: Parameter pvarStartPosition berisi posisi awal dalam unit 100 nanodetik, relatif terhadap awal presentasi. VT_EMPTY: Pemutaran dimulai dari posisi saat ini. Semua sumber media mendukung format waktu ini.
MF_TIME_FORMAT_SEGMENT_OFFSET	Offset segmen. Format kali ini didukung oleh Sumber Pengurut. Waktu mulai adalah offset dalam segmen. Panggil fungsi MFCreateSequencerSegmentOffset untuk membuat nilai PROPVARIANT untuk parameter pvarStartPosition .
MF_TIME_FORMAT_ENTRY_RELATIVE	Catatan Memerlukan Windows 7 atau yang lebih baru. Lewati ke entri daftar putar. Parameter pvarStartPosition menentukan indeks entri daftar putar, relatif terhadap entri saat ini. Misalnya, nilai 2 melompati dua entri ke depan. Untuk melewati mundur, lewati nilai negatif. Jenis PROPVARIANTVT_I4. Jika sumber media mendukung format waktu ini, metode IMFMediaSource::GetCharacteristics mengembalikan satu atau kedua bendera berikut: MFMEDIASOURCE_CAN_SKIPFORWARD MFMEDIASOURCE_CAN_SKIPBACKWARD

Nilai

Makna

GUID_NULL

Waktu presentasi. Parameter pvarStartPosition harus memiliki salah satu jenis PROPVARIANT berikut.

VT_I8: Parameter pvarStartPosition berisi posisi awal dalam unit 100 nanodetik, relatif terhadap awal presentasi.
VT_EMPTY: Pemutaran dimulai dari posisi saat ini.

Semua sumber media mendukung format waktu ini.

MF_TIME_FORMAT_SEGMENT_OFFSET

Offset segmen. Format kali ini didukung oleh Sumber Pengurut. Waktu mulai adalah offset dalam segmen.

Panggil fungsi MFCreateSequencerSegmentOffset untuk membuat nilai PROPVARIANT untuk parameter pvarStartPosition .

MF_TIME_FORMAT_ENTRY_RELATIVE

Catatan Memerlukan Windows 7 atau yang lebih baru.

Lewati ke entri daftar putar. Parameter pvarStartPosition menentukan indeks entri daftar putar, relatif terhadap entri saat ini. Misalnya, nilai 2 melompati dua entri ke depan. Untuk melewati mundur, lewati nilai negatif. Jenis PROPVARIANTVT_I4.

Jika sumber media mendukung format waktu ini, metode IMFMediaSource::GetCharacteristics mengembalikan satu atau kedua bendera berikut:

MFMEDIASOURCE_CAN_SKIPFORWARD
MFMEDIASOURCE_CAN_SKIPBACKWARD

[in] pvarStartPosition

Penunjuk ke PROPVARIANT yang menentukan posisi awal untuk pemutaran. Arti dan jenis data parameter ini ditunjukkan oleh parameter pguidTimeFormat .

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_INVALIDREQUEST	Operasi tidak dapat dilakukan dalam status Sesi Media saat ini.
MF_E_SHUTDOWN	Sesi Media telah dimatikan.

Keterangan

Ketika metode ini dipanggil, Sesi Media memulai jam presentasi dan mulai memproses sampel media.

Metode ini asinkron. Ketika metode selesai, Sesi Media mengirimkan peristiwa MESessionStarted .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	mfidl.h
Pustaka	Mfuuid.lib

Lihat juga

IMFMediaSession

Bagikan melalui