Condividi tramite


Interfaccia IPortableDevice (portabledeviceapi.h)

L'interfaccia IPortableDevice consente l'accesso a un dispositivo portatile.

Per creare e aprire questa interfaccia, chiamare prima CoCreateInstance con CLSID_PortableDeviceFTM o CLSID_PortableDevice per recuperare un'interfaccia IPortableDevice e quindi chiamare Open per aprire una connessione al dispositivo.

Ereditarietà

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

Metodi

L'interfaccia IPortableDevice include questi metodi.

 
IPortableDevice::Advise

Il metodo Advise registra un callback definito dall'applicazione che riceve gli eventi del dispositivo.
IPortableDevice::Cancel

Il metodo Cancel annulla un'operazione in sospeso su questa interfaccia.
IPortableDevice::Capabilities

Il metodo Capabilities recupera un'interfaccia usata per eseguire query sulle funzionalità di un dispositivo portatile.
IPortableDevice::Close

Il metodo Close chiude la connessione con il dispositivo.
IPortableDevice::Content

Il metodo Content recupera un'interfaccia che è possibile usare per accedere agli oggetti in un dispositivo.
IPortableDevice::GetPnPDeviceID

Il metodo GetPnPDeviceID recupera l'identificatore del dispositivo Plug and Play (PnP) usato dall'applicazione per aprire il dispositivo.
IPortableDevice::Open

Il metodo Open apre una connessione tra l'applicazione e il dispositivo.
IPortableDevice::SendCommand

Il metodo SendCommand invia un comando al dispositivo e recupera i risultati in modo sincrono.
IPortableDevice::Unadvise

Il metodo Unadvise annulla la registrazione di un client dalla ricezione di notifiche di callback. È necessario chiamare questo metodo se in precedenza è stato chiamato Advise.

Commenti

Le interfacce client sono progettate per essere usate per qualsiasi oggetto WPD; non è necessario creare una nuova istanza per ogni oggetto a cui fa riferimento l'applicazione. Dopo che un'applicazione apre un'istanza dell'interfaccia IPortableDevice , deve aprire e memorizzare nella cache tutte le altre interfacce client WPD necessarie.

Per Windows 7 , IPortableDevice supporta due CLSID per CoCreateInstance. CLSID_PortableDevice restituisce un puntatore IPortableDevice che non aggrega il marshalling a thread libero; CLSID_PortableDeviceFTM è un nuovo CLSID che restituisce un puntatore IPortableDevice che aggrega il gestore di marshalling a thread libero. Entrambi i puntatori supportano la stessa funzionalità in caso contrario.

Le applicazioni che risiedono in apartment a thread singolo devono usare CLSID_PortableDeviceFTM perché elimina il sovraccarico del marshalling del puntatore di interfaccia. CLSID_PortableDevice è ancora supportato per le applicazioni legacy.

Requisiti

   
Piattaforma di destinazione Windows
Intestazione portabledeviceapi.h

Vedi anche

Interfacce client