Condividi tramite


Metodo ISpatialAudioMetadataItemsBuffer::AttachToPopulatedBuffer (spatialaudiometadata.h)

Collega un buffer popolato in precedenza per l'archiviazione di oggetti ISpatialAudioMetadataItems . Gli elementi di metadati già presenti nel buffer vengono conservati.

Sintassi

HRESULT AttachToPopulatedBuffer(
  [in] BYTE   *buffer,
       UINT32 bufferLength
);

Parametri

[in] buffer

Puntatore alla memoria da usare per l'archiviazione.

bufferLength

Lunghezza del buffer fornito. Questa dimensione deve corrispondere alla lunghezza necessaria per il formato dei metadati e il numero massimo di elementi dei metadati.

Valore restituito

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

Codice restituito Descrizione
SPTLAUD_MD_CLNT_E_NO_ITEMS_OPEN
ISpatialAudioMetadataItems non è stato aperto per la copia con una chiamata a Open o l'oggetto è stato chiuso per la scrittura con una chiamata a Close.
SPTLAUD_MD_CLNT_E_BUFFER_ALREADY_ATTACHED
Il buffer fornito è già stato collegato.
SPTLAUD_MD_CLNT_E_ATTACH_FAILED_INTERNAL_BUFFER
ISpatialAudioMetadataItems è stato creato per usare un buffer interno della pipeline multimediale, quindi non è possibile collegare un buffer esterno.
SPTLAUD_MD_CLNT_E_FORMAT_MISMATCH
Il buffer popolato fornito usa un formato diverso dal formato corrente.
E_INVALIDARG
Uno dei puntatori forniti non è valido.

Il buffer fornito non è abbastanza grande per contenere il numero massimo di elementi di metadati. Chiamare GetSpatialAudioMetadataItemsBufferLength per determinare le dimensioni del buffer necessarie.

Requisiti

Requisito Valore
Piattaforma di destinazione Windows
Intestazione spatialaudiometadata.h

Vedi anche

ISpatialAudioMetadataItemsBuffer