Interfaccia IWMProfile

  • Articolo

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

L'interfaccia IWMProfile è l'interfaccia principale per un oggetto profilo . Un oggetto profilo viene usato per configurare profili personalizzati. È possibile usare IWMProfile per creare, eliminare o modificare oggetti di configurazione del flusso e oggetti di esclusione reciproca. È anche possibile impostare e recuperare informazioni generali sul profilo. Per accedere a tutte le funzionalità dell'oggetto profilo, è necessario usare IWMProfile3, che eredita da IWMProfile e IWMProfile2.

IWMProfile è accessibile anche tramite l'oggetto lettore, in cui è possibile usarlo per ottenere informazioni sui flussi di un file caricato nel lettore. Quando si accede a IWMProfile dal lettore, è possibile apportare modifiche al profilo, ma nessuna delle modifiche può essere salvata nel file. Spesso è utile usare il profilo di un file esistente come base di un nuovo profilo. Il lettore sincrono supporta IWMProfile allo stesso modo del lettore.

Le informazioni sul profilo ottenute tramite il lettore o il lettore sincrono non provengono da un file con estensione prx. Il lettore usa le informazioni nel file ASF per assemblare le configurazioni del flusso. Di conseguenza, alcune informazioni sul profilo, come il nome e la descrizione, non sono disponibili tramite il lettore.

Esistono diversi modi per ottenere un puntatore a un'interfaccia IWMProfile . Gestione profili dispone di metodi per creare un nuovo profilo e accedere ai profili esistenti. Tutti questi metodi impostano un puntatore IWMProfile . Quando si legge un file, è possibile ottenere un puntatore a IWMProfile chiamando il metodo QueryInterface di qualsiasi interfaccia lettore. Analogamente, qualsiasi interfaccia dell'oggetto lettore sincrono può ottenere un puntatore con una chiamata a QueryInterfaceIWMProfile3.

Membri

L'interfaccia IWMProfile eredita dall'interfaccia IUnknown . IWMProfile include anche questi tipi di membri:

Metodi

L'interfaccia IWMProfile include questi metodi.

Metodo Descrizione
AddMutualExclusion Aggiunge un oggetto di esclusione reciproca al profilo.
AddStream Aggiunge un flusso al profilo.
CreateNewMutualExclusion Crea un oggetto di esclusione reciproca per il profilo.
CreateNewStream Crea un oggetto di configurazione del flusso per il profilo.
GetDescription Recupera la descrizione del profilo.
GetMutualExclusion Recupera un oggetto di esclusione reciproca dal profilo.
GetMutualExclusionCount Recupera il numero di oggetti di esclusione reciproca nel profilo.
GetName Recupera il nome del profilo.
Getstream Recupera un flusso, utilizzando un numero di indice, dal profilo.
GetStreamByNumber Recupera un flusso, usando il numero del flusso, dal profilo.
GetStreamCount Recupera il numero di flussi nel profilo.
GetVersion Recupera il numero di versione di Microsoft Windows Media Services nel profilo.
ReconfigStream Consente di includere nel profilo le modifiche apportate a una configurazione del flusso.
RemoveMutualExclusion Rimuove un oggetto di esclusione reciproca dal profilo.
RemoveStream Rimuove un flusso dal profilo.
RemoveStreamByNumber Rimuove un flusso dal profilo.
SetDescription Specifica la descrizione del profilo.
SetName Specifica il nome del profilo.

Per informazioni sulle interfacce che è possibile ottenere usando il metodo QueryInterface di questa interfaccia, vedere l'argomento relativo all'oggetto in cui viene implementata questa interfaccia.

Vedi anche

Interfacce

Interfaccia IWMProfileManager

Oggetto Gestione profili

Oggetto Lettore

Oggetto lettore sincrono

Uso dei profili