CreateFX 함수(xapofx.h)

요청된 XAPOFX 효과의 instance 만듭니다.

구문

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

매개 변수

clsid

만들 효과의 ID입니다. 효과 클래스 이름에 __uuidof 사용하여 효과에 대한 CLSID를 가져옵니다. 예를 들어 __uuidof(FXReverb)는 FXReverb 효과에 대한 CLSID를 제공합니다. XAPOFX에서 제공하는 효과 목록은 XAPOFX 개요를 참조하세요. 효과에 대한 CLSID를 검색하는 예제는 방법: XAudio2에서 XAPOFX 사용을 참조하세요.

pEffect

만든 XAPO instance 대한 포인터를 받습니다. CreateFX가 실패하면 pEffect 는 그대로 유지됩니다.

DEFAULT

DEFAULT

반환 값

이 함수가 성공하면 S_OK 반환합니다. 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

생성된 XAPO의 참조 수는 1입니다. XAudio2가 더 이상 필요하지 않은 경우 XAudio2에서 XAPO를 삭제할 수 있도록 클라이언트 코드는 XAudio2에 XAPO를 전달한 후 IUnknown::Release 를 호출해야 합니다. IXAudio2::CreateSourceVoice 또는 IXAudio2Voice::SetEffectChain을 사용하여 XAPO를 XAudio2에 전달합니다.

참고 이 함수의 DirectX SDK 버전에는 처음 2개의 매개 변수만 사용되므로 pInitData 또는 InitDataByteSize 매개 변수가 없습니다. 이 함수의 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

참조

함수