Share via

структура STORAGE_HOTPLUG_INFO (ntddstor.h)

  • Статья

Структура STORAGE_HOTPLUG_INFO предоставляет сведения о горячем подключении для устройства.

Синтаксис

typedef struct _STORAGE_HOTPLUG_INFO {
  ULONG   Size;
  BOOLEAN MediaRemovable;
  BOOLEAN MediaHotplug;
  BOOLEAN DeviceHotplug;
  BOOLEAN WriteCacheEnableOverride;
} STORAGE_HOTPLUG_INFO, *PSTORAGE_HOTPLUG_INFO;

Члены

Size

Указывает размер данной структуры в байтах.

MediaRemovable

Указывает, является ли носитель съемным. Если задано ненулевое значение, носитель устройства является съемным. Если задано значение 0, носитель устройства не является съемным.

MediaHotplug

Указывает, блокируется ли носитель. Если задано ненулевое значение, носитель устройства не блокируется. Если задано значение 0, носитель устройства блокируется.

DeviceHotplug

Указывает, является ли устройство устройством с горячим отключением. Если задано ненулевое значение, устройство является устройством с горячим отключением. Если задано значение 0, устройство не является устройством с горячим отключением.

WriteCacheEnableOverride

Не используйте; задайте значение NULL.

Комментарии

Значение элемента Size также определяет версию этой структуры. Новые члены будут добавлены в эту структуру в будущем. Если значение элемента Size равно sizeof(STORAGE_HOTPLUG_INFO), текущая версия структуры совпадает с версией, с помощью скомпилированной. Если значение не равно sizeof(STORAGE_HOTPLUG_INFO), текущая версия содержит дополнительные элементы.

Microsoft Windows XP включает поддержку устройств с горячим отключением. Устройство с горячим отключением относится к устройству, значение RemovalPolicy которого отображается в диспетчер устройств — ExpectSurpriseRemoval. Чтобы запросить, является ли конкретное устройство горячим, используйте запрос IOCTL_STORAGE_GET_HOTPLUG_INFO . Чтобы задать свойства горячего отключения устройства, используйте запрос IOCTL_STORAGE_SET_HOTPLUG_INFO .

В случае запроса IOCTL_STORAGE_SET_HOTPLUG_INFO элемент DeviceHotplug структуры STORAGE_HOTPLUG_INFO определяет, какое действие выполняется. Если значение этого элемента не равно нулю, для политики удаления устройства в реестре устанавливается значение ExpectSurpriseRemoval , а все уровни кэширования отключаются. Если значение DeviceHotplug равно нулю , для политики удаления устанавливается значение ExpectOrderlyRemoval, и кэширование может быть включено выборочно.

Требования

Требование Значение
Заголовок ntddstor.h (включая Ntddstor.h)

См. также раздел

IOCTL_STORAGE_GET_HOTPLUG_INFO

IOCTL_STORAGE_SET_HOTPLUG_INFO