Uso dei metadati
[La funzionalità associata a questa pagina, Windows Media Format 11 SDK, è una funzionalità legacy. È stata sostituita da Lettore di origine e Writer sink. Lettore di origine e Writer sink sono stati ottimizzati per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi Lettore di origine e Writer sink anziché Windows Media Format 11 SDK, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.
Il supporto dei metadati viene fornito dall'oggetto writer, dal lettore e dagli oggetti lettore sincroni e dall'oggetto editor di metadati. Per informazioni generali sui metadati, vedere Metadati. Per informazioni sulle funzionalità che supportano i metadati in Windows Media Format SDK, vedere Funzionalità dei metadati.
L'interfaccia per la modifica dei metadati è IWMHeaderInfo3, che è possibile ottenere chiamando il metodo QueryInterface di qualsiasi interfaccia in uno degli oggetti elencati sopra. IWMHeaderInfo3 eredita i metodi di IWMHeaderInfo e IWMHeaderInfo2. I metodi di IWMHeaderInfo3 che gestiscono gli attributi dei metadati rappresentano un approccio diverso per accedere ai metadati rispetto a quelli usati dai metodi di IWMHeaderInfo. È consigliabile usare sempre i metodi più recenti.
I metadati in un file ASF vengono identificati da un indice e da un numero di flusso. Gli attributi a livello di file vengono assegnati a un numero di flusso pari a 0. Nelle versioni precedenti di Windows Media Format SDK è possibile identificare gli attributi in base al nome. Tuttavia, poiché è ora possibile duplicare i nomi degli attributi all'interno di un flusso, questo non è più possibile. È invece possibile recuperare tutti gli indici corrispondenti a un nome. Per altre informazioni, vedere Recupero degli attributi dei metadati.
Per aiutare a trovare rapidamente gli attributi, è possibile usare un numero di flusso speciale, 0xFFFF. Usare questo numero di flusso per identificare il file nel suo complesso, anziché uno specifico flusso o gli attributi a livello di file. Gli oggetti di Windows Media Format SDK mantengono indici separati per ogni flusso e per gli attributi a livello di file. Quando si usa l'0xFFFF di flusso, gli indici sono diversi da quelli usati quando si specifica un flusso specifico. Ad esempio, l'attributo indice 0 per il flusso 0 non sarà uguale all'attributo 0 per il flusso 0xFFFF.
Le sezioni seguenti descrivono l'uso dei metadati in modo più dettagliato.
| Sezione | Descrizione |
|---|---|
| Recupero degli attributi dei metadati | Viene descritto come leggere gli attributi dei metadati da un'intestazione di file. |
| Impostazione degli attributi dei metadati | Viene descritto come aggiungere nuovi attributi di metadati a un'intestazione di file. |
| Modifica degli attributi dei metadati | Viene descritto come modificare gli attributi dei metadati esistenti. |
| Rimozione degli attributi dei metadati | Viene descritto come rimuovere gli attributi dei metadati esistenti. |
| Uso di attributi di metadati complessi | Viene descritto come usare gli attributi i cui valori sono rappresentati da strutture. |
Diverse applicazioni di esempio mostrano come recuperare e modificare i metadati. In particolare, vedere l'esempio MetadataEdit, che include sia versioni C++ che C#.
Argomenti correlati