Search code examples
winapiusbremovable-storage

How to eject a USB removable disk/volume, similar to the "Eject" function in Windows Explorer?


Do you know what is the API, or sequence of API calls that windows uses to accomplish the "Eject" function which is available on the shell context menu for removable volumes?

So far I've tried two things:

  1. using CM_Request_Device_Eject, I enumerate the removable disks (using the SetupDiXXX APIs), find the one that I'm interested in, walk the device manager hierarchy (using CM_XXX APIs) and finally call CM_Request_Device_Eject on the devInst of the device I'm interesed in. This works in the sense that it does remove the volumes from My Computer and makes the device "safe to remove" (ready to be removed) but it is not the same as the shell context menu "Eject" function. The way I know this is because the device that I'm trying to eject is supposed to do something when it is ejected and that something is not happening when I do the eject using CM_Request_Device_Eject.

  2. using DeviceIoControl with the IOCTL_STORAGE_EJECT_MEDIA control code. The sequence of events is:

This doesn't work at all. Each one of the `DeviceIoControl` calls fails with `ERROR_IVALID_FUNCTION` (0x00000001). I don't know why the calls fail. I've verified that other calls to DeviceIoControl work fine for the same file handle (such as [IOCTL_STORAGE_GET_DEVICE_NUMBER][11])

Finally, my development machine is running Windows 7 x64, and in order to get the second method to work I've tried running my application with Administrator privileges and that did not change anything.

Any information is welcome. Even maybe how to invoke the shell "Eject" menu item as a last recourse.


Solution

  • Eventually, I found out where I was making a mistake with approach #2.

    It turns out that for some reason I was not setting the desired access correctly when opening the handle to the volume using CreateFile.

    The correct access mode is GENERIC_READ | GENERIC_WRITE and I was passing 0. After correcting my error I was able to successfully eject the device using DeviceIoControl - IOCTL_STORAGE_EJECT_MEDIA, as well as with method #1, using CM_Request_Device_Eject.

    Finally, it turns out that method #2 is indeed the method used by the shell context menu's "Eject" function. Using this method the device reacts correctly.