ISpatialAudioMetadataClient::ActivateSpatialAudioMetadataItems 메서드(spatialaudiometadata.h)

공간 오디오 메타데이터 항목을 저장하기 위한 ISpatialAudioMetadataItems 개체를 만듭니다.

구문

HRESULT ActivateSpatialAudioMetadataItems(
  [in]            UINT16                           maxItemCount,
  [in]            UINT16                           frameCount,
  [out, optional] ISpatialAudioMetadataItemsBuffer **metadataItemsBuffer,
  [out]           ISpatialAudioMetadataItems       **metadataItems
);

매개 변수

[in] maxItemCount

반환된 ISpatialAudioMetadataItems에 저장할 수 있는 최대 메타데이터 항목 수입니다.

[in] frameCount

반환된 ISpatialAudioMetadataItems에 저장된 메타데이터 항목에 대한 유효한 프레임 오프셋 위치 범위입니다.

[out, optional] metadataItemsBuffer

포인터가 제공되면 메타데이터 항목의 스토리지를 위해 호출자가 제공한 메모리를 연결하는 메서드를 제공하는 ISpatialAudioMetadataItemsBuffer 인터페이스를 반환합니다. 이 매개 변수가 NULL이면 개체는 항목에 대한 내부 스토리지를 할당합니다. 이 인터페이스는 QueryInterface를 통해 가져올 수 없습니다.

[out] metadataItems

ISpatialAudioMetadataWriter 또는 ISpatialAudioMetadataCopier를 사용하여 메타데이터 항목으로 채울 수 있고 ISpatialAudioMetadataReader로 읽을 수 있는 instance ISpatialAudioMetadataItems 개체를 수신합니다.

반환 값

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

반환 코드 설명
E_INVALIDARG
metadataItems 매개 변수에 제공된 포인터가 잘못되었습니다.

maxItemCount 또는 frameCount 값은 0입니다.

요구 사항

   
대상 플랫폼 Windows
헤더 spatialaudiometadata.h

추가 정보

ISpatialAudioMetadataClient