Compartilhar via


Método ISensor::GetID (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 exclusivo do sensor.

Sintaxe

HRESULT GetID(
  [out] SENSOR_ID *pID
);

Parâmetros

[out] pID

Endereço de um SENSOR_ID que recebe a ID.

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 uma ID do sensor.
E_POINTER
NULL foi passado para pID.

Observações

Um SENSOR_ID é um GUID que identifica exclusivamente o sensor no computador atual. Essa ID corresponde à constante nomeada SENSOR_PROPERTY_PERSISTENT_UNIQUE_ID.

Você pode usar uma ID para recuperar um ponteiro para um sensor específico chamando ISensorManager::GetSensorByID.

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

Constantes de sensor