閱讀英文

共用方式為


CreateFX 函式 (xapofx.h)

建立要求的 XAPOFX 效果實例。

語法

FX_API_(HRESULT) CreateFX(
             REFCLSID                clsid,
             IUnknown                **pEffect,
             const void *pInitDat    DEFAULT,
             UINT32 InitDataByteSize DEFAULT
);

參數

clsid

要建立之效果的標識碼。 使用效果類別名稱上的 __uuidof ,取得效果的CLSID。 例如, __uuidof (FXReverb) 會提供 FXReverb 效果的 CLSID。 如需 XAPOFX 所提供的效果清單,請參閱 XAPOFX 概觀。 如需擷取效果 CLSID 的範例,請參閱 如何:在 XAudio2 中使用 XAPOFX

pEffect

接收所建立 XAPO 實例的指標。 如果 CreateFX 失敗, 則 pEffect 不會變更。

DEFAULT

DEFAULT

傳回值

如果此函式成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。

備註

建立的 XAPO 會有 1 個參考計數。 用戶端程式代碼必須將 XAPO 傳遞至 XAudio2 之後呼叫 IUnknown::Release ,以允許 XAudio2 在不再需要時處置 XAPO。 使用 IXAudio2::CreateSourceVoiceIXAudio2Voice::SetEffectChain 將 XAPO 傳遞至 XAudio2。

注意 此函式的 DirectX SDK 版本沒有 pInitDataInitDataByteSize 參數,因為它只會採用前 2 個參數。 若要設定以此函式 DirectX SDK 版本建立的 XAPOFX 效果的初始參數,您必須將該效果係結至語音,並使用 IXAudio2Voice::SetEffectParameters。 如需如何執行這項操作的詳細資訊,請參閱 如何:在 XAudio2 中使用 XAPOFX
 

平臺需求

Windows 10 (XAudio2.9) ;Windows 8,Windows Phone 8 (XAudio 2.8) ;DirectX SDK (XAudio 2.7)

規格需求

需求
目標平台 Windows
標頭 xapofx.h
程式庫 XAudio.lib
Dll Windows.Media.Audio.dll

請參閱

函式