ISpatialAudioMetadataItemsBuffer::AttachToPopulatedBuffer メソッド (spatialaudiometadata.h)

ISpatialAudioMetadataItems オブジェクトの格納用に、以前に設定されたバッファーをアタッチします。バッファーに既に含まれているメタデータ項目は保持されます。

構文

HRESULT AttachToPopulatedBuffer(
  [in] BYTE   *buffer,
       UINT32 bufferLength
);

[in] buffer

ストレージに使用するメモリへのポインター。

bufferLength

指定されたバッファーの長さ。このサイズは、メタデータ形式と最大メタデータ項目数に必要な長さと一致する必要があります。

メソッドが成功した場合は、S_OK を返します。エラーが発生した場合、次の表に示す値が、可能なリターンコードに含まれますが、これらに限定されません。

リターンコード	説明
SPTLAUD_MD_CLNT_E_NO_ITEMS_OPEN	ISpatialAudioMetadataItems が Open の呼び出しでコピー用に開かれていません。または、オブジェクトが Close の呼び出しで書き込みのために閉じられました。
SPTLAUD_MD_CLNT_E_BUFFER_ALREADY_ATTACHED	指定されたバッファーは既にアタッチされています。
SPTLAUD_MD_CLNT_E_ATTACH_FAILED_INTERNAL_BUFFER	ISpatialAudioMetadataItems は、メディアパイプラインの内部バッファーを使用するように作成されているため、外部バッファーをアタッチできません。
SPTLAUD_MD_CLNT_E_FORMAT_MISMATCH	指定された設定済みバッファーでは、現在の形式とは異なる形式が使用されます。
E_INVALIDARG	指定されたポインターの 1 つが無効です。指定されたバッファーは、メタデータ項目の最大数を保持するのに十分な大きさではありません。 GetSpatialAudioMetadataItemsBufferLength を呼び出して、必要なバッファーサイズを決定します。

要件	値
対象プラットフォーム	Windows
ヘッダー	spatialaudiometadata.h