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::CreateSourceVoice 或 IXAudio2Voice::SetEffectChain 將 XAPO 傳遞至 XAudio2。
注意 此函式的 DirectX SDK 版本沒有 pInitData 或 InitDataByteSize 參數,因為它只會採用前 2 個參數。 若要設定以此函式 DirectX SDK 版本建立的 XAPOFX 效果的初始參數,您必須將該效果係結至語音,並使用 IXAudio2Voice::SetEffectParameters。
如需如何執行這項操作的詳細資訊,請參閱 如何:在 XAudio2 中使用 XAPOFX。
需求 | 值 |
---|---|
目標平台 | Windows |
標頭 | xapofx.h |
程式庫 | XAudio.lib |
Dll | Windows.Media.Audio.dll |