XDspActivate

プールから空き処理リソースを取得することで XDSP ストリームをアクティブ化します。各 XDSP クライアントは 256 個のストリームアクティブ化に制限されています。

構文

HRESULT XDspActivate(  
         XDspClientHandle clientHandle,  
         XDspActivationParameters* params,  
         XDspStatus** status,  
         XDspStreamHandle* streamHandle  
)  

パラメーター

clientHandle   _In_
型: XDspClientHandle XDspConnect の呼び出しから取得した有効な XDSP クライアントハンドル。 params   _In_
型: XDspActivationParameters* XDspActivationParameters 構造体へのポインター。 status   _Outptr_
型: XDspStatus** XDspStatus 構造体へのポインター。詳細については、解説セクションを参照してください。 streamHandle   _Outptr_
型: XDspStreamHandle* 呼び出しが成功した場合の、有効な XDspStreamHandle。詳細については、解説セクションを参照してください。

戻り値

型: HRESULT メソッドが成功した場合は S_OK を返します。失敗した場合は次のコードのいずれかを返します (一部の一覧):

戻りコード	説明
E_POINTER	有効でないポインター。
E_INVALIDARG	1 つ以上の引数が無効です。
XDSP_E_NO_DEVICE_RESOURCES	要求を処理するために利用可能な XDSP デバイスリソースがありません。
XDSP_E_INVALID_IMPULSE_RESPONSE_LENGTH	指定されたインパルス応答長が無効です。このエラーは、(`9 * blockSize * 2`) 未満、または 16 秒 (`16 * 48000 * 2`) を超える impulseResponseLengthInFloats が指定された場合に発生することがあります。

解説

この呼び出しは、リソースを割り当てるのではなくプールから取得するため、高速です。呼び出し元は、XDSP ストリームが実行する XDspProcessType を指定する必要があります。XDSP ストリームのインスタンスは、そのライフタイム中に 1 つの処理タイプのみで動作できます。2 つ以上の異なる処理タイプを実行するには、2 つ以上の XDSP ストリームインスタンスをインスタンス化する必要があります。 XDspActivationParameters 構造体内で、呼び出し元は次を指定する必要があります:

アクティベーションオプション。
各コマンドで処理されるフレーム数 (入力および出力のフレーム数)。
ストリームのチャネル数。モノラルおよびステレオの入力ストリームのみがサポートされます。
XDspProcessType::Convolution 処理タイプの場合、float 単位のインパルス応答長。
XDspProcessType::Convolution 処理タイプの場合、周波数領域の値としてのインパルス応答。

呼び出しが成功すると、このストリームに対する他の呼び出し (XDspSubmitCommand、XDspSubmitCommandWithEnvelope、XDspDeactivate) で使用する有効な XDspStreamHandle が返されます。また、この呼び出しが成功すると、送信されたコマンドの状態を確認するために使用できる XDspStatus へのポインターが返されます。これは、処理された最新のコマンドと、送信されたコマンドの結果を消費する準備ができているかどうかを判断するために使用する必要があります。 XDspStatus には、ハードウェアに送信された最後のコマンドのシーケンス番号と、それが表す XDSP ストリームの最初に失敗したコマンドのシーケンス番号もあります。畳み込み処理の場合、呼び出し元はこの呼び出しが返った後にインパルス応答のメモリを解放できます。

要件

ヘッダー: XDspAudio.h ライブラリ: Chad.lib サポートされるプラットフォーム: XBOX Series X|S

(all) API references

Error codes

Audio API reference

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

XDspActivate

XDspActivate

構文

パラメーター

戻り値

解説

要件

概念ドキュメント

関連項目

​XDspActivate

​構文

​パラメーター

​戻り値

​解説

​要件

​概念ドキュメント

​関連項目

XDspActivate

構文

パラメーター

戻り値

解説

要件

概念ドキュメント

関連項目