Compartilhar via


GPSGetPosition

Windows Mobile SupportedWindows Embedded CE Supported

9/8/2008

Essa função recupera informações localidade, incluindo latitude e longitude, por configuração os campos de passado GPS_POSITION estrutura com informações localidade que satisfaz os critérios de Idade máxima especificada.

Syntax

DWORD GPSGetPosition(
  HANDLE        hGPSDevice,
  GPS_POSITION *pGPSPosition,
  DWORD         dwMaximumAge,
  DWORD         dwFlags
);

Parameters

  • hGPSDevice
    Manipular retornado por uma chamar para GPSOpenDevice, ou NULL.

    Se NULL, o driver intermediário de GPS retorna dados correção em cache localidade que está dentro de dwMaximumAge, se disponível; caso contrário, o dwValidFields Do & pGPSPosition irá conter zeros no retorno.

  • pGPSPosition
    Ponteiro para um GPS_POSITION estrutura). Em retorno, essa estrutura é preenchida com dados localidade obtidos pela GPS Intermediate Driver. O membro dwValidFields das GPS_POSITION instância Especifica quais campos da instância estão válido. Essa estrutura deve ser inicializado corretamente, caso contrário um erro será retornado.
  • dwMaximumAge
    Idade máxima, em milissegundos, de informações localidade. O driver intermediário de GPS só retornará informações que tem sido recebidas dentro de tempo especificado por este parâmetro. Quaisquer informações que sejam mais antigas do que essa duração não são retornadas. Os elementos de GPS_POSITION instância que estão especificados no elemento dwValidFields da instância válido para o valor dado dwMaximumAge.
  • dwFlags
    Reservado. Deve ser 0.

Return Value

Se bem-sucedido, retornar ERROR_SUCCESS.

Se malsucedido, retorna um código de erro.

Remarks

Aplicativos chamar essa função em três situações:

  1. Um evento passado GPSOpenDevice, parâmetro hNewLocationData está sinalizado
  2. o aplicativo está em um executar um loop de pesquisa, ou
  3. Um único tempo e, em seguida, fechar o dispositivo usando GPSCloseDevice.

GPSGetPosition não consulta o dispositivo de GPS diretamente para determinar o atual posição. Em vez disso, ele irá ler a última posição que o dispositivo de GPS indicado para o GPS Intermediate Driver. O dispositivo de GPS indicará uma posição para o GPS Intermediate Driver no segundo plano, independently of chamadas para GPSGetPosition.

Requirements

Header gpsapi.h
Library Gpsapi.lib
Windows Embedded CE Windows Embedded CE 6.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

GPS Intermediate Driver Functions
GPS_POSITION
GPSCloseDevice
GPSOpenDevice

Concepts

Accessing Parsed GPS Data

Other Resources

GetLastError