STORAGE_HOTPLUG_INFO 结构 (winioctl.h)
提供有关设备的热插拔信息的信息。
语法
typedef struct _STORAGE_HOTPLUG_INFO {
DWORD Size;
BOOLEAN MediaRemovable;
BOOLEAN MediaHotplug;
BOOLEAN DeviceHotplug;
BOOLEAN WriteCacheEnableOverride;
} STORAGE_HOTPLUG_INFO, *PSTORAGE_HOTPLUG_INFO;
成员
Size
此结构的大小(以字节为单位)。 调用方必须将此成员设置为 sizeof(STORAGE_HOTPLUG_INFO)
。
MediaRemovable
如果此成员设置为非零值,则设备媒体是可移动的。 否则,设备媒体不可移动。
MediaHotplug
如果此成员设置为非零值,则媒体不可锁定。 否则,设备媒体可锁定。
DeviceHotplug
如果此成员设置为非零值,则设备为热插拔设备。 否则,设备不是热插拔设备。
WriteCacheEnableOverride
保留;将 值设置为 NULL。
注解
Size 成员的值还标识此结构的版本,因为成员将来将添加到此结构中。 如果 Size 成员 sizeof(STORAGE_HOTPLUG_INFO)
的值为 ,则结构的当前版本与编译时使用的版本相同。 如果值不 sizeof(STORAGE_HOTPLUG_INFO)
为 ,则当前版本包含其他成员。
热插拔设备是指在设备管理器中显示的 RemovePolicy 值为 ExpectSurpriseRemoval 的设备。 若要查询特定设备是否为热插拔设备,请使用 IOCTL_STORAGE_GET_HOTPLUG_INFO 操作。 若要设置设备的热插拔属性,请使用 IOCTL_STORAGE_SET_HOTPLUG_INFO 操作。
IOCTL_STORAGE_SET_HOTPLUG_INFO操作仅设置此结构的 DeviceHotplug 成员的值。 如果设置了该成员的值,则指定设备的删除策略将设置为 ExpectSurpriseRemoval ,并且禁用所有级别的缓存。 如果未设置该成员的值,则指定设备的删除策略将设置为 ExpectOrderlyRemoval,并且可以有选择地启用缓存。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP |
最低受支持的服务器 | Windows Server 2003 |
标头 | winioctl.h (包括 Windows.h) |