Compartilhar via

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

  • Artigo

O método ISensorDriver::OnSetProperties especifica valores para a lista de propriedades especificada.

Sintaxe

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

Parâmetros

[in] pClientFile

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

[in] pwszSensorID

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

[in] pPropertiesToSet

Ponteiro para uma interface IPortableDeviceValues que contém a lista de propriedades a serem definidas e seus valores.

[out] ppResults

Endereço de um ponteiro IPortableDeviceValues que recebe a lista de propriedades que foram definidas com êxito e seus novos valores. Se uma propriedade não tiver sido definida, o novo valor conterá um código de erro HRESULT.

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.

A lista de propriedades fornecidas por meio de pPropertiesToSet normalmente é um subconjunto da lista que você retornou por meio de ISensorDriver::OnGetSupportedProperties. No entanto, a extensão de classe do sensor não impõe essa condição em aplicativos cliente.

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

IPortableDeviceValues está documentado em Dispositivos Portáteis do Windows.

Nota Esse método será chamado somente se o usuário tiver habilitado o sensor no painel de controle Localização e Outros Sensores .
 

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7, Disponível no Windows 7.
Servidor mínimo com suporte Nenhum compatível
Plataforma de Destino Área de Trabalho
Cabeçalho sensorsclassextension.h
Biblioteca SensorsClassExtension.lib

Confira também

ISensorDriver

ISensorDriver::OnGetProperties