IAcpHal::Connect
ACP に接続します。構文
パラメーター
numCommands型: UINT32 ACP コマンド キューに割り当てるコマンド数を指定します。この値は 0 より大きく、2.67 ミリ秒のオーディオ フレームごとに発行されるコマンド数を処理できるだけの大きさである必要があります。 numMessages
型: UINT32 ACP メッセージ キューに割り当てるメッセージ数を指定します。タイトルが受信したメッセージを処理しない場合、この値は 0 でもかまいません。コマンド完了 メッセージ (ACP_MESSAGE_TYPE を参照) に登録している場合、少なくともコマンド数と同数のメッセージが存在します。通常、このメッセージ キューはオーディオ フレームごとよりも少ない頻度で処理されるため、複数フレーム分のメッセージを見込んで計画してください。
戻り値
型: HRESULT メソッドが成功した場合はS_OK を返します。失敗した場合は、次のいずれかのコードを返します (一部のみ)。
解説
このインターフェイスの他のメソッドを呼び出す前に、このメソッドを呼び出します。ただし、Disconnect を呼び出した後は、このメソッドを再度呼び出すことができます。SubmitCommand も参照してください。E_INVALIDARG または ACP_E_ALREADY_CONNECTED 以外のエラーでメソッドが失敗した場合、既存の すべての ACP クライアント オブジェクトを破棄し、AcpHalReleaseShapeContexts を使用して割り当て済みの SHAPE コンテキストを解放することを推奨します。新しい SHAPE コンテキストと ACP クライアント オブジェクトは、必要に応じてそれぞれ AcpHalAllocateShapeContexts と AcpHalCreate を使用して再度割り当て/作成してください。
要件
ヘッダー: acphal.h サポート対象プラットフォーム: XBOX One ファミリー本体、XBOX Series 本体関連項目
DisconnectAcpHal