通过

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