Recuperando propriedades para vários objetos por formato de objeto

Além de uma recuperação em massa de propriedades para uma coleção de identificadores de objeto, um aplicativo também pode executar uma recuperação em massa de propriedades para todos os objetos de um tipo específico. Como no exemplo anterior, a recuperação em massa para um determinado tipo requer que o driver de dispositivo dê suporte a recuperações em massa.

Seu aplicativo pode executar uma recuperação em massa usando as interfaces descritas na tabela a seguir.

Interface Descrição
IPortableDeviceContent Interface Fornece acesso aos métodos específicos do conteúdo.
IPortableDeviceKeyCollection Interface Usado para identificar as propriedades a serem recuperadas.
IPortableDeviceProperties Interface Usado para determinar se um determinado driver dá suporte a operações em massa.
IPortableDevicePropertiesBulk Interface Dá suporte à operação de recuperação em massa.
IPortableDevicePropVariantCollection Interface Usado para armazenar os identificadores de objeto para a operação em massa.

 

A função ReadContentPropertiesBulkFilteringFormat no módulo ContentProperties.cpp do aplicativo de exemplo demonstra uma operação de recuperação em massa para objetos de um tipo ou formato específico.

O código encontrado na função ReadContentPropertiesBulkFilteringFormat é quase idêntico ao código encontrado na função ReadContentPropertiesBulk. (Consulte o tópico Recuperando propriedades para vários objetos para obter uma descrição completa dessa função.)

A única diferença primária ocorre quando a operação é enfileirada. Ao filtrar por tipo ou formato, o método IPortableDevicePropertiesBulk::QueueGetValuesByObjectFormat é chamado em vez do método IPortableDevicePropertiesBulk::QueueGetValuesByObjectList .

hr = pPropertiesBulk->QueueGetValuesByObjectFormat(WPD_OBJECT_FORMAT_WMA,
                                                   WPD_DEVICE_OBJECT_ID,
                                                   100,
                                                   pPropertiesToRead,
                                                   pCallback,
                                                   &guidContext);

IPortableDevice Interface

IPortableDeviceContent Interface

IPortableDeviceKeyCollection Interface

IPortableDeviceProperties Interface

IPortableDevicePropertiesBulk Interface

IPortableDevicePropVariantCollection Interface

Guia de programação