Metodo ISpatialAudioMetadataClient::ActivateSpatialAudioMetadataItems (spatialaudiometadata.h)

Articolo
08/26/2023

Crea un oggetto ISpatialAudioMetadataItems per l'archiviazione di elementi di metadati audio spaziali.

Sintassi

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

Parametri

[in] maxItemCount

Numero massimo di elementi di metadati che possono essere archiviati in ISpatialAudioMetadataItems restituiti.

[in] frameCount

Intervallo valido di posizioni di offset dei fotogrammi per gli elementi di metadati archiviati nell'oggetto ISpatialAudioMetadataItems restituito.

[out, optional] metadataItemsBuffer

Se viene fornito un puntatore, restituisce un'interfaccia ISpatialAudioMetadataItemsBuffer che fornisce metodi per collegare la memoria fornita dal chiamante per l'archiviazione degli elementi di metadati. Se questo parametro è NULL, l'oggetto allocherà l'archiviazione interna per gli elementi. Questa interfaccia non può essere ottenuta tramite QueryInterface.

[out] metadataItems

Riceve un oggetto ISpatialAudioMetadataItems di istanza che può essere popolato con elementi di metadati usando un oggetto da ISpatialAudioMetadataWriter o ISpatialAudioMetadataCopier e può essere letto con un oggetto ISpatialAudioMetadataReader.

Valore restituito

Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, i possibili codici restituiti includono, ma non sono limitati, i valori illustrati nella tabella seguente.

Codice restituito	Descrizione
E_INVALIDARG	Il puntatore fornito nel parametro metadataItems non è valido. Il valore di maxItemCount o frameCount è 0.

Requisiti


Piattaforma di destinazione	Windows
Intestazione	spatialaudiometadata.h

Vedi anche

ISpatialAudioMetadataClient

Condividi tramite