Interfaccia di programmazione dell'applicazione WPD

Panoramica della tecnologia dell'interfaccia di programmazione dell'applicazione WPD.

Per sviluppare l'interfaccia di programmazione dell'applicazione WPD, sono necessarie queste intestazioni:

• portabledeviceapi.h
• portabledeviceconnectapi.h

Per indicazioni sulla programmazione per questa tecnologia, vedere:

• Interfaccia di programmazione dell'applicazione WPD

Funzioni

Consigliare Il metodo Advise registra un callback definito dall'applicazione che riceve gli eventi del dispositivo.
Consigliare Registra un oggetto callback definito dall'applicazione che riceve gli eventi del servizio.
Annulla Il metodo Cancel annulla un'operazione in sospeso. (IEnumPortableDeviceObjectIDs.Cancel)
Annulla Il metodo Cancel annulla un'operazione in sospeso in questa interfaccia.
Annulla Il metodo Cancel annulla una richiesta in sospeso in questa interfaccia.
Annulla Il metodo Cancel annulla un'operazione in sospeso chiamata su questa interfaccia.
Annulla Il metodo Cancel annulla una chiamata in corso su questa interfaccia.
Annulla Il metodo Cancel annulla una chiamata in sospeso.
Annulla Il metodo Cancel annulla una richiesta di proprietà in sospeso.
Annulla Il metodo Cancel annulla un'operazione in sospeso. (IPortableDeviceResources.Cancel)
Annulla Annulla un'operazione in sospeso in questa interfaccia.
Annulla Annulla un'operazione in sospeso.
Annulla Annulla una chiamata al metodo in sospeso.
Annulla Annulla una richiesta in sospeso per connettersi o disconnettere un dispositivo MTP/Bluetooth.
Capabilities Il metodo Capabilities recupera un'interfaccia usata per eseguire query sulle funzionalità di un dispositivo portatile.
Capabilities Recupera le funzionalità del servizio.
Clone Il metodo Clone duplica l'interfaccia IEnumPortableDeviceObjectIDs corrente.
Close Il metodo Close chiude la connessione con il dispositivo.
Close Rilascia la connessione al servizio.
Connettere Invia una richiesta di connessione asincrona al dispositivo MTP/Bluetooth.
Contenuto Il metodo Content recupera un'interfaccia che è possibile usare per accedere agli oggetti in un dispositivo.
Contenuto Recupera l'accesso al contenuto del servizio.
Copia Il metodo Copy copia gli oggetti da una posizione in un dispositivo a un altro.
CreateObjectWithPropertiesAndData Il metodo CreateObjectWithPropertiesAndData crea un oggetto con proprietà e dati nel dispositivo.
CreateObjectWithPropertiesOnly Il metodo CreateObjectWithPropertiesOnly crea un oggetto con solo proprietà nel dispositivo.
CreateResource Il metodo CreateResource crea una risorsa.
Elimina Il metodo Delete elimina uno o più oggetti dal dispositivo.
Elimina Il metodo Delete elimina le proprietà specificate da un oggetto specificato in un dispositivo.
Elimina Il metodo Delete elimina una o più risorse dall'oggetto identificato dal parametro pszObjectID.
Disconnetti Invia una richiesta di disconnessione asincrona al dispositivo MTP/Bluetooth.
EnumObjects Il metodo EnumObjects recupera un'interfaccia usata per enumerare gli oggetti figlio immediati di un oggetto. Include un filtro facoltativo che può enumerare oggetti con proprietà specifiche.
GetCommandOptions Il metodo GetCommandOptions recupera tutte le opzioni supportate per il comando specificato nel dispositivo.
GetCommandOptions Recupera le opzioni di un comando WPD.
GetDeviceDescription Recupera la descrizione di un dispositivo.
GetDeviceForService Recupera il dispositivo associato al servizio specificato.
GetDeviceFriendlyName Recupera il nome descrittivo per il dispositivo.
GetDeviceManufacturer Recupera il nome del produttore del dispositivo.
GetDeviceProperty Recupera un valore di proprietà archiviato dal dispositivo nel computer. Queste non sono proprietà standard definite dai dispositivi portatili Windows.
GetDevices Recupera un elenco di dispositivi portatili connessi al computer.
GetDeviceServices Recupera un elenco dei servizi associati al dispositivo specificato.
GetEventAttributes Recupera gli attributi di un evento.
GetEventOptions Il metodo GetEventOptions recupera tutte le opzioni supportate per l'evento specificato nel dispositivo.
GetEventParameterAttributes Recupera gli attributi di un parametro evento.
GetFixedPropertyAttributes Il metodo GetFixedPropertyAttributes recupera gli attributi delle proprietà standard per una proprietà e un formato specificati.
GetFormatAttributes Recupera gli attributi di un formato.
GetFormatPropertyAttributes Recupera gli attributi di una proprietà di formato.
GetFormatRenderingProfiles Recupera i profili di rendering di un formato.
GetFunctionalCategories Il metodo GetFunctionalCategories recupera tutte le categorie funzionali supportate dal dispositivo.
GetFunctionalObjects Il metodo GetFunctionalObjects recupera tutti gli oggetti funzionali corrispondenti a una categoria specificata nel dispositivo.
GetInheritedServices Recupera i servizi con il tipo di ereditarietà specificato.
GetMethodAttributes Recupera gli attributi usati per descrivere un determinato metodo.
GetMethodParameterAttributes Recupera gli attributi usati per descrivere un determinato parametro del metodo.
GetObjectID Il metodo GetObjectID recupera l'ID oggetto della risorsa scritta nel dispositivo. Questo metodo è valido solo dopo aver chiamato IStream::Commit nel flusso di dati.
GetObjectIDsFromPersistentUniqueIDs Il metodo GetObjectIDsFromPersistentUniqueIDs recupera l'ID oggetto corrente di uno o più oggetti, in base agli ID univoci persistenti (PUID).
GetPnPDeviceID Il metodo GetPnPDeviceID recupera l'identificatore del dispositivo Plug and Play (PnP) usato dall'applicazione per aprire il dispositivo.
GetPnPID Recupera l'identificatore del dispositivo Plug and Play del connettore (PnP).
GetPnPServiceID Recupera un identificatore Plug and Play (PnP) per il servizio.
GetPrivateDevices Il metodo GetPrivateDevices recupera un elenco di dispositivi portatili privati connessi al computer. Questi dispositivi privati sono accessibili solo tramite un'applicazione progettata per questi dispositivi specifici.
Getproperty Recupera una proprietà per il dispositivo dell'enumeratore del bus MTP/Bluetooth specificato.
GetPropertyAttributes Il metodo GetPropertyAttributes recupera gli attributi di una proprietà oggetto specificata in un dispositivo.
GetResourceAttributes Il metodo GetResourceAttributes recupera tutti gli attributi da una risorsa specificata in un oggetto.
GetServiceObjectID Recupera un identificatore di oggetto per il servizio. Questo identificatore di oggetto può essere usato per accedere alle proprietà del servizio, ad esempio.
Getstream Il metodo GetStream ottiene un'interfaccia IStream con cui leggere o scrivere i dati del contenuto in un oggetto in un dispositivo. L'interfaccia recuperata consente di leggere o scrivere nei dati dell'oggetto.
GetSupportedCommands Il metodo GetSupportedCommands recupera un elenco di tutti i comandi supportati per questo dispositivo.
GetSupportedCommands Recupera i comandi supportati dal servizio.
GetSupportedContentTypes Il metodo GetSupportedContentTypes recupera tutti i tipi di contenuto supportati per un tipo di oggetto funzionale specificato in un dispositivo.
GetSupportedEvents Il metodo GetSupportedEvents recupera gli eventi supportati per questo dispositivo.
GetSupportedEvents Recupera gli eventi supportati dal servizio.
GetSupportedFormatProperties Il metodo GetSupportedFormatProperties recupera le proprietà supportate dagli oggetti di un formato specificato nel dispositivo.
GetSupportedFormatProperties Recupera le proprietà supportate dal servizio per il formato specificato.
GetSupportedFormats Il metodo GetSupportedFormats recupera i formati supportati per un tipo di oggetto specificato nel dispositivo. Ad esempio, la specifica di oggetti audio potrebbe restituire WPD_OBJECT_FORMAT_WMA, WPD_OBJECT_FORMAT_WAV e WPD_OBJECT_FORMAT_MP3.
GetSupportedFormats Recupera i formati supportati dal servizio.
GetSupportedMethods Recupera i metodi supportati dal servizio.
GetSupportedMethodsByFormat Recupera i metodi supportati dal servizio per il formato specificato.
GetSupportedProperties Il metodo GetSupportedProperties recupera un elenco di proprietà supportate da un oggetto specificato. Si noti che non tutte queste proprietà potrebbero effettivamente avere valori.
GetSupportedResources Il metodo GetSupportedResources recupera un elenco di risorse supportate da un oggetto specifico.
GetValues Il metodo GetValues recupera un elenco di proprietà specificate da un oggetto specificato in un dispositivo.
Invoke Richiama in modo sincrono un metodo.
InvokeAsync Richiama in modo asincrono un metodo.
Metodi Recupera l'interfaccia IPortableDeviceServiceMethods usata per richiamare funzionalità personalizzate nel servizio.
Sposta Il metodo Move sposta uno o più oggetti da una posizione nel dispositivo a un'altra.
Avanti Il metodo Next recupera gli ID oggetto successivi nella sequenza di enumerazione.
OnComplete Indica che un metodo di callback ha completato l'esecuzione.
OnEnd Il metodo OnEnd viene chiamato dall'SDK quando viene completata un'operazione bulk avviata da IPortableDevicePropertiesBulk::Start.
OnEvent Il metodo OnEvent viene chiamato dall'SDK per notificare all'applicazione eventi asincroni.
OnProgress Il metodo OnProgress viene chiamato dall'SDK quando un'operazione bulk avviata da IPortableDevicePropertiesBulk::Start ha inviato dati al dispositivo e ha ricevuto alcune informazioni di nuovo.
Onstart Il metodo OnStart viene chiamato dall'SDK quando un'operazione bulk avviata da IPortableDevicePropertiesBulk::Start sta per iniziare.
Apri Il metodo Open apre una connessione tra l'applicazione e il dispositivo.
Apri Apre una connessione al servizio.
Proprietà Il metodo Properties recupera l'interfaccia necessaria per ottenere o impostare le proprietà in un oggetto nel dispositivo.
QueueGetValuesByObjectFormat L'interfaccia QueueGetValuesByObjectFormat accoda una richiesta di proprietà di oggetti di un formato specifico in un dispositivo.
QueueGetValuesByObjectList Il metodo QueueGetValuesByObjectList accoda una richiesta per una o più proprietà specificate da uno o più oggetti specificati nel dispositivo.
QueueSetValuesByObjectList Il metodo QueueSetValuesByObjectList accoda una richiesta per impostare uno o più valori specificati in uno o più oggetti specificati nel dispositivo.
RefreshDeviceList Il metodo RefreshDeviceList aggiorna l'elenco di dispositivi connessi al computer.
Reimpostazione Il metodo Reset reimposta la sequenza di enumerazione all'inizio. (IEnumPortableDeviceObjectIDs.Reset)
SeekInUnits Il metodo SeekInUnits esegue una ricerca in un flusso, in base alle unità alternative.
SendCommand Il metodo SendCommand invia un comando al dispositivo e recupera i risultati in modo sincrono.
SendCommand Invia un comando WPD standard e i relativi parametri al servizio.
SetProperty Imposta la proprietà specificata nel dispositivo enumeratore del bus MTP/Bluetooth.
SetValues Il metodo SetValues aggiunge o modifica una o più proprietà in un oggetto specificato in un dispositivo.
Skip Il metodo Skip ignora un numero specificato di oggetti nella sequenza di enumerazione.
Inizia Il metodo Start avvia un'operazione in coda.
Trasferire Il metodo Transfer recupera un'interfaccia utilizzata per leggere o scrivere nei dati del contenuto di una risorsa oggetto esistente.
Unadvise Il metodo Unadvise annulla la registrazione di un client dalla ricezione di notifiche di callback. È necessario chiamare questo metodo se si chiama Consigli in precedenza.
Unadvise Annulla la registrazione di un oggetto callback dell'evento di servizio.
UpdateObjectWithPropertiesAndData Aggiornamenti un oggetto usando proprietà e dati trovati nel dispositivo.

Interfacce

Id IEnumPortableDeviceObjectIDs L'interfaccia IEnumPortableDeviceObjectIDs enumera gli oggetti in un dispositivo portatile. Ottenere inizialmente questa interfaccia chiamando IPortableDeviceContent::EnumObjects in un dispositivo.
IPortableDevice L'interfaccia IPortableDevice fornisce l'accesso a un dispositivo portatile.
IPortableDeviceCapabilities L'interfaccia IPortableDeviceCapabilities è un'ampia gamma di funzionalità del dispositivo, tra cui formati, comandi e oggetti funzionali supportati. È possibile recuperare questa interfaccia da un dispositivo chiamando IPortableDevice::Capabilities.
IPortableDeviceConnector Definisce i metodi usati per la gestione della connessione e il recupero delle proprietà per un dispositivo MTP/Bluetooth associato.
IPortableDeviceContent L'interfaccia IPortableDeviceContent fornisce metodi per creare, enumerare, esaminare ed eliminare contenuto in un dispositivo. Per ottenere questa interfaccia, chiamare IPortableDevice::Content.
IPortableDeviceContent2 Definisce metodi aggiuntivi che forniscono l'accesso al contenuto trovato in un dispositivo.
IPortableDeviceDataStream L'interfaccia IPortableDeviceDataStream espone metodi aggiuntivi in un IStream usato per i trasferimenti di dati.
IPortableDeviceEventCallback L'interfaccia IPortableDeviceEventCallback implementata dall'applicazione per ricevere callback asincroni se un'applicazione è stata registrata per riceverli chiamando IPortableDevice::Advise.
IPortableDeviceManager Enumera i dispositivi connessi al computer e offre un modo semplice per richiedere informazioni di installazione, tra cui produttore, nome descrittivo e descrizione.
IPortableDeviceProperties L'interfaccia IPortableDeviceProperties recupera, aggiunge o elimina le proprietà da un oggetto in un dispositivo o dal dispositivo stesso.
IPortableDevicePropertiesBulk L'interfaccia IPortableDevicePropertiesBulk o imposta più proprietà su più oggetti in un dispositivo, in modo asincrono.
IPortableDevicePropertiesBulkCallback L'interfaccia IPortableDevicePropertiesBulkCallback viene implementata dall'applicazione per tenere traccia dello stato di avanzamento di un'operazione asincrona avviata tramite l'interfaccia IPortableDevicePropertiesBulk. Dopo che l'applicazione chiama IPortableDevicePropertiesBulk::Start, i dispositivi portatili Windows chiama IPortableDevicePropertiesBulkCallback::OnStart e quindi chiama ripetutamente IPortableDevicePropertiesBulkCallback::OnProgress con informazioni fino al completamento dell'operazione o l'applicazione chiama IPortableDevicePropertiesBulk::Cancel o restituisce un valore di errore per OnProgress. Infine, indipendentemente dal fatto che l'operazione sia stata completata correttamente, i dispositivi portatili Windows chiama IPortableDevicePropertiesBulkCallback::OnEnd.
IPortableDeviceResources L'interfaccia IPortableDeviceResources fornisce l'accesso ai dati non elaborati di un oggetto. Usare questa interfaccia per leggere o scrivere risorse in un oggetto. Per ottenere questa interfaccia, chiamare IPortableDeviceContent::Transfer.
IPortableDeviceService Fornisce l'accesso a un servizio.
IPortableDeviceServiceCapabilities Recupera informazioni che descrivono le funzionalità di un servizio.
IPortableDeviceServiceManager Recupera il dispositivo associato a un servizio e l'elenco dei servizi trovati in un dispositivo.
IPortableDeviceServiceMethodCallback Contiene un metodo usato dalle applicazioni per tenere traccia del completamento di un metodo di callback. Le applicazioni che chiamano i metodi del servizio in modo asincrono possono implementare questa interfaccia e specificarla come parametro a IPortableDeviceServiceMethods::InvokeAsync.
IPortableDeviceServiceMethods Richiama o annulla la chiamata di, un metodo in un servizio.
IPortableDeviceUnitsStream L'interfaccia IPortableDeviceUnitsStream consente di operare o cercare in un flusso usando unità alternative, ad esempio fotogrammi o millisecondi.