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

Artigo
02/07/2025

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 os valores de propriedade de solicitação de aplicativo.

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.

Valor de retorno

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.

Observações

As propriedades descrevem o dispositivo de sensor, em oposição aos campos de dados, que contêm dados gerados por 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 categoria GUID 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 node Plataforma de Localização e Sensor.

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

Requisitos

Requisito	Valor
da Plataforma de Destino	Windows
cabeçalho	sensorsclassextension.h
biblioteca	SensorsClassExtension.lib

Consulte também

do ISensorDriver

Compartilhar via