XXX_PowerDown

This function suspends power to the device. It is useful only with devices that can be shut off under software control. Such devices are typically, but not exclusively, PC Card devices.

Syntax

void XXX_PowerDown( DWORD hDeviceContext );

Parameters

Handle

Handle to the device context. The call to the XXX_Init function returns this identifier.

Return Values

None.

Remarks

The operating system invokes this function to suspend power to the device. The operating system might call this function when it is about to enter the power-save mode. This function should not call any functions that might cause it to block, and it should return as quickly as possible. One strategy for returning quickly is to have this function set a global variable to indicate that a power loss occurred and to defer any complicated processing until later, when the driver’s XXX_PowerUp function is called.