xxx_PowerDown

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

Syntax

void xxx_PowerDown( DWORD hDeviceContext );

Parameters

Handle

Specifies a handle that identifies the device context. The xxx_Init call returns this identifier.

Return Value

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 saving mode. This function should never 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 perform any necessary processing later.