Método IPortableDevicePropertiesBulkCallback::OnProgress (portabledeviceapi.h)

El SDK llama al método OnProgress cuando IPortableDevicePropertiesBulk::Start inicia una operación masiva ha enviado datos al dispositivo y ha recibido cierta información.

Sintaxis

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

Parámetros

[in] pContext

Puntero a un GUID que identifica qué operación está en curso. Este valor lo genera una cola... método de la interfaz IPortableDevicePropertiesBulk .

[in] pResults

Puntero a una interfaz IPortableDeviceValuesCollection que contiene los resultados recuperados del dispositivo. Esta interfaz contendrá una o varias interfaces IPortableDeviceValues . Cada una de estas interfaces contendrá una propiedad WPD_OBJECT_ID con un valor de cadena (VT_LPSTR) que especifica el identificador de objeto del objeto al que pertenecen estos valores. El resto de los valores de cada interfaz IPortableDeviceValues varía, en función de la operación masiva que se notifica. Para los métodos QueueGetValuesByObjectFormat y QueueGetValuesByObjectList , se recuperarán valores de tipos diferentes. Para QueueSetValuesByObjectList, se VT_ERROR valores HRESULT para los errores detectados al establecer valores.

Valor devuelto

La aplicación debe devolver S_OK o un código de error para abandonar la operación. Todos los códigos de error se controlan de la misma manera.

Comentarios

Se puede llamar a este método una o varias veces, en función del tamaño de la operación.

Este método no recupera necesariamente todas las propiedades a la vez, ni devuelve las propiedades en un orden determinado.

Si se llama a este método varias veces, puede devolver propiedades para el mismo identificador de objeto cada vez.

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	portabledeviceapi.h
Library	PortableDeviceGUIDs.lib

Consulte también

IPortableDevicePropertiesBulkCallback (Interfaz)