Método ISensor::GetCategory (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 o identificador da categoria do sensor.

Sintaxe

HRESULT GetCategory(
  [out] SENSOR_CATEGORY_ID *pSensorCategory
);

Parâmetros

[out] pSensorCategory

Endereço de um SENSOR_CATEGORY_ID que recebe a ID da categoria do sensor.

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.
E_UNEXPECTED	O driver do sensor não forneceu um valor de categoria. O PROPVARIANT retornado terá seu valor de erro definido como HRESULT_FROM_WIN32 ( ERROR_NOT_FOUND).
E_POINTER	NULL foi passado para pSensorCategory.

Observações

Um SENSOR_CATEGORY_ID é um GUID que identifica exclusivamente a categoria 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

categorias de sensor, tipos e campos de dados