IOCTL_GPS_WRITE_ASSISTED (Compact 2013)

3/26/2014

This I/O control message obtains data used by the GPS hardware to more quickly obtain a GPS fix. For example, GPS hardware in a mobile phone may have the ability to more quickly obtain a GPS fix using information about the current mobile phone tower(s) used by a phone. Applications can provide this data to the GPS hardware using this I/O control. Send this message with DeviceIoControl.

Syntax

BOOL DeviceIoControl(
    HANDLE hDevice,           // handle to device
    DWORD dwIoControlCode,    // use IOCTL_GPS_WRITE_ASSISTED
    LPVOID lpInBuffer,        // pointer to input buffer
    DWORD nInBufferSize,      // input buffer size
    LPVOID lpOutBuffer,       // pointer to output buffer
    DWORD nOutBufferSize,     // output buffer size
    LPDWORD lpBytesReturned,  // number of bytes returned
    OVERLAPPED lpOverlapped   // pointer to OVERLAPPED structure
);

Parameters

• hDevice

• dwIoControlCode
  [in] Control code for the operation. Use IOCTL_GPS_WRITE_ASSISTED for this operation.

• lpInBuffer
  [in] Pointer to a buffer that contains data previously retrieved using IOCTL_GPS_READ_ASSISTED.

• nInBufferSize

• lpOutBuffer

• nOutBufferSize

• lpBytesReturned

• lpOverlapped

Return Values

GPS hardware manufacturers may return TRUE if the hardware device driver was able to provide this data, and FALSE otherwise. However, this is not required and applications should not rely on the return value obtained when using this I/O control.

Remarks

An application can use this I/O control to provide information it previously retrieved using IOCTL_GPS_READ_ASSISTED.

It is important to note that this data is only meaningful to the GPS hardware. The data is completely opaque to an application using the GPS Intermediate Driver. The degree to which applications can interact with this information is limited to saving the results of IOCTL_GPS_READ_ASSISTED and then providing the saved results to the GPS hardware using IOCTL_GPS_WRITE_ASSISTED.

Requirements

See Also

Reference

GPS Intermediate Driver IOCTLs
DeviceIoControl
IOCTL_GPS_READ_ASSISTED
IOCTL_GPS_WRITE_ALMANAC