Share via

IAudioProcessingObjectConfiguration：：LockForProcess 方法 (audioenginebaseapo.h)

  • 项目

方法 LockForProcess 用于验证 APO 是否已锁定并准备好处理数据。

语法

HRESULT LockForProcess(
  [in] UINT32                    u32NumInputConnections,
  [in] APO_CONNECTION_DESCRIPTOR **ppInputConnections,
  [in] UINT32                    u32NumOutputConnections,
  [in] APO_CONNECTION_DESCRIPTOR **ppOutputConnections
);

参数

[in] u32NumInputConnections

附加到此 APO 的输入连接数。

[in] ppInputConnections

附加到此 APO 的每个输入连接的连接描述符。

[in] u32NumOutputConnections

附加到此 APO 的输出连接数。

[in] ppOutputConnections

附加到此 APO 的每个输出连接的连接描述符。

返回值

如果调用成功完成，方法 LockForProcess 将返回值 S_OK。 在此阶段，APO 已锁定并已准备好处理数据。

返回代码 说明
E_POINTER
 传递给函数的指针无效。
APOERR_INVALID_CONNECITON_FORMAT
 连接格式无效。
APOERR_NUM_CONNECTIONS_INVALID
 在此 APO 上无效的输入或输出连接数。
APOERR_APO_LOCKED
 APO 已锁定。
其他 HRESULTS
 音频引擎将跟踪这些故障。

注解

LockForProcess调用 方法时，它首先执行内部检查以查看 APO 是否已初始化并准备好处理数据。 每个 APO 都有不同的初始化要求，因此每个 APO 必须根据需要定义自己的 Initialize 方法。

要求

要求 值
最低受支持的客户端 适用于 Windows Vista 和更高版本的 Windows 操作系统。
目标平台 通用
标头 audioenginebaseapo.h
Library Audioenginebaseapo.idl
IRQL 所有级别