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

  • Artigo

O método ISensorDriver::OnGetProperties recupera valores para as propriedades especificadas do sensor especificado.

Sintaxe

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

Parâmetros

pClientFile

Ponteiro para uma interface IWDFFile que representa o objeto de arquivo para o aplicativo que solicita valores de propriedade.

pwszSensorID

LPWSTR que contém a ID do sensor do qual o aplicativo cliente está solicitando valores de propriedade.

pProperties

Ponteiro para um IPortableDeviceKeyCollection que contém a lista de valores PROPERTYKEY que representam as propriedades que estão sendo solicitadas.

ppPropertyValues

Endereço de um ponteiro IPortableDeviceValues que recebe os valores de propriedade solicitados.

Retornar valor

Se a operação for bem-sucedida, esse método retornará S_OK. Caso contrário, esse método retornará um dos códigos de erro definidos em Winerror.h.

Comentários

As propriedades descrevem o dispositivo do sensor, em vez de campos de dados, que contêm dados gerados pelo sensor. As propriedades definidas pela plataforma são definidas em sensors.h.

Os aplicativos podem acessar algumas informações de propriedade do sensor antes que o usuário conceda permissão para o sensor. Esses itens são limitados às seguintes IDs definidas em sensors.h:

  • Qualquer PROPERTYKEY que comece com "SENSOR_PROPERTY_".
  • Qualquer GUID de categoria que comece com "SENSOR_CATEGORY_".
Cada objeto IPortableDeviceValues retornado nesta coleção deve conter valores para as propriedades necessárias, conforme descrito na seção de referência Propriedades do Sensor .

A extensão da classe de sensor é responsável por liberar quaisquer estruturas PROPVARIANT retornadas por esse método.

As propriedades do sensor não devem conter informações que possam ser usadas para identificar o usuário. Para obter mais informações sobre privacidade do usuário, consulte Privacidade e segurança na Plataforma de Sensor e Localização.

IPortableDeviceKeyCollection e IPortableDeviceValues estão documentados em Dispositivos Portáteis do Windows.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho sensorsclassextension.h
Biblioteca SensorsClassExtension.lib

Confira também

ISensorDriver