다음을 통해 공유


ISpatialAudioObjectForHrtf::SetOrientation 메서드(spatialaudiohrtf.h)

ISpatialAudioObjectForHrtf 오디오 데이터가 렌더링되는 수신기의 참조 프레임을 기준으로 3D 공간에서 방향을 설정합니다.

구문

HRESULT SetOrientation(
  [in] const SpatialAudioHrtfOrientation *orientation
);

매개 변수

[in] orientation

행 주 3x3 회전 행렬을 정의하는 float 배열입니다.

반환 값

메서드가 성공하면 S_OK가 반환되고, 실패할 경우 가능한 반환 코드는 다음 표에 표시된 값을 포함하지만 이에 국한되지 않습니다.

반환 코드 설명
SPTLAUDCLNT_E_OUT_OF_ORDER

SetOrientation을 호출하기 전에 ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects가 호출되지 않았습니다.

SPTLAUDCLNT_E_RESOURCES_INVALIDATED

SetEndOfStream 은 이전 오디오 처리 단계에서 명시적으로 또는 암시적으로 호출되었습니다. GetBuffer가 오디오 처리 패스 내에서 호출되지 않는 경우 시스템에서 SetEndOfStream을 암시적으로 호출합니다(ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjectsISpatialAudioObjectRenderStreamBase::EndUpdatingAudioObjects 호출 사이).

설명

SetOrientation이 호출되지 않으면 ID 행렬의 기본값이 사용됩니다. SetOrientation이 호출되면 SetOrientation에 대한 다른 호출로 방향이 변경될 때까지 설정된 방향이 오디오 개체에 사용됩니다.

요구 사항

   
대상 플랫폼 Windows
헤더 spatialaudiohrtf.h

추가 정보

ISpatialAudioObjectForHrtf