Oggetti (Windows Media Format 11 SDK)
[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 sink writer sono stati ottimizzati per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi lettore di origine e writer sink invece di 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 una serie di interfacce. Alcune interfacce sono supportate in più oggetti. In questi casi, eventuali differenze nell'implementazione vengono illustrate 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 o il metodo di creazione anziché usare manualmente la funzione COM CoCreateInstance.
Alcune interfacce hanno un numero aggiunto ai relativi 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 dell'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 delle 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 voci per i dispositivi di riproduzione multimediale disponibili tramite una connessione di rete. | WMCreateDeviceRegistration |
| transcryptor DRM | 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 |
| indexer | Crea un indice per i file ASF per abilitare la ricerca nei file con flussi video. | WMCreateIndexer |
| 'agente di revoca delle licenze | Gestisce la revoca delle licenze. | WMCreateLicenseRevocationAgent |
| editor di metadati | Modifica i metadati in un'intestazione di file ASF. | WMCreateEditor |
| Profile Manager | Fornisce interfacce per creare, caricare e salvare 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 |
| writer | Scrive i file ASF. | WMCreateWriter |
| sink di file writer | 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 |
| sink push writer | Controlla la distribuzione di contenuti in 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::CreateNewBandwidthSharingOR IWMProfile3::GetBandwidthSharing |
| buffer | Contiene un esempio multimediale ed eventuali estensioni di unità dati associate. Usato sia per la scrittura che per la lettura di esempi. |
IWMWriter::AllocateSampleOR IWMReaderAllocatorEx::AllocateForOutputEx O IWMReaderAllocatorEx::AllocateForStreamEx O 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 |
| di esclusione reciproca | Gestisce le informazioni di esclusione reciproca in un profilo. Gli usi comuni per l'esclusione reciproca sono contenuti a velocità in bit 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::CreateNewMutualExclusionOR IWMProfile::GetMutualExclusion |
| proprietà dei supporti di output | Gestisce le proprietà di un output. Un oggetto proprietà del supporto di output può esistere per ogni output. Questi oggetti possono essere creati dal lettore o dal lettore sincrono |
IWMReader::GetOutputPropsOR IWMSyncReader::GetOutputProps |
| profilo | Contiene i dati in un profilo durante la modifica. Gli oggetti profilo vengono creati ogni volta che il profilo deve essere modificato. Esistono metodi diversi per la creazione di un oggetto profilo a seconda che si voglia creare un nuovo profilo o accedere a un profilo esistente. |
IWMProfileManager::CreateEmptyProfileOR IWMProfileManager::LoadProfileByData O IWMProfileManager::LoadProfileByID O IWMProfileManager::LoadSystemProfile |
| di configurazione del flusso | Gestisce le proprietà di un flusso all'interno di un profilo. Gli oggetti di configurazione del flusso vengono creati da 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 nuovo flusso o accedervi e uno esistente. |
IWMProfile::CreateNewStreamOR IWMProfile::GetStream O IWMProfile::GetStreamByNumber |
| di definizione della priorità del 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 definizione delle priorità del flusso. | IWMProfile3::CreateNewStreamPrioritization |