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

Recupera o relatório de dados do sensor mais recente.

Sintaxe

HRESULT GetData(
  [out] ISensorDataReport **ppDataReport
);

[out] ppDataReport

Endereço de um ponteiro ISensorDataReport que recebe o ponteiro para o relatório de dados do sensor mais recente.

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
E_INVALIDARG	O driver do sensor forneceu dados mal formados. Por exemplo, os dados eram de um tipo que não tem suporte. Para obter informações sobre tipos de dados de campos de dados definidos pela plataforma, consulte Categorias de sensor, tipos e campos de dados.
HRESULT_FROM_WIN32(ERROR_NO_DATA)	O sensor não tem dados a relatar. Por exemplo, um sensor GPS pode estar no processo de aquisição de uma correção de satélite.
E_POINTER	NULL foi passado para ppDataReport.

Para sensores de localização, você pode recuperar dados somente de sensores para os quais o usuário concedeu permissão.

Esse método pode retornar dados antes que o driver defina o estado como SENSOR_STATE_READY.

Para obter um exemplo de como recuperar dados do sensor, consulte Recuperando valores de dados do sensor.

Requisito	Valor
Cliente mínimo com suporte	Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Nenhum compatível
Plataforma de Destino	Windows
Cabeçalho	sensorsapi.h
Biblioteca	Sensorsapi.lib
DLL	Sensorsapi.dll