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)

另请参阅

IOCTL_STORAGE_GET_HOTPLUG_INFO

IOCTL_STORAGE_SET_HOTPLUG_INFO