共用方式為

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 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

請參閱

函式