Share via

HWPowerOff

  • Article

This function is called by the model device driver to notify the platform-dependent driver that the platform is about to enter suspend mode.

BOOL HWPowerOff(
  PVOID pContext 
);

Parameters

  • pContext
    [in] Pointer to a context structure returned by the HWInit function that contains implementation-specific data describing the hardware device.

Return Values

TRUE indicates success. FALSE indicates failure.

Remarks

This function is called when the device is turned off. Because this call is without standard process/thread context, take care in writing this function. No DLLs or system calls, such as Sleep, can be used. This function saves its state to local storage, and then returns. As with all power-down handlers, this function cannot call functions in other DLLs, memory allocators, debugging output functions, or perform any action that could cause a page fault.

This function supports the implementation of the lower layers of serial port drivers.

Requirements

OS Versions: Windows CE 1.0 and later.
Header: Serhw.h.

See Also

HWInit

 Last updated on Tuesday, May 18, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.