Metode IMediaSeeking::SetTimeFormat (strmif.h)

Artikel
03/02/2024

[Fitur yang terkait dengan halaman ini, DirectShow, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer, IMFMediaEngine, dan Tangkapan Audio/Video di Media Foundation. Fitur-fitur tersebut telah dioptimalkan untuk Windows 10 dan Windows 11. Microsoft sangat menyarankan agar kode baru menggunakan MediaPlayer, IMFMediaEngine dan Audio/Video Capture di Media Foundation alih-alih DirectShow, jika memungkinkan. Microsoft menyarankan agar kode yang ada yang menggunakan API warisan ditulis ulang untuk menggunakan API baru jika memungkinkan.]

Metode SetTimeFormat ini mengatur format waktu untuk operasi pencarian berikutnya.

Sintaks

HRESULT SetTimeFormat(
  [in] const GUID *pFormat
);

Parameter

[in] pFormat

Penunjuk ke GUID yang menentukan format waktu. Lihat GUID Format Waktu.

Mengembalikan nilai

Mengembalikan nilai HRESULT . Nilai yang mungkin termasuk yang berikut ini.

Menampilkan kode	Deskripsi
S_OK	Berhasil.
E_INVALIDARG	Argumen tidak valid.
E_NOTIMPL	Metode tidak didukung.
E_POINTER	Argumen penunjuk NULL.
VFW_E_WRONG_STATE	Grafik filter tidak dihentikan.

Keterangan

Metode ini menentukan unit waktu yang digunakan oleh metode IMediaSeeking lainnya, seperti IMediaSeeking::GetPositions dan IMediaSeeking::SetPositions. Setiap kali Anda memanggil salah satu metode lain ini, parameter apa pun yang mengekspresikan nilai waktu diberikan dalam satuan format waktu saat ini.

Format waktu default adalah REFERENCE_TIME unit (100 nanodetik). Format waktu lainnya termasuk bingkai, sampel, dan byte. Untuk menentukan apakah format tertentu didukung, panggil metode IMediaSeeking::IsFormatSupported . Jika format didukung, Anda dapat beralih ke format tersebut dengan memanggil SetTimeFormat. Hanya satu kali format aktif pada satu waktu.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	strmif.h (termasuk Dshow.h)
Pustaka	Strmiids.lib

Lihat juga

Kode Kesalahan dan Keberhasilan

Antarmuka IMediaSeeking

IMediaSeeking::GetTimeFormat

IMediaSeeking::QueryPreferredFormat

Bagikan melalui