iMediaSeeking：：SetTimeFormat 方法 (strmif.h)
[与此页面关联的功能 DirectShow 是一项旧功能。 它已被 MediaPlayer、 IMFMediaEngine 和 媒体基金会中的音频/视频捕获取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获 ，而不是 DirectShow。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]
方法 SetTimeFormat 设置后续查找操作的时间格式。
语法
HRESULT SetTimeFormat(
[in] const GUID *pFormat
);
参数
[in] pFormat
指向指定时间格式的 GUID 的指针。 请参阅 时间格式 GUID。
返回值
返回 HRESULT 值。 可能的值包括以下值。
| 返回代码 | 说明 |
|---|---|
|
成功。 |
|
无效的参数。 |
|
不支持方法。 |
|
NULL 指针参数。 |
|
筛选器图未停止。 |
注解
此方法指定其他 IMediaSeeking 方法（如 IMediaSeeking：：GetPositions 和 IMediaSeeking：：SetPositions）使用的时间单位。 每当调用其他方法之一时，表示时间值的任何参数都以当前时间格式的单位提供。
默认时间格式为 REFERENCE_TIME 单位 (100 纳秒) 。 其他时间格式包括帧、样本和字节。 若要确定是否支持给定格式，请调用 IMediaSeeking：：IsFormatSupported 方法。 如果支持格式，可以通过调用 SetTimeFormat切换到该格式。 在任何一次，只有一个时间格式处于活动状态。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | strmif.h (包括 Dshow.h) |
| Library | Strmiids.lib |