ISpatialAudioMetadataWriter::WriteNextItemCommand 메서드(spatialaudiometadata.h)

메타데이터 명령 및 값 데이터를 현재 항목에 씁니다.

구문

HRESULT WriteNextItemCommand(
  [in] BYTE       commandID,
  [in] const void *valueBuffer,
  [in] UINT32     valueBufferLength
);

[in] commandID

개체의 메타데이터 형식에서 지원하는 명령입니다. 명령이 메타데이터 형식으로 정의되지 않은 경우 호출이 실패합니다. 각 명령은 항목당 한 번만 작성할 수 있습니다.

[in] valueBuffer

메타데이터 형식 정의에 지정된 대로 명령에 특정한 데이터를 저장하는 버퍼에 대한 포인터입니다.

[in] valueBufferLength

valueBuffer 매개 변수에 제공된 명령 데이터의 크기(바이트)입니다. 크기는 메타데이터 형식으로 지정된 명령 정의와 일치해야 합니다. 그렇지 않으면 호출이 실패합니다.

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

반환 코드	설명
SPTLAUD_MD_CLNT_E_NO_ITEMS_OPEN	Open 호출을 사용하여 쓰기 위해 ISpatialAudioMetadataItems가 열리지 않았거나 닫기 호출을 사용하여 쓰기 위해 개체가 닫혔습니다.
SPTLAUD_MD_CLNT_E_NO_ITEMOFFSET_WRITTEN	Open이 호출된 후 WriteNextItemCommand를 호출하기 전에 WriteNextItem이 호출되지 않았습니다.

Open을 호출하여 쓰기용 ISpatialAudioMetadataWriter를 열고 WriteNextItemCommand를 호출하기 전에 WriteNextItem을 호출하여 현재 메타데이터 항목 오프셋을 설정해야 합니다.


대상 플랫폼	Windows
헤더	spatialaudiometadata.h