IAMExtDevice：：Calibrate 方法 (strmif.h)
[与此页面关联的功能 DirectShow 是一项旧功能。 它已被 MediaPlayer、 IMFMediaEngine 和 媒体基金会中的音频/视频捕获取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获 ，而不是 DirectShow。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]
方法 Calibrate 校准外部设备的传输机制。
未实现此方法。
语法
HRESULT Calibrate(
[in] HEVENT hEvent,
[in] long Mode,
[out] long *pStatus
);
参数
[in] hEvent
事件的句柄。 当操作完成时，事件会发出信号。
[in] Mode
指定激活或停用校准过程的值：
| 值 | 说明 |
|---|---|
| ED_ACTIVE | 激活校准过程。 |
| ED_INACTIVE | 停用校准过程。 |
| NULL | 无操作;返回 pStatus 中的校准状态。 |
[out] pStatus
指向接收以下值之一的 长 整数的指针：
| 值 | 说明 |
|---|---|
| OATRUE | 校准处于活动状态。 |
| OAFALSE | 校准处于非活动状态。 |
返回值
此方法成功后，将返回S_OK。 否则，它将返回 HRESULT 错误代码。
注解
在需要校准的某些外部设备上使用此方法;例如，倒带磁带并重置计数器，或计算时间码读取器的帧偏移量。
各种外部设备的筛选器可以通过不同的方式实现此方法，具体取决于设备所需的校准。 此方法假定 IMediaEventSink 接口已建立事件接收器，或者已建立另一个事件信号方法。
DV 实现
MSDV 和 UVC 驱动程序不支持此方法。 方法返回E_NOTIMPL。要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | strmif.h (包括 Dshow.h) |
| Library | Strmiids.lib |