ISpatialAudioMetadataItemsBuffer::AttachToPopulatedBuffer-Methode (spatialaudiometadata.h)

Fügt einen zuvor aufgefüllten Puffer zum Speichern von ISpatialAudioMetadataItems-Objekten an . Die Metadatenelemente, die sich bereits im Puffer befinden, werden beibehalten.

Syntax

HRESULT AttachToPopulatedBuffer(
  [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_BUFFER_ALREADY_ATTACHED	Der bereitgestellte Puffer wurde bereits angefügt.
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_FORMAT_MISMATCH	Der bereitgestellte aufgefüllte Puffer verwendet ein anderes Format als das aktuelle Format.
E_INVALIDARG	Einer der bereitgestellten Zeiger ist ungültig. Der bereitgestellte Puffer ist nicht groß genug, um die maximale Anzahl von Metadatenelementen aufzunehmen. Rufen Sie GetSpatialAudioMetadataItemsBufferLength auf, um die erforderliche Puffergröße zu bestimmen.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	spatialaudiometadata.h

Weitere Informationen

ISpatialAudioMetadataItemsBuffer