GPSGetPosition
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:
- Um evento passado GPSOpenDevice, parâmetro hNewLocationData está sinalizado
- o aplicativo está em um executar um loop de pesquisa, ou
- 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