Поделиться через


Метод IPortableDevicePropertiesBulkCallback::OnProgress (portabledeviceapi.h)

Метод OnProgress вызывается пакетом SDK, когда массовая операция, запущенная IPortableDevicePropertiesBulk::Start , отправила данные на устройство и получила некоторые сведения обратно.

Синтаксис

HRESULT OnProgress(
  [in] REFGUID                         pContext,
  [in] IPortableDeviceValuesCollection *pResults
);

Параметры

[in] pContext

Указатель на GUID, определяющий, какая операция выполняется. Это значение создается очередью... метод интерфейса IPortableDevicePropertiesBulk .

[in] pResults

Указатель на интерфейс IPortableDeviceValuesCollection , содержащий результаты, полученные с устройства. Этот интерфейс будет содержать один или несколько интерфейсов IPortableDeviceValues . Каждый из этих интерфейсов будет содержать одно свойство WPD_OBJECT_ID со строковым значением (VT_LPSTR), указывающим идентификатор объекта, к которому относятся эти значения. Остальные значения в каждом интерфейсе IPortableDeviceValues зависят от сообщаемой массовой операции. Для методов QueueGetValuesByObjectFormat и QueueGetValuesByObjectList они будут извлекать значения различных типов. Для QueueSetValuesByObjectList они будут VT_ERROR значения HRESULT для любых ошибок, возникающих при установке значений.

Возвращаемое значение

Приложение должно вернуть либо S_OK, либо код ошибки, чтобы прервать операцию. Все коды ошибок обрабатываются одинаково.

Комментарии

Этот метод можно вызывать один или несколько раз в зависимости от размера операции.

Этот метод не обязательно получает все свойства одновременно, а также не возвращает свойства в определенном порядке.

Если этот метод вызывается несколько раз, он может возвращать свойства для одного и того же идентификатора объекта каждый раз.

Требования

Требование Значение
Целевая платформа Windows
Header portabledeviceapi.h
Библиотека PortableDeviceGUIDs.lib

См. также раздел

Интерфейс IPortableDevicePropertiesBulkCallback