Interfacce SDK del formato Windows Media

[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.

Le due tabelle seguenti descrivono le interfacce supportate da questo SDK e mostrano la relativa relazione con oggetti e altre interfacce.

Interfaccia Descrizione
INSNetSourceCreator Crea un plug-in di origine di rete amministrativa, che può essere usato per memorizzare nella cache le password e individuare i server proxy.
INSSBuffer Controlla un buffer archiviato in un oggetto buffer. Questa interfaccia viene usata per passare esempi da e verso metodi in questo SDK.
INSSBuffer2 Eredita da INSSBuffer. I nuovi metodi di questa interfaccia non sono documentati perché non sono implementati in questa versione.
INSSBuffer3 Imposta e recupera le proprietà del buffer. Le proprietà del buffer vengono usate per trasmettere informazioni con un buffer quando vengono passate a o dai metodi di questo SDK.
INSSBuffer4 Enumera le proprietà del buffer.
IReferenceClock Fornisce l'accesso a un orologio di riferimento standard.
IRMGetLicense Esegue l'acquisizione di licenze lato client.
IWMAddressAccess Controlla gli elenchi di accesso IP nell'oggetto sink di rete writer.
IWMAddressAccess2 Aggiunge il supporto IPv6 all'interfaccia IWMAddressAccess .
IWMAuthorizer Fornisce l'accesso ai certificati.
IWMBackupRestoreProps Imposta, recupera e rimuove le proprietà richieste dalle interfacce IWMLicenseBackup e IWMLicenseRestore .
IWMBandwidthSharing Configura gli oggetti di condivisione della larghezza di banda. Gli oggetti di condivisione della larghezza di banda vengono creati dagli oggetti profilo per specificare i flussi che, indipendentemente dalle singole frequenze di bit, non useranno mai più di una determinata quantità di larghezza di banda tra di esse.
IWMClientConnections Recupera informazioni sui client connessi a un oggetto sink di rete writer.
IWMClientConnections2 Recupera informazioni avanzate sui client connessi a un oggetto sink di rete writer.
IWMCodecAMVideoAccelerator Esposto da DMO del decodificatore Windows Media e chiamato dal filtro di origine di un lettore multimediale per configurare le varie connessioni necessarie per abilitare DirectX VA per la decodifica del contenuto di Windows Media Video.
IWMCodecInfo Recupera i formati disponibili per i codec audio supportati caricati nel sistema. Questi formati vengono usati durante la creazione di flussi audio nei profili.
IWMCodecInfo2 Fornisce l'accesso ai nomi dei codec e alle descrizioni dei formati supportati da ognuno.
IWMCodecInfo3 Fornisce l'accesso alle proprietà codec e alle proprietà del formato audio. Consente anche di eseguire query sui codec per il supporto delle funzionalità.
IWMCodecVideoAccelerator Questa interfaccia non è supportata. Usare invece IWMCodecAMVideoAccelerator .
IWMCredentialCallback Acquisisce le credenziali degli utenti e verifica che dispongano dell'autorizzazione per accedere a un sito remoto.
IWMDeviceRegistration Gestisce il database di registrazione del dispositivo, che contiene le voci per i dispositivi di riproduzione multimediale digitale connessi alle reti locali.
IWMDRMEditor Consente alle applicazioni di esaminare le proprietà dell'intestazione DRM senza disporre di una licenza per il contenuto protetto.
IWMDRMMessageParser Analizza i messaggi ricevuti dai dispositivi di riproduzione multimediale digitale.
IWMDRMReader Acquisisce le licenze, configura le proprietà DRM e individualizza i client.
IWMDRMReader2 Legge le licenze create usando Windows Media Rights Manager 10 SDK.
IWMDRMReader3 Consente la trascrizione del contenuto fornendo un metodo per ottenere i sistemi di protezione approvati da una licenza.
IWMDRMTranscryptor Converte il contenuto protetto da DRM in un flusso di dati che può essere inviato usando il protocollo di trasferimento sicuro di Windows Media DRM 10 per i dispositivi di rete.
IWMDRMWriter Fornisce funzionalità di creazione di licenze dall'oggetto writer.
IWMDRMWriter2 Configura il writer per accettare esempi di flusso contenenti dati crittografati per lo streaming nei dispositivi che supportano Windows Media DRM 10 per i dispositivi di rete.
IWMDRMWriter3 Consente la scrittura di esempi di flusso crittografati per l'importazione di contenuto protetto.
IWMGetSecureChannel Questa interfaccia viene usata da una parte di comunicazione per ottenere l'interfaccia IWMSecureChannel dell'altra parte.
IWMHeaderInfo Gestisce le informazioni di intestazione, ad esempio metadati, marcatori e così via.
IWMHeaderInfo2 Fornisce l'accesso alle informazioni sui codec usati per creare il file.
IWMHeaderInfo3 Fornisce supporto per il linguaggio degli attributi e altre funzionalità avanzate dei metadati.
IWMImageInfo Recupera i fotogrammi "APIC" ID3v2 da un file. È consigliabile evitare l'uso di questa interfaccia a favore dell'attributo WM/Picture .
IWMIndexer Fornisce metodi per indicizzare manualmente i file.
IWMIndexer2 Fornisce le opzioni di configurazione dell'indicizzazione.
IWMInputMediaProps Gestisce le proprietà di un flusso multimediale di input.
IWMIStreamProps Legge le proprietà di un oggetto IStream .
IWMLanguageList Gestisce l'elenco di lingue per un file ASF.
IWMLicenseBackup Esegue il backup delle licenze, in genere in modo che possano essere ripristinate in un altro computer.
IWMLicenseRestore Ripristina le licenze.
IWMMediaProps Fornisce l'accesso alla struttura del tipo di supporto per un flusso.
IWMMetadataEditor Fornisce la gestione dei file per la modifica dei metadati.
IWMMetadataEditor2 Fornisce un metodo migliorato per l'apertura dei file da usare dall'editor di metadati.
IWMMutualExclusion Configura oggetti di esclusione reciproca. Un oggetto di esclusione reciproca viene creato da un oggetto profile per specificare un gruppo di flussi reciprocamente esclusivi.
IWMMutualExclusion2 Aggiunge il supporto di raggruppamento e denominazione per l'esclusione reciproca.
IWMOutputMediaProps Gestisce le proprietà di un flusso di output.
IWMPacketSize Gestisce le dimensioni massime dei pacchetti in un file ASF.
IWMPacketSize2 Gestisce le dimensioni minime dei pacchetti in un file ASF.
IWMPlayerHook Implementato da un'applicazione lettore che usa l'accelerazione video DirectX (DirectX VA). Consente di eseguire l'elaborazione specifica dell'applicazione quando gli esempi da un flusso video vengono passati alla scheda video abilitata per la decompressione directX VA.
IWMPlayerTimestampHook Implementato nel filtro di origine del lettore o del lettore. Consente al filtro di modificare i timestamp negli esempi video prima di recapitarli a valle.
IWMProfile Gestisce la creazione e la modifica dei profili. I profili descrivono il formato di un file, ad esempio tipo di flusso, velocità di bit e così via. La maggior parte delle applicazioni usa profili esistenti e non deve implementare questa interfaccia.
IWMProfile2 Fornisce l'accesso agli ID profilo.
IWMProfile3 Fornisce metodi per gestire la condivisione della larghezza di banda, la priorità di flusso e altre funzionalità avanzate supportate dai profili.
IWMProfileManager Gestisce il caricamento e il salvataggio dei profili.
IWMProfileManager2 Gestisce i numeri di versione dei profili di sistema usati dall'oggetto profile manager.
IWMProfileManagerLanguage Gestisce la lingua dei profili di sistema enumerati.
IWMPropertyVault Fornisce un'interfaccia standardizzata per la gestione delle proprietà.
IWMProximityDetection Convalida un dispositivo in una rete locale. Un dispositivo deve essere convalidato prima di poter ricevere dati usando il protocollo di trasferimento sicuro di Windows Media DRM 10 per dispositivi di rete.
IWMReader Gestisce la lettura asincrona dei file ASF.
IWMReaderAccelerator Implementato nell'oggetto Reader WM. Viene chiamato da un lettore o da un filtro di origine lettore per ottenere interfacce dal decodificatore DMO.
IWMReaderAdvanced Fornisce funzionalità avanzate del lettore, ad esempio un orologio fornito dall'utente, l'allocazione del buffer, le statistiche restituite e la ricezione di notifiche di selezione del flusso.
IWMReaderAdvanced2 Fornisce un'ulteriore gamma di metodi avanzati per un oggetto lettore esistente.
IWMReaderAdvanced3 Fornisce altri metodi avanzati per l'oggetto reader.
IWMReaderAdvanced4 Fornisce il supporto per la selezione della lingua e altre funzionalità di lettura avanzate.
IWMReaderAdvanced5 Consente di associare un'interfaccia di callback del player-hook all'oggetto reader.
IWMReaderAdvanced6 Abilita la protezione di esempio.
IWMReaderAllocatorEx Fornisce alternative espanse ai metodi AllocateForOutput e AllocateForStream dell'interfaccia IWMReaderCallbackAdvanced .
IWMReaderCallback Implementato dall'applicazione per fornire informazioni di esempio e stato su un'operazione di lettura corrente.
IWMReaderCallbackAdvanced Facoltativamente implementato dall'applicazione per fornire funzionalità avanzate a un oggetto callback lettore esistente.
IWMReaderNetworkConfig Gestisce le impostazioni di configurazione della rete.
IWMReaderNetworkConfig2 Fornisce funzionalità di configurazione di rete aggiuntive.
IWMReaderPlaylistBurn Conferma i diritti DRM per la copia dei file in una playlist su CD.
IWMReaderStreamClock Usato per impostare e annullare timer sugli orologi di flusso, nonché per recuperare il valore corrente dell'orologio di flusso.
IWMReaderTimecode Fornisce informazioni sui codici di tempo SMPTE in un file.
IWMReaderTypeNegotiation Fornisce un singolo metodo che può essere usato per verificare se alcune modifiche alle proprietà di output di un flusso funzionano correttamente.
IWMRegisterCallback Consente all'applicazione di ottenere messaggi di stato da un oggetto sink.
IWMRegisteredDevice Fornisce l'accesso ai dati in una voce nel database di registrazione del dispositivo.
IWMSBufferAllocator Fornisce metodi per l'allocazione dei buffer in un server.
IWMSecureChannel Fornisce metodi che consentono a due DLL di convalidare l'uno l'altro ed eseguire comunicazioni sicure
IWMSInternalAdminNetSource Gestisce la cache delle password e il percorso proxy.
IWMSInternalAdminNetSource2 Fornisce metodi di memorizzazione nella cache delle password più sicuri di IWMSInternalAdminNetSource.
IWMSInternalAdminNetSource3 Fornisce un metodo migliorato per individuare i server proxy.
IWMStatusCallback Implementato dall'applicazione per rispondere allo stato di diversi oggetti di questo SDK.
IWMStreamConfig Gestisce la configurazione dei flussi da usare nei profili.
IWMStreamConfig2 Fornisce altri metodi di manipolazione del flusso.
IWMStreamConfig3 Gestisce le informazioni sulla lingua per i flussi.
IWMStreamList Gestisce i vari oggetti che definiscono le relazioni tra flussi.
IWMStreamPrioritization Fornisce metodi per configurare l'oggetto di definizione delle priorità del flusso.
IWMSyncReader Consente di leggere i file con chiamate sincrone.
IWMSyncReader2 Aggiunge il supporto del codice ora SMPTE al lettore sincrono.
IWMVideoMediaProps Gestisce le proprietà di un flusso video.
IWMWatermarkInfo Fornisce l'accesso alle filigrane disponibili.
IWMWriter Usato come interfaccia principale per la scrittura di file ASF.
IWMWriterAdvanced Fornisce funzionalità avanzate per un oggetto writer esistente.
IWMWriterAdvanced2 Fornisce alcune funzionalità avanzate, in particolare per la gestione dei video denterlaced.
IWMWriterAdvanced3 Fornisce metodi per le statistiche dettagliate del writer.
IWMWriterFileSink Gestisce un oggetto sink di file.
IWMWriterFileSink2 Fornisce una gestione estesa di un oggetto sink di file.
IWMWriterFileSink3 Estende ulteriormente la funzionalità dell'oggetto sink di file.
IWMWriterNetworkSink Gestisce un oggetto sink di rete.
IWMWriterPostView Gestisce l'output degli esempi dal writer. Usato per verificare il contenuto codificato per un file durante il processo di codifica.
IWMWriterPostViewCallback Implementato dall'applicazione per ricevere esempi di postview dal writer.
IWMWriterPreprocess Gestisce le impostazioni per la codifica multipass.
IWMWriterPushSink Gestisce un oggetto sink push.
IWMWriterSink Gestisce l'input non elaborato di Windows Media Format dalle interfacce del writer. Usato come interfaccia di base per le altre interfacce sink del writer.

 

La tabella seguente illustra l'ereditarietà di ogni interfaccia e gli oggetti da cui è possibile ottenere un'istanza.

Interfaccia Eredito da Oggetti
INSNetSourceCreator IUnknown Oggetto Creator di origine
INSSBuffer IUnknown Oggetto buffer
INSSBuffer2 INSSBuffer Oggetto buffer
INSSBuffer3 INSSBuffer2 Oggetto buffer
INSSBuffer4 INSSBuffer3 Oggetto buffer
IReferenceClock IUnknown Oggetto Lettore
IWMAddressAccess IUnknown Oggetto Sink di rete writer
IWMAddressAccess2 IWMAddressAccess Oggetto Sink di rete writer
IWMBackupRestoreProps IUnknown Oggetto Restorer di backup
IWMBandwidthSharing IWMStreamList Oggetto Sharing della larghezza di banda
IWMClientConnections IUnknown Oggetto Sink di rete writer
IWMClientConnections2 IWMClientConnections Oggetto Sink di rete writer
IWMCodecAMVideoAccelerator IUnknown DMO del decodificatore Windows Media
IWMCodecInfo IUnknown Oggetto Gestione profili
IWMCodecInfo2 IWMCodecInfo Oggetto Gestione profili
IWMCodecInfo3 IWMCodecInfo2 Oggetto Gestione profili
IWMCredentialCallback IUnknown Implementato dall'applicazione
IWMDRMEditor IUnknown Oggetto Metadata Editor
IWMDRMReader IUnknown Oggetto Lettore
IWMDRMWriter IUnknown Oggetto writer
IWMHeaderInfo IUnknown Oggetto Editor metadati, Oggetto Reader, Oggetto Lettore sincrono, Oggetto Writer
IWMHeaderInfo2 IWMHeaderInfo Oggetto Editor metadati, Oggetto Reader, Oggetto Lettore sincrono, Oggetto Writer
IWMHeaderInfo3 IWMHeaderInfo2 Oggetto Editor metadati, Oggetto Reader, Oggetto Lettore sincrono, Oggetto Writer
IWMImageInfo IUnknown Oggetto Editor metadati, Oggetto Reader, Oggetto Lettore sincrono
IWMIndexer IUnknown Oggetto Indexer
IWMIndexer2 IWMIndexer Oggetto Indexer
IWMInputMediaProps IWMMediaProps Oggetto Proprietà multimediale di input
IWMIStreamProps IUnknown Oggetto Stream (IStream)
IWMLanguageList IUnknown Oggetto Profile, OggettoEditor metadati, Oggetto Reader, Oggetto Lettore sincrono, Oggetto Writer
IWMLicenseBackup IUnknown Oggetto Restorer backup
IWMLicenseRestore IUnknown Oggetto Restorer backup
IWMMediaProps IUnknown Oggetto Proprietà multimediale di input, oggetto Proprietà multimediali di output, Oggetto configurazione flusso
IWMMetadataEditor IUnknown Oggetto Metadata Editor
IWMMetadataEditor2 IWMMetadataEditor Oggetto Metadata Editor
IWMMutualExclusion IWMStreamList Oggetto Esclusione reciproca
IWMMutualExclusion2 IWMMutualExclusion Oggetto Esclusione reciproca
IWMOutputMediaProps IUnknown Oggetto Proprietà multimediale di output
IWMPacketSize IUnknown Oggetto Gestione profili
IWMPacketSize2 IWMPacketSize Oggetto Gestione profili
IWMPlayerHook IUnknown Implementato dall'applicazione
IWMPlayerTimestampHook IUnknown Filtro di origine
IWMProfile IUnknown Oggetto Profile
IWMProfile2 IWMProfile Oggetto Profile
IWMProfile3 IWMProfile2 Oggetto Profile
IWMProfileManager IUnknown Oggetto Gestione profili
IWMProfileManager2 IWMProfileManager Oggetto Gestione profili
IWMProfileManagerLanguage IUnknown Oggetto Gestione profili
IWMPropertyVault IUnknown Oggetto configurazione del flusso
IWMReader IUnknown Oggetto Lettore
IWMReaderAccelerator IUnknown Oggetto Lettore
IWMReaderAdvanced IUnknown Oggetto Lettore
IWMReaderAdvanced2 IWMReaderAdvanced Oggetto Lettore
IWMReaderAdvanced3 IWMReaderAdvanced2 Oggetto Lettore
IWMReaderAdvanced4 IWMReaderAdvanced3 Oggetto Lettore
IWMReaderAllocatorEx IUnknown Implementato dall'applicazione
IWMReaderCallback IWMStatusCallback Implementato dall'applicazione
IWMReaderCallbackAdvanced IUnknown Implementato dall'applicazione
IWMReaderNetworkConfig IUnknown Oggetto Lettore
IWMReaderNetworkConfig2 IWMReaderNetworkConfig Oggetto Lettore
IWMReaderStreamClock IUnknown Oggetto Lettore
IWMReaderTimecode IUnknown Oggetto Lettore
IWMReaderTypeNegotiation IUnknown Oggetto Lettore
IWMRegisterCallback IUnknown Implementato dall'applicazione
IWMSBufferAllocator IUnknown Implementato da un server di rete
IWMSInternalAdminNetSource IUnknown Oggetto amministratore dell'origine di rete
IWMSInternalAdminNetSource2 IWMSInternalAdminNetSource Oggetto amministratore dell'origine di rete
IWMSInternalAdminNetSource3 IWMSInternalAdminNetSource2 Oggetto amministratore dell'origine di rete
IWMStatusCallback IUnknown Implementato dall'applicazione
IWMStreamConfig IUnknown Oggetto configurazione del flusso
IWMStreamConfig2 IWMStreamConfig Oggetto configurazione del flusso
IWMStreamConfig3 IWMStreamConfig2 Oggetto configurazione del flusso
IWMStreamList IUnknown Oggetto Di condivisione della larghezza di banda, oggetto di esclusione reciproca
IWMStreamPrioritization IUnknown Oggetto Priorità di flusso
IWMSyncReader IUnknown Oggetto lettore sincrono
IWMSyncReader2 IWMSyncReader Oggetto lettore sincrono
IWMVideoMediaProps IWMMediaProps Oggetto configurazione del flusso
IWMWatermarkInfo IUnknown Oggetto writer
IWMWriter IUnknown Oggetto writer
IWMWriterAdvanced IUnknown Oggetto writer
IWMWriterAdvanced2 IWMWriterAdvanced Oggetto writer
IWMWriterAdvanced3 IWMWriterAdvanced2 Oggetto writer
IWMWriterFileSink IWMWriterSink Oggetto file sink del writer
IWMWriterFileSink2 IWMWriterFileSink Oggetto file sink del writer
IWMWriterFileSink3 IWMWriterFileSink2 Oggetto file sink del writer
IWMWriterNetworkSink IWMWriterSink Oggetto Sink di rete writer
IWMWriterPostView IUnknown Oggetto writer
IWMWriterPostViewCallback IUnknown Implementato dall'applicazione
IWMWriterPreprocess IUnknown Oggetto writer
IWMWriterPushSink IWMWriterSink Oggetto Push Sink writer
IWMWriterSink IUnknown Oggetto Sink file writer, oggetto Sink di retewriter, oggetto sink push writer

 

Commenti

L'identificatore dell'interfaccia per ogni interfaccia in questo SDK è il nome dell'interfaccia preceduta da "IID_". Ad esempio, l'identificatore per l'interfaccia IWMReaderAdvanced è IID_IWMReaderAdvanced. Per ottenere un puntatore all'interfaccia IWMReaderAdvanced di un oggetto lettore, usare il codice seguente, dove pReader è un puntatore a un'interfaccia IWMReader :

IWMReaderAdvanced *pReaderAdvanced;
hr = pReader->QueryInterface(IID_IWMReaderAdvanced,
                             (LPVOID*) &pReaderAdvanced);

Oggetti

Guida di riferimento alla programmazione