Interfacce per le applicazioni

Questa sezione descrive le interfacce usate o implementate dalle applicazioni tramite Windows Media Gestione dispositivi SDK per comunicare con i dispositivi. Il termine "applicazione" usato qui significa qualsiasi oggetto eseguibile, plug-in o COM presente in un computer desktop e necessita di comunicazioni di alto livello con un dispositivo portatile connesso. Può includere un'applicazione lettore multimediale, un plug-in Lettore multimediale Windows (se è necessario l'accesso diretto a un dispositivo portatile) o un oggetto COM di misurazione del numero di riproduzione.

Alcune di queste interfacce vengono implementate dall'applicazione, mentre altre vengono chiamate dall'applicazione. La documentazione per ogni interfaccia indica se viene implementata o chiamata (e, se implementata, se è facoltativa o obbligatoria).

Le interfacce o le classi seguenti vengono usate dalle applicazioni.

Interfaccia o classe	Descrizione
Classe CSecureChannelClient	Classe helper che consente alle applicazioni di autenticarsi, crittografare e decrittografare i dati e creare controller di dominio.
IWMDeviceManager	Interfaccia di primo livello di Windows Media Gestione dispositivi per le applicazioni.
IWMDeviceManager2	Estende IWMDeviceManager fornendo metodi di enumerazione avanzati e altri metodi.
IWMDeviceManager3	Estende l'interfaccia IWMDeviceManager2 fornendo un metodo che imposta la preferenza di enumerazione del dispositivo.
IWMDMDevice	Fornisce metodi per esaminare ed esplorare un singolo dispositivo portatile.
IWMDMDevice2	Estende IWMDMDevice rendendo possibile ottenere i formati video supportati da un dispositivo, trovare una risorsa di archiviazione in base al nome e usare le pagine delle proprietà.
IWMDMDevice3	Estende IWMDMDevice2 fornendo metodi per eseguire query su un dispositivo per le proprietà, inviare i codici di controllo di I/O del dispositivo e fornire anche metodi aggiornati per cercare le risorse di archiviazione e recuperare le funzionalità di formato del dispositivo.
IWMDMDeviceControl	Fornisce metodi per il controllo dei dispositivi.
IWMDMDeviceSession	Migliora l'efficienza delle operazioni dei dispositivi raggruppando più operazioni in una sessione
IWMDMEnumDevice	Enumera i dispositivi portatili collegati a un computer.
IWMDMEnumStorage	Enumera le risorse di archiviazione in un dispositivo.
IWMDMMetaData	Imposta e recupera le proprietà dei metadati ,ad esempio artista, album, genere e così via, di un archivio.
IWMDMObjectInfo	Ottiene e imposta informazioni che controllano la modalità di gestione dei file riproducibili nel dispositivo dall'interfaccia IWMDMDeviceControl
IWMDMRevoked	Recupera l'URL da cui è possibile scaricare i componenti aggiornati, se un trasferimento ha esito negativo con un errore di revoca.
IWMDMStorage	Fornisce metodi per esaminare ed esplorare un archivio (file, cartella, playlist) in un dispositivo.
IWMDMStorage2	Estende IWMDMStorage rendendo possibile ottenere una risorsa di archiviazione figlio in base al nome e ottenere e impostare attributi estesi.
IWMDMStorage3	Estende IWMDMStorage2 esponendo i metadati.
IWMDMStorage4	Estende IWMDMStorage3 fornendo metodi per recuperare un subset di metadati disponibili per una risorsa di archiviazione e per impostare e recuperare un elenco di riferimenti ad altre risorse di archiviazione.
IWMDMStorageControl	Consente di inserire, eliminare o spostare file all'interno di un dispositivo o tra un dispositivo e il computer.
IWMDMStorageControl2	Estende IWMDMStorageControl rendendo possibile impostare il nome del file di destinazione durante l'inserimento di contenuto in una risorsa di archiviazione.
IWMDMStorageControl3	Estende IWMDMStorageControl2 consentendo di passare un puntatore all'interfaccia IWMDMMetaData .
IWMDMStorageGlobals	Fornisce metodi per recuperare informazioni globali su un supporto di archiviazione (ad esempio una scheda ROM flash) in un dispositivo.
IWMDRMDeviceApp	Consente a un'applicazione di eseguire la misurazione, la sincronizzazione delle licenze e l'aggiornamento dei componenti DRM di un dispositivo.
IWMDRMDeviceApp2	Estende IWMDRMDeviceApp fornendo una nuova versione del metodo QueryDeviceStatus .

 

Interfacce di callback

Le interfacce facoltative seguenti vengono implementate da un'applicazione per tenere traccia dello stato di avanzamento di una richiesta asincrona, ad esempio una richiesta di lettura o scrittura.

Interfaccia	Descrizione
IWMDMNotification	Consente alle applicazioni e ai provider di servizi di ricevere notifiche quando i dispositivi o le risorse di archiviazione di memoria (ad esempio le schede RAM) sono connessi o disconnessi dal computer.
IWMDMOperation2	Estende IWMDMOperation fornendo metodi per ottenere e impostare attributi estesi.
IWMDMOperation3	Estende IWMDMOperation fornendo un nuovo metodo per trasferire i dati non crittografati per un'efficienza aggiuntiva.
IWMDMOperation	Consente a un'applicazione di controllare la modalità di lettura o scrittura dei dati nel computer durante il trasferimento di file.
IWMDMProgress2	Estende il metodo IWMDMProgress::End fornendo un indicatore di stato.
IWMDMProgress3	Estende IWMDMProgress2 fornendo parametri di input aggiuntivi per specificare l'ID evento e le informazioni specifiche del contesto.
IWMDMProgress	Consente a un'applicazione di tenere traccia dello stato di avanzamento delle operazioni, ad esempio il supporto di formattazione o i trasferimenti di file.

 

Il diagramma seguente mostra come la maggior parte delle interfacce dell'applicazione importanti vengono acquisite dall'interfaccia IWMDeviceManager radice. Un'applicazione ottiene questa interfaccia radice mediante la creazione condivisa dell'oggetto MediaDevMgr, la richiesta dell'interfaccia IComponentAuthenticate , l'autenticazione del componente e la richiesta di IWMDeviceManager (questi passaggi sono descritti in Autenticazione dell'applicazione). Dopo aver acquisito questa interfaccia radice, viene chiamato IWMDeviceManager::EnumDevices per creare un oggetto che implementa IWMDMEnumDevice. Altre interfacce vengono ottenute chiamando i metodi sulle interfacce nell'ordine indicato. Le interfacce derivate, ad esempio IWMDMDevice2 , vengono ottenute chiamando QueryInterface sull'interfaccia di base.

Nel diagramma seguente le interfacce derivate sono etichettate da barre, quindi "IWMDMStorage/2/3" indicherà IWMDMStorage, IWMDMStorage2 e IWMDMStorage3.

Argomenti correlati

Guida di riferimento alla programmazione