ISpatialAudioClient::GetStaticObjectPosition 메서드(spatialaudioclient.h)

지정된 정적 공간 오디오 채널의 3D 공간에서 위치를 가져옵니다.

구문

HRESULT GetStaticObjectPosition(
  [in]  AudioObjectType type,
  [out] float           *x,
  [out] float           *y,
  [out] float           *z
);

[in] type

위치를 쿼리할 정적 공간 오디오 채널을 나타내는 값입니다. 값이 AudioObjectType_Dynamic 및 AudioObjectType_None 포함하여 정적 채널을 나타내지 않으면 이 메서드는 E_INVALIDARG 반환합니다.

[out] x

수신기를 기준으로 정적 오디오 채널의 x 좌표(미터)입니다. 양수 값은 수신기 오른쪽에 있고 음수 값은 왼쪽에 있습니다.

[out] y

수신기를 기준으로 정적 오디오 채널의 y 좌표(미터)입니다. 양수 값은 수신기보다 높고 음수 값은 다음과 같습니다.

[out] z

수신기를 기준으로 정적 오디오 채널의 z 좌표(미터)입니다. 양수 값은 수신기 뒤에 있고 음수 값은 앞에 있습니다.

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

반환 코드	설명
E_INVALIDARG	제공된 AudioObjectType 값은 정적 채널을 나타내지 않습니다.

위치 값은 오른손 카티시안 좌표계를 사용하며 각 단위는 1미터를 나타냅니다. 좌표계는 원본(x=0.0, y=0.0, z=0.0)이 수신기 귀 사이의 중심점을 나타내는 수신기를 기준으로 합니다.


대상 플랫폼	Windows
헤더	spatialaudioclient.h