Skip to main content

XDspActivationParameters

XDSP 啟用參數。

語法

成員

type
類型:XDspProcessType
每次啟用只有一種有效的處理類型。例如,如果需要正向和反向 FFT,則必須啟用兩個 XDSP 串流,每種類型各一個。 options
類型:XDspActivationOptions
啟用選項。 blockFrameCount
類型:uint32_t
將透過 XDspSubmitCommand 傳遞給 XDSP 的每個輸入和輸出資料區塊的框架數目。此值必須是 2 的乘冪。XDspProcessType::Convolution 支援的值為 512、1024。XDspProcessType::ForwardFourierTransform 和 XDspProcessType::InverseFourierTransform 支援的值為 512、1024、2048。 channelCount
類型:uint32_t
對於 XDspProcessType::Convolution,1 表示單聲道輸入串流,2 表示立體聲輸入串流。對於 XDspProcessType::ForwardFourierTransform 和 XDspProcessType::InverseFourierTransform,此值應一律設定為 1。 impulseResponseLengthInFloats
類型:uint32_t
XDspProcessType::Convolution 處理期間將使用的脈衝回應長度,以 float 為單位。例如,如果脈衝回應包含 N 個複數 float 值組樣本,則此值應設定為 N * 2,因為每個複數 float 值組都是以兩個 float 表示。對於 XDspProcessType::ForwardFourierTransform 和 XDspProcessType::InverseFourierTransform,此參數必須為零。 impulseResponse
類型:float*
長度為 (impulseResponseLengthInFloats * sizeof(float)) 位元組的緩衝區,以一系列複數 float 值 (實數值和虛數值組) 保存脈衝回應。這表示緩衝區將有 (impulseResponseLengthInFloats / 2) 個複數 float 值組。如果已設定 XDspActivationOptions::StereoImpulseResponse 且 XDspActivationParameters::channelCount 等於 2,則緩衝區長度必須為 (impulseResponseLengthInFloats * sizeof(float) * channelCount) 位元組。對於 XDspProcessType::ForwardFourierTransform 和 XDspProcessType::InverseFourierTransform,此參數必須設定為 nullptr。此緩衝區不需要來自 XDspConnect 所註冊的 baseBuffer。

需求

標頭: XDspAudio.h 支援的平台: XBOX Series X|S

概念文件

另請參閱

XDSP
XDspProcessType
XDspActivationOptions
XDspSubmitCommand
XDspActivationParameters
XDspConnect
使用 XDSP API 進行單一串流 Convolution 的概觀
使用 XDSP API 進行單一串流 FFT/IFFT 的概觀
Last modified on October 6, 2026