ISpatialAudioMetadataItemsBuffer::AttachToBuffer-Methode (spatialaudiometadata.h)

  • Artikel

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