Compartilhar via


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

Confira também

Interfaces do cliente