IAcpHal::Connect
连接到 ACP。语法
参数
numCommands类型:UINT32 指定要在 ACP 命令队列中分配的命令数量。该值必须大于零,并且要足以容纳每个 2.67 毫秒音频帧所发出的全部命令。 numMessages
类型:UINT32 指定要在 ACP 消息队列中分配的消息数量。如果游戏不处理接收到的消息,该值可以为零。如果注册了 command completed 消息(参见 ACP_MESSAGE_TYPE),那么消息数量至少要与命令数量相同。通常此消息队列的处理频率低于每个音频帧一次,因此请预留几帧数量的消息容量。
返回值
类型:HRESULT 如果方法成功,则返回S_OK。如果方法失败,则返回以下代码之一(部分列表):
备注
在调用此接口中的任何其他方法之前,请先调用此方法。但是,在调用 Disconnect 之后,可以再次调用此方法。另请参阅 SubmitCommand。 如果该方法因E_INVALIDARG 或 ACP_E_ALREADY_CONNECTED 以外的错误而失败,建议销毁所有现有的 ACP 客户端对象,并使用 AcpHalReleaseShapeContexts 释放已分配的 SHAPE 上下文。之后应根据需要,分别使用 AcpHalAllocateShapeContexts 和 AcpHalCreate 重新分配/创建新的 SHAPE 上下文和 ACP 客户端对象。
要求
头文件: acphal.h 支持的平台: XBOX One 系列主机和 XBOX Series 主机另请参阅
DisconnectAcpHal