Compartir a través de


Función CreateFX (xapofx.h)

Crea una instancia del efecto XAPOFX solicitado.

Sintaxis

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

Parámetros

clsid

Identificador del efecto que se va a crear. Use el __uuidof en el nombre de la clase de efecto para obtener el CLSID de un efecto. Por ejemplo, __uuidof(FXReverb) proporcionaría el CLSID para el efecto FXReverb. Para obtener una lista de los efectos proporcionados por XAPOFX, consulte Introducción a XAPOFX. Para obtener un ejemplo de cómo recuperar el CLSID para un efecto, vea Cómo: Usar XAPOFX en XAudio2.

pEffect

Recibe un puntero a la instancia de XAPO creada. Si se produce un error en CreateFX , pEffect no se modifica.

DEFAULT

DEFAULT

Valor devuelto

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

El XAPO creado tendrá un recuento de referencias de 1. El código de cliente debe llamar a IUnknown::Release después de pasar el XAPO a XAudio2 para permitir que XAudio2 elimine el XAPO cuando ya no sea necesario. Use IXAudio2::CreateSourceVoice o IXAudio2Voice::SetEffectChain para pasar un XAPO a XAudio2.

Nota La versión del SDK de DirectX de esta función no tiene los parámetros pInitData o InitDataByteSize , ya que solo toma los dos primeros parámetros. Para establecer parámetros iniciales para el efecto XAPOFX que se crea con la versión del SDK de DirectX de esta función, debe enlazar ese efecto a una voz y usar IXAudio2Voice::SetEffectParameters. Para obtener información sobre cómo hacerlo, vea Cómo: Usar XAPOFX en XAudio2.
 

Requisitos de la plataforma

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

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado xapofx.h
Library XAudio.lib
Archivo DLL Windows.Media.Audio.dll

Vea también

Funciones