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
如果此成員設定為非零值,則裝置為 hotplug 裝置。 否則,裝置不是 hotplug 裝置。
WriteCacheEnableOverride
保留;將值設定為 NULL。
備註
Size 成員的值也會識別這個結構的版本,因為成員未來會新增至這個結構。 如果 Size 成員的值是 sizeof(STORAGE_HOTPLUG_INFO)
,則結構的目前版本與您編譯的版本相同。 如果值不是 sizeof(STORAGE_HOTPLUG_INFO)
,則目前的版本會包含其他成員。
hotplug 裝置是指在 裝置管理員 中顯示的移除原則值為 ExpectSurpriseRemoval 的裝置。 若要查詢特定裝置是否為 hotplug 裝置,請使用 IOCTL_STORAGE_GET_HOTPLUG_INFO 作業。 若要設定裝置的 hotplug 屬性,請使用 IOCTL_STORAGE_SET_HOTPLUG_INFO 作業。
IOCTL_STORAGE_SET_HOTPLUG_INFO作業只會設定這個 結構的DeviceHotplug成員值。 如果設定該成員的值,則指定裝置的移除原則會設定為 ExpectSurpriseRemoval ,並停用所有層級的快取。 如果未設定該成員的值,則指定的裝置移除原則會設定為 ExpectOrderlyRemoval,而且可以選擇性地啟用快取。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP |
最低支援的伺服器 | Windows Server 2003 |
標頭 | winioctl.h (包含 Windows.h) |