Interface IPortableDevice (portabledeviceapi.h)
A interface IPortableDevice fornece acesso a um dispositivo portátil.
Para criar e abrir essa interface, primeiro chame CoCreateInstance com CLSID_PortableDeviceFTM ou CLSID_PortableDevice para recuperar uma interface IPortableDevice e, em seguida, chame Abrir para abrir uma conexão com o dispositivo.
Herança
A interface IPortableDevice herda da interface IUnknown . IPortableDevice também tem estes tipos de membros:
Métodos
A interface IPortableDevice tem esses métodos.
| IPortableDevice::Advise O método Advise registra um retorno de chamada definido pelo aplicativo que recebe eventos do dispositivo. |
| IPortableDevice::Cancel O método Cancel cancela uma operação pendente nessa interface. |
| IPortableDevice::Capabilities O método Capabilities recupera uma interface usada para consultar os recursos de um dispositivo portátil. |
| IPortableDevice::Close O método Close fecha a conexão com o dispositivo. |
| IPortableDevice::Content O método Content recupera uma interface que você pode usar para acessar objetos em um dispositivo. |
| IPortableDevice::GetPnPDeviceID O método GetPnPDeviceID recupera o identificador de dispositivo Plug and Play (PnP) usado pelo aplicativo para abrir o dispositivo. |
| IPortableDevice::Open O método Open abre uma conexão entre o aplicativo e o dispositivo. |
| IPortableDevice::SendCommand O método SendCommand envia um comando para o dispositivo e recupera os resultados de forma síncrona. |
| IPortableDevice::Unadvise O método Unadvise cancela o registro de um cliente de receber notificações de retorno de chamada. Você deve chamar esse método se tiver chamado Informe anteriormente. |
Comentários
As interfaces do cliente foram projetadas para serem usadas para qualquer objeto WPD; não é necessário criar uma nova instância para cada objeto referenciado pelo aplicativo. Depois que um aplicativo abre uma instância da interface IPortableDevice , ele deve abrir e armazenar em cache quaisquer outras interfaces de cliente WPD necessárias.
Para o Windows 7, IPortableDevice dá suporte a dois CLSIDs para CoCreateInstance. CLSID_PortableDevice retorna um ponteiro IPortableDevice que não agrega o marshaler de thread livre; CLSID_PortableDeviceFTM é um novo CLSID que retorna um ponteiro IPortableDevice que agrega o marshaler de thread livre. Ambos os ponteiros dão suporte à mesma funcionalidade caso contrário.
Os aplicativos que residem em apartamentos de thread único devem usar CLSID_PortableDeviceFTM , pois isso elimina a sobrecarga do marshaling de ponteiro de interface. CLSID_PortableDevice ainda tem suporte para aplicativos herdados.
Requisitos
| Plataforma de Destino | Windows |
| Cabeçalho | portabledeviceapi.h |