IOCTL_GPS_READ_ALMANAC
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Este IOCTL pode ser implementado por fabricantes hardware de GPS para retornar informações Almanaque usadas atualmente pelo hardware de GPS.
Um aplicativo usando a GPS Intermediate Driver pode salvar os dados recuperados pelo chamado este IOCTL, dizer, no desligamento e em seguida, forneça os resultados para o hardware de GPS, na inicialização, fazendo chamado IOCTL_GPS_WRITE_ALMANAC. Este dados podem fornecer informações suficientes para o hardware de GPS para habilitar o hardware obter uma correção de GPS mais rapidamente do que ele seria sem dados Almanaque.
Para obter mais informações sobre como usar e imlement esta IOCTL, consulte A implementação de hardware driver intermediário de GPS IOCTLs.
Observação
Non-Almanac dados que podem ser usados para habilitar mais rápidas de GPS correções - como informações da torre Mobile Phone, para exemplo - devem ser recuperados usando IOCTL_GPS_READ_ASSISTED.
Parâmetros
Aplicativos usando o driver intermediário de GPS deve transmitir um ponteiro que pode conter dados Almanaque usando o parâmetro lpOutBuffer das DeviceIOControl função.
Os fabricantes hardware de GPS que implementar essa IOCTL deve usar o ponteiro lpOutBuffer para retornar dados Almanaque usados atualmente pelo hardware de GPS.
É importante para detalhes que os dados Almanaque é apenas significativo para o hardware de GPS. Os dados é completamente opacidade para um aplicativo usando a GPS Intermediate Driver. O grau para qual aplicativos podem interagir com informações Almanaque está limitado a salvando os resultados do IOCTL_GPS_READ_ALMANAC e, em seguida, fornecer os resultados salvos para o hardware de GPS usando IOCTL_GPS_WRITE_ALMANAC.
Return Values
Hardware de GPS fabricantes podem retornar TRUE se driver de dispositivo o hardware foi capaz de fornecer dados Almanaque e FALSE caso contrário. No entanto, isso não é exigido e aplicativos não devem depender de valor de retorno obtido ao usar esse IOCTL.
Requisitos
| Header | gpsdev.h |
| 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 IOCTLs
IOCTL_GPS_READ_ASSISTED
IOCTL_GPS_WRITE_ALMANAC
Concepts
Implementing GPS Intermediate Driver Hardware IOCTLs