ISpatialAudioMetadataCopier::CopyMetadataForFrames-Methode (spatialaudiometadata.h)

Artikel
08/26/2023

Kopiert Metadatenelemente aus dem Quellobjekt ISpatialAudioMetadataItems, das für die Open-Methode bereitgestellt wird, in das ISpatialAudioMetadataItems-Zielobjekt , das mit dem dstMetadataItems-Parameter angegeben wird. Jeder Aufruf erhöht die interne Kopierposition um die Anzahl der Frames im copyFrameCount-Parameter .

Syntax

HRESULT CopyMetadataForFrames(
  [in]  UINT16                       copyFrameCount,
  [in]  SpatialAudioMetadataCopyMode copyMode,
  [in]  ISpatialAudioMetadataItems   *dstMetadataItems,
  [out] UINT16                       *itemsCopied
);

Parameter

[in] copyFrameCount

Die Anzahl der Frames aus der aktuellen Kopierposition, für die Metadatenelemente kopiert werden. Nach dem Kopieren wird die interne Kopierposition innerhalb der Quelle SpatialAudioMetadataItems mit dem in diesem Parameter angegebenen Wert erweitert. Legen Sie diesen Wert auf 0 fest, um den gesamten Framebereich zu kopieren, der in den SpatialAudioMetadataItems-Quellelementen enthalten ist.

[in] copyMode

Ein -Wert, der den Kopiermodus für den Vorgang angibt.

[in] dstMetadataItems

Ein Zeiger auf das Ziel SpatialAudioMetadataItems für den Kopiervorgang.

[out] itemsCopied

Empfängt die Anzahl der Metadatenelemente, die im Vorgang kopiert wurden.

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.
E_INVALIDARG	Einer der bereitgestellten Zeiger ist ungültig.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	spatialaudiometadata.h

Weitere Informationen

ISpatialAudioMetadataCopier

Freigeben über