Método ISensorDriver::OnSetProperties (sensorsclassextension.h)

El método ISensorDriver::OnSetProperties especifica valores para la lista de propiedades especificada.

Sintaxis

HRESULT OnSetProperties(
  [in]  IWDFFile              *pClientFile,
  [in]  LPWSTR                pwszSensorID,
  [in]  IPortableDeviceValues *pPropertiesToSet,
  [out] IPortableDeviceValues **ppResults
);

Parámetros

[in] pClientFile

Puntero a una interfaz IWDFFile que representa el objeto de archivo para la aplicación que especifica valores de propiedad.

[in] pwszSensorID

LPWSTR que contiene el identificador del sensor para el que la aplicación cliente especifica los valores de propiedad.

[in] pPropertiesToSet

Puntero a una interfaz IPortableDeviceValues que contiene la lista de propiedades que se van a establecer y sus valores.

[out] ppResults

Dirección de un puntero IPortableDeviceValues que recibe la lista de propiedades que se han establecido correctamente y sus nuevos valores. Si no se estableció una propiedad, el nuevo valor contiene un código de error HRESULT.

Valor devuelto

Si la operación se realiza correctamente, este método devuelve S_OK. De lo contrario, este método devuelve uno de los códigos de error definidos en Winerror.h.

Comentarios

Las propiedades describen el dispositivo del sensor, en lugar de los campos de datos, que contienen datos generados por el sensor. Las propiedades definidas por la plataforma se definen en sensors.h.

La lista de propiedades proporcionadas a través de pPropertiesToSet suele ser un subconjunto de la lista que devolvió a través de ISensorDriver::OnGetSupportedProperties. Sin embargo, la extensión de clase de sensor no aplica esta condición en las aplicaciones cliente.

La extensión de clase sensor es responsable de liberar las estructuras PROPVARIANT devueltas por este método.

IPortableDeviceValues se documenta en Dispositivos portátiles windows.

Requisitos

Consulte también

ISensorDriver

ISensorDriver::OnGetProperties