IAMExtDevice::Calibrate 方法 (strmif.h)

[与此页面关联的功能 DirectShow 是一项旧功能。 它已被 MediaPlayerIMFMediaEngine媒体基金会中的音频/视频捕获取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayerIMFMediaEngineMedia 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

另请参阅

错误和成功代码

IAMExtDevice 接口