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

  • Artículo

El método ISensorDriver::OnGetProperties recupera los valores de las propiedades especificadas del sensor especificado.

Sintaxis

HRESULT OnGetProperties(
  IWDFFile                     *pClientFile,
  LPWSTR                       pwszSensorID,
  IPortableDeviceKeyCollection *pProperties,
  IPortableDeviceValues        **ppPropertyValues
);

Parámetros

pClientFile

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

pwszSensorID

LPWSTR que contiene el identificador del sensor desde el que la aplicación cliente solicita valores de propiedad.

pProperties

Puntero a un objeto IPortableDeviceKeyCollection que contiene la lista de valores PROPERTYKEY que representan las propiedades que se solicitan.

ppPropertyValues

Dirección de un puntero IPortableDeviceValues que recibe los valores de propiedad solicitados.

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.

Las aplicaciones pueden acceder a cierta información de la propiedad del sensor antes de que el usuario conceda permiso para el sensor. Estos elementos se limitan a los siguientes identificadores definidos en sensors.h:

  • Cualquier PROPERTYKEY que comience por "SENSOR_PROPERTY_".
  • Cualquier GUID de categoría que comience por "SENSOR_CATEGORY_".
Cada objeto IPortableDeviceValues devuelto en esta colección debe contener valores para las propiedades necesarias, como se describe en la sección Referencia de propiedades del sensor .

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

Las propiedades del sensor no deben contener información que se pueda usar para identificar al usuario. Para obtener más información sobre la privacidad del usuario, consulte Privacidad y seguridad en la plataforma sensor y ubicación.

IPortableDeviceKeyCollection e IPortableDeviceValues se documentan en Dispositivos portátiles windows.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado sensorsclassextension.h
Library SensorsClassExtension.lib

Consulte también

ISensorDriver