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

Artigo
02/07/2025

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.

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.

A lista de propriedades fornecidas por meio pPropertiesToSet normalmente é um subconjunto da lista retornada por ISensorDriver::OnGetSupportedProperties. No entanto, a extensão da classe de 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á documentada em Dispositivos Portáteis do Windows.

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

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 7, Disponível no Windows 7.
servidor com suporte mínimo	Nenhum com suporte
da Plataforma de Destino	Área de trabalho
cabeçalho	sensorsclassextension.h
biblioteca	SensorsClassExtension.lib

Consulte também

do ISensorDriver

ISensorDriver::OnGetProperties

Compartilhar via