 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
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
- Pointer to a context structure returned by the
HWInitfunction 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 do anything that could cause a page fault.
This function is part of the implementation of the PDDs of serial port drivers.
Requirements
Runs on Versions Defined in Include Link to Windows CE OS 1.0 and later Serhw.h Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.
See Also
Last updated on Tuesday, July 13, 2004