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 |