STORAGE_HOTPLUG_INFO 結構 (ntddstor.h)

STORAGE_HOTPLUG_INFO 結構提供裝置的 hotplug 資訊。

語法

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

成員

Size

指出這個 結構的大小，以位元組為單位。

MediaRemovable

指定媒體是否可移動。 如果設定為非零值，則裝置媒體是可移動的。 如果設定為零，則裝置媒體不會卸除。

MediaHotplug

指定媒體是否可鎖定。 如果設定為非零值，則裝置媒體無法鎖定。 如果設定為零，則裝置媒體可鎖定。

DeviceHotplug

指定裝置是否為 hotplug 裝置。 如果設定為非零值，則裝置為 hotplug 裝置。 如果設定為零，裝置不是 hotplug 裝置。

WriteCacheEnableOverride

請勿使用;將值設定為 NULL。

備註

Size 成員的值也會識別這個結構的版本。 未來將會新增成員至這個結構。 如果 Size 成員的值是 sizeof (STORAGE_HOTPLUG_INFO) ，則結構的目前版本與您編譯的版本相同。 如果值不是 大小of (STORAGE_HOTPLUG_INFO) ，則目前的版本包含其他成員。

Microsoft Windows XP 包含 hotplug 裝置的支援。 hotplug 裝置是指在 裝置管理員 中顯示的移除原則值為 ExpectSurpriseRemoval 的裝置。 若要查詢特定裝置是否為 hotplug 裝置，請使用 IOCTL_STORAGE_GET_HOTPLUG_INFO 要求。 若要設定裝置的 hotplug 屬性，請使用 IOCTL_STORAGE_SET_HOTPLUG_INFO 要求。

在IOCTL_STORAGE_SET_HOTPLUG_INFO要求的情況下，STORAGE_HOTPLUG_INFO 結構的 DeviceHotplug 成員會決定採取什麼動作。 如果該成員的值不是零，登錄中裝置移除原則的值會設定為 ExpectSurpriseRemoval ，而且所有層級的快取都會停用。 如果 DeviceHotplug 的值是零，則移除原則會設定為 ExpectOrderlyRemoval，而且可能會選擇性地啟用快取。

規格需求

另請參閱

IOCTL_STORAGE_GET_HOTPLUG_INFO

IOCTL_STORAGE_SET_HOTPLUG_INFO