Interfacce per le applicazioni

Questa sezione descrive le interfacce usate o implementate dalle applicazioni che usano Windows Media Device Manager SDK per comunicare con i dispositivi. Il termine "applicazione" usato qui significa qualsiasi eseguibile, plug-in o oggetto COM esistente in un computer desktop e richiede comunicazioni di alto livello con un dispositivo portatile connesso. Può includere un'applicazione lettore multimediale, un plug-in di Windows Media Player (se è necessario l'accesso diretto a un dispositivo portatile) o un oggetto COM di misurazione del conteggio dei giochi.

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 macs.
IWMDeviceManager	Interfaccia di Windows Media Device Manager di primo livello 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 consentendo di 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 codici di controllo di I/O del dispositivo e fornire 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 il modo in cui i file riproducibili nel dispositivo vengono gestiti dall'interfaccia IWMDMDeviceControl
IWMDMRevoked	Recupera l'URL da cui è possibile scaricare i componenti aggiornati, se un trasferimento non riesce con un errore di revoca.
IWMDMStorage	Fornisce metodi per esaminare ed esplorare un archivio (file, cartella, playlist) in un dispositivo.
IWMDMStorage2	Estende IWMDMStorage consentendo di ottenere un archivio figlio in base al nome e di ottenere e impostare gli attributi estesi.
IWMDMStorage3	Estende IWMDMStorage2 esponendo i metadati.
IWMDMStorage4	Estende IWMDMStorage3 fornendo metodi per recuperare un subset di metadati disponibili per un archivio 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 consentendo di 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 a 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 il trasferimento dei dati non crittografati per un'efficienza aggiuntiva.
IWMDMOperation	Consente a un'applicazione di controllare il modo in cui i dati vengono letti o scritti nel computer durante un 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 la formattazione di supporti o trasferimenti di file.

 

Il diagramma seguente mostra come la maggior parte delle interfacce dell'applicazione importanti vengono acquisite dall'interfaccia radice IWMDeviceManager. Un'applicazione ottiene questa interfaccia radice mediante la creazione condivisa dell'oggetto MediaDevMgr, richiedendo l'interfaccia IComponentAuthenticate, autenticando il componente e quindi richiedendo il 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 segni di barra, quindi "IWMDMStorage/2/3" indicherà IWMDMStorage, IWMDMStorage2e IWMDMStorage3.

Argomenti correlati

di riferimento per la programmazione