Funzione CreateFX (xapofx.h)

Articolo
03/13/2024

Crea un'istanza dell'effetto XAPOFX richiesto.

Sintassi

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

Parametri

clsid

ID dell'effetto da creare. Usare il __uuidof sul nome della classe effetto per ottenere l'effetto CLSID. Ad esempio, __uuidof(FXReverb) fornisce il CLSID per l'effetto FXReverb. Per un elenco di effetti forniti da XAPOFX, vedere Panoramica di XAPOFX. Per un esempio di recupero di CLSID per un effetto, vedere Procedura: Usare XAPOFX in XAudio2.

pEffect

Riceve un puntatore all'istanza di XAPO creata. Se CreateFX ha esito negativo, pEffect non viene modificato.

DEFAULT

Valore restituito

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

La XAPO creata avrà un numero di riferimenti pari a 1. Il codice client deve chiamare IUnknown::Release dopo aver passato XAPO a XAudio2 per consentire a XAudio2 di eliminare XAPO quando non è più necessario. Usare IXAudio2::CreateSourceVoice o IXAudio2Voice::SetEffectChain per passare un XAPO a XAudio2.

Nota La versione directX SDK di questa funzione non ha i parametri pInitData o InitDataByteSize perché accetta solo i primi 2 parametri. Per impostare i parametri iniziali per l'effetto XAPOFX creato con la versione DirectX SDK di questa funzione, è necessario associare tale effetto a una voce e usare IXAudio2Voice::SetEffectParameters. Per informazioni su come eseguire questa operazione, vedere Procedura: Usare XAPOFX in XAudio2.

Requisiti della piattaforma

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

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	xapofx.h
Libreria	XAudio.lib
DLL	Windows.Media.Audio.dll

Vedi anche

Funzioni

Condividi tramite