IMFMediaSource::P ause method (mfidl.h)

Menjeda semua aliran aktif di sumber media.

Sintaks

HRESULT Pause();

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_INVALID_STATE_TRANSITION
Transisi status tidak valid. Sumber media harus dalam status dimulai.
MF_E_SHUTDOWN
Metode Matikan sumber media telah dipanggil.

Keterangan

Metode ini asinkron. Ketika operasi selesai, sumber media mengirim dan peristiwa MESourcePaused , dan setiap aliran aktif mengirimkan peristiwa MEStreamPaused . Jika metode mengembalikan kode kegagalan, tidak ada peristiwa yang dinaikkan.

Sumber media harus dalam status dimulai. Metode gagal jika sumber media dijeda atau dihentikan.

Saat sumber dijeda, panggilan ke IMFMediaStream::RequestSample berhasil, tetapi aliran tidak akan mengirimkan sampel apa pun sampai setelah sumber dimulai lagi. Perhatikan bahwa antrean peristiwa sumber tidak diserialisasikan dengan antrean peristiwa streaming, sehingga klien mungkin menerima beberapa sampel setelah peristiwa MESourcePaused , karena masalah multi-utas. Tetapi klien tidak akan menerima sampel apa pun dari aliran setelah peristiwa MEStreamPaused .

Tidak setiap sumber media dapat dijeda. Jika sumber media dapat dijeda, metode IMFMediaSource::GetCharacteristics mengembalikan bendera MFMEDIASOURCE_CAN_PAUSE.

Persyaratan

   
Klien minimum yang didukung Windows Vista [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung Windows Server 2008 [aplikasi desktop | Aplikasi UWP]
Target Platform Windows
Header mfidl.h
Pustaka Mfuuid.lib

Lihat juga

IMFMediaSource

Sumber Media