IAcpHal::Connect
連線至 ACP。語法
參數
numCommands類型：UINT32 指定要在 ACP 命令佇列中配置的命令數目。此值必須大於零，且足以處理每個 2.67 毫秒音訊框架所發出的命令數量。 numMessages
類型：UINT32 指定要在 ACP 訊息佇列中配置的訊息數目。如果遊戲不處理收到的訊息，此值可以為零。如果已註冊命令已完成訊息 (請參閱 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