STORAGE_HOTPLUG_INFO Struktur (winioctl.h)
Stellt Informationen zu den Hotplug-Informationen eines Geräts bereit.
Syntax
typedef struct _STORAGE_HOTPLUG_INFO {
DWORD Size;
BOOLEAN MediaRemovable;
BOOLEAN MediaHotplug;
BOOLEAN DeviceHotplug;
BOOLEAN WriteCacheEnableOverride;
} STORAGE_HOTPLUG_INFO, *PSTORAGE_HOTPLUG_INFO;
Member
Size
Die Größe dieser Struktur in Bytes. Der Anrufer muss dieses Element auf sizeof(STORAGE_HOTPLUG_INFO)festlegen.
MediaRemovable
Wenn dieses Element auf einen nichtzero-Wert festgelegt ist, ist die Gerätemedien wechselbar. Andernfalls ist die Gerätemedien nicht wechselbar.
MediaHotplug
Wenn dieses Element auf einen nichtzero-Wert festgelegt ist, ist die Medien nicht gesperrt. Andernfalls ist die Gerätemedien gesperrt.
DeviceHotplug
Wenn dieses Element auf einen nichtzero-Wert festgelegt ist, ist das Gerät ein Hotplug-Gerät. Andernfalls ist das Gerät kein Hotplug-Gerät.
WriteCacheEnableOverride
Reserviert; legen Sie den Wert auf NULL fest.
Hinweise
Der Wert des Size-Elements identifiziert auch die Version dieser Struktur, da Elemente dieser Struktur in Zukunft hinzugefügt werden. Wenn der Wert des Size-Elementssizeof(STORAGE_HOTPLUG_INFO)lautet, ist die aktuelle Version der Struktur identisch mit der Version, mit der Sie kompiliert wurden. Wenn der Wert nicht sizeof(STORAGE_HOTPLUG_INFO)ist, enthält die aktuelle Version zusätzliche Elemente.
Ein Hotplug-Gerät bezieht sich auf ein Gerät, dessen RemovalPolicy-Wert im Geräte-Manager angezeigt wird, ist ExpectSurpriseRemoval. Verwenden Sie zum Abfragen, ob ein bestimmtes Gerät ein Hotplug-Gerät ist, den IOCTL_STORAGE_GET_HOTPLUG_INFO-Vorgang . Um die Hotplug-Eigenschaften eines Geräts festzulegen, verwenden Sie den IOCTL_STORAGE_SET_HOTPLUG_INFO-Vorgang .
Der IOCTL_STORAGE_SET_HOTPLUG_INFO-Vorgang legt nur den Wert des DeviceHotplug-Members dieser Struktur fest. Wenn der Wert dieses Members festgelegt ist, wird die Entfernungsrichtlinie des angegebenen Geräts auf "ExpectSurpriseRemoval " festgelegt, und alle Zwischenspeicherungsebenen sind deaktiviert. Wenn der Wert dieses Members nicht festgelegt ist, wird die Entfernungsrichtlinie des angegebenen Geräts auf " ExpectOrderlyRemoval" festgelegt, und die Zwischenspeicherung kann selektiv aktiviert werden.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows XP |
| Unterstützte Mindestversion (Server) | Windows Server 2003 |
| Header | winioctl.h (enthalten Windows.h) |