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

ISpatialAudioMetadataItems オブジェクトのストレージ用に呼び出し元が提供するメモリをアタッチします。

構文

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

[in] buffer

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

bufferLength

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

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

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

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