ISpatialAudioMetadataClient::ActivateSpatialAudioMetadataItems-Methode (spatialaudiometadata.h)

Erstellt ein ISpatialAudioMetadataItems-Objekt zum Speichern räumlicher Audiometadatenelemente.

Syntax

HRESULT ActivateSpatialAudioMetadataItems(
  [in]            UINT16                           maxItemCount,
  [in]            UINT16                           frameCount,
  [out, optional] ISpatialAudioMetadataItemsBuffer **metadataItemsBuffer,
  [out]           ISpatialAudioMetadataItems       **metadataItems
);

Parameter

[in] maxItemCount

Die maximale Anzahl von Metadatenelementen, die in den zurückgegebenen ISpatialAudioMetadataItems gespeichert werden können.

[in] frameCount

Der gültige Bereich der Frameoffsetpositionen für Metadatenelemente, die in den zurückgegebenen ISpatialAudioMetadataItems gespeichert sind.

[out, optional] metadataItemsBuffer

Wenn ein Zeiger angegeben wird, gibt eine ISpatialAudioMetadataItemsBuffer-Schnittstelle zurück, die Methoden zum Anfügen des vom Aufrufer bereitgestellten Arbeitsspeichers zum Speichern von Metadatenelementen bereitstellt. Wenn dieser Parameter NULL ist, ordnet das Objekt internen Speicher für die Elemente zu. Diese Schnittstelle kann nicht über QueryInterface abgerufen werden.

[out] metadataItems

Empfängt ein instance ISpatialAudioMetadataItems-Objekt, das mithilfe von ISpatialAudioMetadataWriter oder ISpatialAudioMetadataCopier mit Metadatenelementen aufgefüllt werden kann und mit einem ISpatialAudioMetadataReader gelesen werden kann.

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
E_INVALIDARG	Der im metadataItems-Parameter bereitgestellte Zeiger ist ungültig. Der Wert von maxItemCount oder frameCount ist 0.

Anforderungen

Zielplattform	Windows
Kopfzeile	spatialaudiometadata.h

Weitere Informationen

ISpatialAudioMetadataClient