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

Guida di riferimento alla programmazione