SpatialAudioObjectRenderStreamForMetadataActivationParams 구조체(spatialaudiometadata.h)

메타데이터에 대한 공간 오디오 렌더링 스트림에 대한 활성화 매개 변수를 나타냅니다. 스트림을 활성화할 때 이 구조를 ISpatialAudioClient::ActivateSpatialAudioStream 에 전달합니다.

구문

typedef struct SpatialAudioObjectRenderStreamForMetadataActivationParams {
  const WAVEFORMATEX                    *ObjectFormat;
  AudioObjectType                       StaticObjectTypeMask;
  UINT32                                MinDynamicObjectCount;
  UINT32                                MaxDynamicObjectCount;
  AUDIO_STREAM_CATEGORY                 Category;
  HANDLE                                EventHandle;
  GUID                                  MetadataFormatId;
  UINT16                                MaxMetadataItemCount;
  const PROPVARIANT                     *MetadataActivationParams;
  ISpatialAudioObjectRenderStreamNotify *NotifyObject;
} SpatialAudioObjectRenderStreamForMetadataActivationParams;

멤버

ObjectFormat

단일 공간 오디오 개체에 대한 서식 설명자입니다. 스트림에서 사용되는 모든 개체의 형식은 동일해야 하며 형식은 WAVEFORMATEX 또는 WAVEFORMATEXTENSIBLE 형식이어야 합니다.

StaticObjectTypeMask

활성화된 스트림에서 허용할 정적 공간 오디오 채널 집합을 나타내는 AudioObjectType 값의 비트 조합입니다.

MinDynamicObjectCount

동시 동적 개체의 최소 수입니다. 이 수의 동적 오디오 개체를 동시에 활성화할 수 없는 경우 이 오류 SPTLAUDCLNT_E_NO_MORE_OBJECTSISpatialAudioClient::ActivateSpatialAudioStream이 실패합니다.

MaxDynamicObjectCount

ISpatialAudioObjectRenderStream으로 활성화할 수 있는 동시 동적 개체의 최대 수입니다.

Category

오디오 스트림 및 해당 공간 오디오 개체의 범주입니다.

EventHandle

클라이언트가 더 많은 오디오 데이터를 제공하도록 신호를 보낼 이벤트입니다. 이 핸들은 사용하기 전에 내부적으로 중복됩니다.

MetadataFormatId

현재 활성 공간 렌더링 엔진에 대한 메타데이터 형식의 식별자입니다.

MaxMetadataItemCount

프레임당 최대 메타데이터 항목 수입니다.

MetadataActivationParams

추가 활성화 매개 변수입니다.

NotifyObject

공간 오디오 클라이언트가 ISpatialAudioObjectRenderStream의 상태 변경에 응답하도록 알림을 제공하는 개체입니다. 이 개체는 동시에 활성화할 수 있는 동적 공간 오디오 개체의 수가 변경될 것임을 클라이언트에 알리는 데 사용됩니다.

요구 사항