Método ISensor::GetProperties (sensorsapi.h)

Importante

Use, em vez disso, a API do Sensor UWP.

A API de Sensor baseada em COM foi preterida e não deve ser usada em novos aplicativos. Nenhum recurso ou aprimoramento adicional é planejado e o suporte será limitado.

Recupera várias propriedades do sensor.

Sintaxe

HRESULT GetProperties(
  [in]  IPortableDeviceKeyCollection *pKeys,
  [out] IPortableDeviceValues        **ppProperties
);

Parâmetros

[in] pKeys

Ponteiro para uma interface IPortableDeviceKeyCollection que contém a coleção PROPERTYKEY para os valores de propriedade que estão sendo solicitados. Defina como NULL para recuperar todas as propriedades com suporte.

[out] ppProperties

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

Valor de retorno

O método retorna um HRESULT. Os valores possíveis incluem, mas não se limitam a, aqueles na tabela a seguir.

Código de retorno	Description
S_OK	O método foi bem-sucedido.
S_FALSE	O driver do sensor não dá suporte a pelo menos uma das propriedades especificadas. Cada propriedade sem suporte PROPVARIANT retornada por meio da interface IPortableDeviceValues terá seu valor de erro definido como HRESULT_FROM_WIN32 (ERROR_NOT_FOUND).
E_POINTER	NULL foi passado para ppProperties.

Observações

Esse método permite que você recupere os valores de várias propriedades, como a criação do sensor, o modelo e o número de série, fazendo uma única chamada. Para recuperar uma única propriedade, chame ISensor::GetProperty.

As interfaces IPortableDeviceKeyCollection e IPortableDeviceValues são definidas pela API de Dispositivos Portáteis do Windows.

Exemplos

Para obter um exemplo de como recuperar propriedades de um sensor, consulte Configuração e recuperação de propriedades do sensor.

Requirements

Requirement	Value
Cliente mínimo suportado	Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo compatível	Nenhum compatível
da Plataforma de Destino	Windows
Header	sensorsapi.h
Library	Sensorsapi.lib
de DLL	Sensorsapi.dll

Consulte também

ISensor

Propriedades do sensor

SetProperties