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

성공하면 현재 활성 공간 렌더링 엔진이 지정된 공간 오디오 렌더링 스트림을 지원하는지 여부를 나타내는 값을 가져옵니다.

구문

HRESULT IsSpatialAudioStreamAvailable(
  [in]           REFIID            streamUuid,
  [in, optional] const PROPVARIANT *auxiliaryInfo
);

매개 변수

[in] streamUuid

가용성이 쿼리되는 인터페이스의 인터페이스 ID입니다.

[in, optional] auxiliaryInfo

지원을 쿼리할 때 사용할 추가 정보가 포함된 구조체입니다. 자세한 내용은 설명 부분을 참조하세요.

반환 값

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

반환 코드	설명
SPTLAUDCLNT_E_STREAM_IS_NOT_AVAILABLE	지정된 스트림 인터페이스는 현재 활성 렌더링 엔진에서 활성화할 수 없습니다.
SPTLAUDCLNT_E_METADATA_FORMAT_IS_NOT_SUPPORTED	auxiliaryInfo 매개 변수에 제공된 메타데이터 형식은 현재 렌더링 엔진에서 지원되지 않습니다. 자세한 내용은 비고를 참조하세요.

설명

ISpatialAudioObjectRenderStreamForMetadata를 쿼리할 때 auxilaryInfo 매개 변수를 사용하여 특정 메타데이터 형식이 지원되는지 쿼리할 수 있습니다. 다음 코드 예제에서는 PROPVARIANT 구조를 초기화하여 예제 메타데이터 형식에 대한 지원을 검사 방법을 보여 줍니다.

PROPVARIANT auxiliaryInfo;  
auxiliaryInfo.vt = VT_CLSID;  
auxiliaryInfo.puuid = const_cast<CLSID*>(&CONTOSO_SPATIAL_METADATA_V1_0);  

지정된 메타데이터 형식이 지원되지 않으면 IsSpatialAudioStreamAvailable 은 SPTLAUDCLNT_E_METADATA_FORMAT_IS_NOT_SUPPORTED 반환합니다.

요구 사항

대상 플랫폼	Windows
헤더	spatialaudioclient.h

추가 정보

ISpatialAudioClient