Oggetti (Windows Media Format 11 SDK)
[La funzionalità associata a questa pagina, Windows Media Format 11 SDK, è una funzionalità legacy. È stata sostituita dal lettore di origine e dal 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.
Windows Media Format SDK usa diversi oggetti per leggere, scrivere, modificare e indicizzare i file ASF e per creare e modificare i profili. Ogni oggetto supporta diverse interfacce. Alcune interfacce sono supportate in più oggetti. In questi casi, eventuali differenze nell'implementazione vengono descritte nella sezione di riferimento per l'interfaccia .
Gli oggetti in Windows Media Format SDK sono conformi a COM. Per semplificare lo sviluppo, ogni oggetto ha una funzione o un metodo di creazione associato. È consigliabile creare oggetti usando la funzione di creazione o il metodo invece di usare manualmente la funzione COM CoCreateInstance.
Alcune interfacce hanno un numero aggiunto ai nomi, ad esempio IWMProfile2 e IWMWriter3. In ogni caso, le versioni numerate ereditano tutti i metodi delle versioni precedenti e aggiungono nuove funzionalità.
In ogni pagina oggetto di questo riferimento, le interfacce incluse nell'oggetto COM principale vengono elencate per prime, seguite da interfacce di callback che devono essere implementate dall'applicazione.
Nella tabella seguente sono elencati gli oggetti supportati da questo SDK con una descrizione della funzionalità di ogni sdk e la funzione usata per crearla.
| Oggetto | Descrizione | Funzione di creazione |
|---|---|---|
| Backup Restorer | Esegue il backup delle licenze, in genere su supporti rimovibili e quindi ripristina tali licenze in un computer diverso. | WMCreateBackupRestorer |
| Registrazione del dispositivo | Gestisce il database di registrazione del dispositivo, che contiene le voci per i dispositivi di riproduzione multimediale disponibili tramite una connessione di rete. | WMCreateDeviceRegistration |
| DRM Transcryptor | Converte i dati multimediali protetti da DRM in un flusso di dati che può essere inviato ai dispositivi che usano il protocollo DRM 10 di Windows Media per dispositivi di rete. | WMCreateDRMTranscryptor |
| Indicizzatore | Crea un indice per i file ASF per consentire la ricerca in file con flussi video. | WMCreateIndexer |
| Agente di revoca delle licenze | Gestisce la revoca delle licenze. | WMCreateLicenseRevocationAgent |
| Metadata Editor | Modifica i metadati in un'intestazione del file ASF. | WMCreateEditor |
| Gestione profili | Fornisce interfacce per creare, caricare e salvare i profili. Per scrivere un file ASF, è necessario un profilo. | WMCreateProfileManager |
| Lettore | Legge i file ASF. Questo oggetto usa un modello chiamante asincrono per le relative operazioni. | WMCreateReader |
| Lettore sincrono | Legge i file ASF usando chiamate sincrone. | WMCreateSyncReader |
| Scrittore | Scrive i file ASF. | WMCreateWriter |
| Writer File Sink | Controlla i file ASF scritti dall'oggetto writer. | WMCreateWriterFileSink |
| Sink di rete writer | Controlla lo streaming di rete live dei file ASF scritti dall'oggetto writer. | WMCreateWriterNetworkSink |
| Writer Push Sink | Controlla la distribuzione di contenuto di streaming ai server di pubblicazione. | WMCreateWriterPushSink |
Nella tabella seguente sono elencati gli oggetti dipendenti da altri oggetti . Questi oggetti vengono creati da metodi di oggetti esistenti.
| Oggetto | Descrizione | Metodo di creazione |
|---|---|---|
| Condivisione della larghezza di banda | Gestisce le informazioni sulla condivisione della larghezza di banda in un profilo. Per un profilo possono esistere più oggetti di condivisione della larghezza di banda. Esistono diversi metodi per la creazione di un oggetto di condivisione della larghezza di banda a seconda che si voglia creare un nuovo oggetto di condivisione della larghezza di banda o accedere a un oggetto esistente. |
IWMProfile3::CreateNewBandwidthSharingO IWMProfile3::GetBandwidthSharing |
| Buffer | Contiene un esempio multimediale e tutte le estensioni delle unità dati associate. Usato sia per la scrittura che per la lettura di esempi. |
IWMWriter::AllocateSampleO IWMReaderAllocatorEx::AllocateForOutputEx OR IWMReaderAllocatorEx::AllocateForStreamEx OR Creato automaticamente dall'oggetto lettore o dall'oggetto lettore sincrono per il recapito di esempio. |
| Proprietà dei supporti di input | Gestisce le proprietà di un input. Per ogni input può esistere un oggetto proprietà di input. | IWMWriter::GetInputProps |
| Esclusione reciproca | Gestisce le informazioni di esclusione reciproca in un profilo. Gli usi comuni per l'esclusione reciproca sono contenuti a velocità multipla e colonne sonore in diverse lingue. Esistono diversi metodi per la creazione di un oggetto di esclusione reciproca a seconda che si voglia creare un nuovo oggetto di esclusione reciproca o accedere a un oggetto esistente. |
IWMProfile::CreateNewMutualExclusionO IWMProfile::GetMutualExclusion |
| Proprietà dei supporti di output | Gestisce le proprietà di un output. Per ogni output può esistere un oggetto proprietà del supporto di output. Questi oggetti possono essere creati dal lettore o dal lettore sincrono |
IWMReader::GetOutputPropsO IWMSyncReader::GetOutputProps |
| Profilo | Contiene i dati in un profilo durante la modifica. Gli oggetti profilo vengono creati in qualsiasi momento in cui il profilo deve essere modificato. Esistono diversi metodi per la creazione di un oggetto profilo a seconda che si voglia creare un nuovo profilo o accedere a uno esistente. |
IWMProfileManager::CreateEmptyProfileO IWMProfileManager::LoadProfileByData OR IWMProfileManager::LoadProfileByID OR IWMProfileManager::LoadSystemProfile |
| Configurazione flusso | Gestisce le proprietà di un flusso all'interno di un profilo. Gli oggetti di configurazione di flusso vengono creati dagli oggetti di flusso ogni volta che è necessario accedere alle informazioni su un flusso. Esistono diversi metodi per la creazione di un oggetto di configurazione del flusso a seconda che si voglia creare un nuovo flusso o un accesso e uno esistente. |
IWMProfile::CreateNewStreamO IWMProfile::GetStream OR IWMProfile::GetStreamByNumber |
| Priorità di flusso | Gestisce l'elenco di priorità del flusso per un profilo. I flussi verranno eliminati in ordine di priorità crescente se la larghezza di banda disponibile è limitata. In un profilo può essere presente un solo oggetto di priorità di flusso. | IWMProfile3::CreateNewStreamPrioritization |