XApuConnectOutputParameters
XApuConnect によって返されるパラメーター。構文
メンバー
baseData型: void* XApuConnect が成功した場合はデバイス空間にマッピングできる、割り当てられたシステム メモリのベース仮想アドレス。それ以外の場合は nullptr。呼び出し側はこのメモリを使用して入力データを渡し、出力データを取得する必要があります。また、呼び出し側は処理バッファーを設定するためにこのメモリを使用する必要があります。 このバッファーは 16 バイト境界にアラインされており、このメモリを入力、出力、処理バッファーにどのように分割するかは呼び出し側次第です。 resultReadyEvent
型: HANDLE XApuConnectOptions::EnableResultReadyEvent フラグが設定されており、XApuConnect が成功した場合は有効な Win32 イベント ハンドル。それ以外の場合は nullptr。この Win32 イベント ハンドルは、XApuCommandOptions::SignalOnCompletion フラグが設定されているコマンドの結果が準備できたときにシグナル状態になります。このシグナルは 3 ミリ秒ごとに発火するタイマーで動作しています。1 つ以上の XApuResult が準備できている場合、1 回シグナル状態になります。つまり、3 ミリ秒の間に複数の結果が準備でき、それらすべてに XApuCommandOptions::SignalOnCompletion フラグが設定されている場合、イベントは 1 回シグナル状態になります。 いくつの XApuResult が準備できているかを確認するには、イベントがシグナル状態になった後に XApuGetResultCount を呼び出す必要があります。XAPU クライアントで複数のストリームがアクティブになっている場合は、全体的なパフォーマンスを低下させる可能性があるため、XApuCommandOptions::SignalOnCompletion を設定することは推奨されません。代わりに、呼び出し側はコマンド グループに対して 1 回だけ SignalOnCompletion フラグを設定する必要があります。たとえば、特定のストリームのすべてのコマンドに対してのみ SignalOnCompletion を設定し、他のアクティブなストリームには設定しないようにします。
解説
XApuConnectOutputParameter は、XApuConnect によって返されるパラメーターを渡すために使用されます。XApuConnect は Audio Processing Unit (XAPU) のために必要なリソースを割り当てます。処理エンジンから切断し、XApuConnect の間に割り当てられたすべてのリソースを解放する方法の詳細については、XApuDisconnect を参照してください。コマンド オプションの詳細については、XApuCommandOptions を参照してください。
要件
ヘッダー: xapu.h サポートされているプラットフォーム: XBOX Series X|S関連項目
XApuDecodeConvertCommandXAPU