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 |
|---|---|
|
Der im metadataItems-Parameter bereitgestellte Zeiger ist ungültig.
Der Wert von maxItemCount oder frameCount ist 0. |
Anforderungen
| Zielplattform | Windows |
| Kopfzeile | spatialaudiometadata.h |