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