Bewerken

Delen via


Power-Down and Removal Sequence for a Bus Driver

The following figure shows the order in which the framework calls a KMDF bus driver's event callback functions when powering down and removing a device that is connected to the bus. The sequence starts at the top of the figure with an operational device that is in the working power state (D0):

Flowchart illustrating the power-down and removal sequence for a KMDF bus driver, starting with an operational device in the working power state (D0).

The framework does not delete the PDO until the device is physically removed from the system. For example, if a user disables the device in Device Manager or stops it in the Safely Remove Hardware utility but does not physically remove the device, the framework retains the PDO. If the device is later re-enabled, the framework uses the same PDO and begins the startup sequence by calling the EvtDevicePrepareHardware callback, as shown in Power-Up Sequence for a Physical Device Object.

Note: Typically, the framework calls a bus driver's EvtDeviceReleaseHardware callback function after it has called the EvtDeviceReleaseHardware function for all child devices that the driver enumerates. In the event of the parent encountering a device power-up or power-down failure, the framework might call the driver's EvtDeviceReleaseHardware before it has called the EvtDeviceReleaseHardware functions for all child devices. Consider calling WdfDeviceInitSetReleaseHardwareOrderOnFailure to ensure that the framework calls the bus driver's EvtDeviceReleaseHardware callback only after all child devices have been removed.