ISpatialAudioMetadataItemsBuffer::AttachToBuffer-Methode (spatialaudiometadata.h)

Fügt vom Aufrufer bereitgestellten Speicher zum Speichern von ISpatialAudioMetadataItems-Objekten an.

Syntax

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

Parameter

[in] buffer

Ein Zeiger auf den Speicher, der für die Speicherung verwendet werden soll.

bufferLength

Die Länge des angegebenen Puffers. Diese Größe muss mit der Länge übereinstimmen, die für das Metadatenformat und die maximale Anzahl von Metadatenelementen erforderlich ist.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, umfassen mögliche Rückgabecodes die in der folgenden Tabelle gezeigten Werte, sind jedoch nicht darauf beschränkt.

Rückgabecode	Beschreibung
SPTLAUD_MD_CLNT_E_NO_ITEMS_OPEN	ISpatialAudioMetadataItems wurde nicht zum Kopieren mit einem Aufruf von Open geöffnet, oder das Objekt wurde zum Schreiben mit einem Aufruf von Close geschlossen.
SPTLAUD_MD_CLNT_E_ATTACH_FAILED_INTERNAL_BUFFER	Die ISpatialAudioMetadataItems wurde erstellt, um einen internen Puffer für die Medienpipeline zu verwenden, sodass kein externer Puffer angefügt werden kann.
SPTLAUD_MD_CLNT_E_BUFFER_ALREADY_ATTACHED	Der bereitgestellte Puffer wurde bereits angefügt.
E_INVALIDARG	Einer der bereitgestellten Zeiger ist ungültig. Der bereitgestellte Puffer ist nicht groß genug, um die maximale Anzahl von Metadatenelementen aufzunehmen.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	spatialaudiometadata.h

Weitere Informationen

ISpatialAudioMetadataItemsBuffer