다음을 통해 공유


XAudio2Create 함수(xaudio2.h)

XAudio2 개체를 만들고 해당 IXAudio2 인터페이스에 대한 포인터를 반환합니다.

문법

HRESULT XAudio2Create(
  [out] IXAudio2          **ppXAudio2,
  [in]  UINT32            Flags,
  [in]  XAUDIO2_PROCESSOR XAudio2Processor
);

매개 변수

[out] ppXAudio2

작업이 성공하면 IXAudio2 개체에 대한 포인터를 반환합니다.

[in] Flags

IXAudio2 개체의 동작을 지정하는 플래그입니다. 이 매개 변수의 값은 0이어야 합니다.

[in] XAudio2Processor

사용할 CPU를 지정하는 XAUDIO2_PROCESSOR 형식의 값입니다. 여러 비트를 지정하면 시스템은 각 프로세서에 대해 별도의 작업자 스레드를 만듭니다.

XAUDIO2_PROCESSOR 기본값은 XAUDIO2_DEFAULT_PROCESSOR.

경고XAUDIO2_ANY_PROCESSOR 지정하면 시스템은 디바이스의 모든 프로세서를 사용하고 위에서 설명한 대로 각 프로세서에 대한 작업자 스레드를 만듭니다.
 
메모 프로세서 지정은 일반적으로 프로세서 간에 스레드를 효과적으로 예약하는 스케줄러의 기능을 방해할 수 있으므로 피해야 합니다. 대신 XAUDIO2_DEFAULT_PROCESSOR 값을 전달합니다(아래 참조).
 
특수 XAUDIO2_DEFAULT_PROCESSOR 값을 사용하면 XAudio2가 기본 프로세서를 사용합니다.

반환 값

성공하면 S_OK 반환하고, 그렇지 않으면 오류 코드를 반환합니다. XAudio2 관련 오류 코드에 대한 설명은 XAudio2 오류 코드를 참조하세요.

비고

DirectX SDK 버전의 XAUDIO2 릴리스 버전과 '선택됨' 버전 중에서 선택할 플래그 XAUDIO2_DEBUG_ENGINE 지원했습니다. 이 플래그는 Windows 8 버전의 XAUDIO2 지원되거나 정의되지 않습니다.

메모 DirectX SDK 버전에는 xaudio2.lib 가져오기 라이브러리가 포함되어 있지 않습니다. DirectX SDK 버전은 COM을 사용하여 새 XAudio2 개체를 만듭니다.
 

플랫폼 요구 사항

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

Windows Phone 8.1: 이 API는 지원됩니다.

요구 사항

요구 사항 가치
대상 플랫폼 윈도우즈
Header xaudio2.h
Library Xaudio2.lib
DLL Windows.Media.Audio.dll

참고하십시오

방법: 기본 오디오 처리 그래프 빌드

XAudio2 함수