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가 지원됩니다.