Partager via

IOCTL_BATTERY_NOTIFYOFTIMECHANGE

  • Article

This IOCTL adjusts times to account for the user changing the real time. The DeviceIoControl function calls this IOCTL.

Parameters

  • hDevice
    [in] Handle to the device that is to perform the operation. To obtain a device handle, call the CreateFile function.
  • dwIoControlCode
    [in] Set to IOCTL_BATTERY_NOTIFYOFTIMECHANGE.
  • pInBuf
    [in] Pointer to a FILETIME structure containing the amount of time the system has been adjusted forward or backward.
  • InBufLen
    [in] Set to sizeof(FILETIME).
  • pOutBuf
    [in] Pointer to a BOOL, fForward.
  • OutBufLen
    [in] Set to sizeof(BOOL).
  • lpBytesReturned
    [out] Long pointer to a variable that receives the size, in bytes, of the data stored into the buffer pointed to by lpOutBuffer.
  • lpOverlapped
    [in] Ignored; set to NULL.**

Return Values

If successful, DeviceIoControl returns TRUE. Otherwise, DeviceIoControl returns FALSE. In case of failure, GetLastError contains an error status.

Remarks

This IOCTL does not update pdwBytesTransferred. It does not update the value in pOutBuf. For more information, see BatteryNotifyOfTimeChange.

Requirements

OS Versions: Windows CE .NET 4.2 and later.
Header: Battery.h.

See Also

Battery Drivers | BatteryNotifyOfTimeChange | DeviceIoControl | FILETIME

 Last updated on Tuesday, May 18, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.