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	一或多個引數無效。
XDSP_E_NO_DEVICE_RESOURCES	沒有可用的 XDSP 裝置資源來處理您的要求。
XDSP_E_INVALID_IMPULSE_RESPONSE_LENGTH	提供的脈衝回應長度無效。如果提供的 impulseResponseLengthInFloats 小於 (`9 * blockSize * 2`) 或大於 16 秒 (`16 * 48000 * 2`),就可能發生此錯誤。

備註

此呼叫速度很快,因為它是從集區取得資源,而不是配置資源。呼叫端必須為 XDSP 串流指定要執行的 XDspProcessType。XDSP 串流的執行個體在其存留期間只能使用一種處理類型。若要執行兩種以上不同的處理類型,必須具現化兩個以上的 XDSP 串流執行個體。在 XDspActivationParameters 結構中,呼叫端必須指定下列項目:

啟用選項。
每個命令中將處理的框架數目,也就是輸入和輸出的框架數目。
串流的聲道數目。僅支援單聲道和立體聲輸入串流。
對於 XDspProcessType::Convolution 處理類型,指定以 float 為單位的脈衝回應長度。
對於 XDspProcessType::Convolution 處理類型,指定以頻域值表示的脈衝回應。

如果呼叫成功,將會傳回有效的 XDspStreamHandle,以便針對此串流搭配其他呼叫 (XDspSubmitCommand、XDspSubmitCommandWithEnvelope、XDspDeactivate) 使用。此外,如果此呼叫成功,它會傳回 XDspStatus 的指標,可用來檢查已提交命令的狀態。這應該用來判斷已處理的最新命令,以及已提交命令的結果是否已準備好可供取用。 XDspStatus 也包含其所代表 XDSP 串流最後提交至硬體之命令的序號,以及第一個失敗命令的序號。在摺積處理的情況下,呼叫端可以在此呼叫傳回後釋放脈衝回應記憶體。

需求

標頭: XDspAudio.h 程式庫: Chad.lib 支援的平台: XBOX Series X|S

概念文件

另請參閱

XDSP
XDSP 錯誤
使用 XDSP API 進行單一串流 Convolution 的概觀
使用 XDSP API 進行單一串流 FFT/IFFT 的概觀
使用 XDSP API 進行含 Envelope 的單一串流 Convolution 的概觀

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

XDspActivate

XDspActivate

語法

參數

傳回值

備註

需求

概念文件

另請參閱

​XDspActivate

​語法

​參數

​傳回值

​備註

​需求

​概念文件

​另請參閱

XDspActivate

語法

參數

傳回值

備註

需求

概念文件

另請參閱