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 Aufrufer muss diesen Member auf sizeof(STORAGE_HOTPLUG_INFO)festlegen.
MediaRemovable
Wenn dieser Member auf einen Wert ungleich Null festgelegt ist, ist das Gerätemedium wechselbar. Andernfalls können die Gerätemedien nicht entfernbar sein.
MediaHotplug
Wenn dieser Member auf einen Wert ungleich null festgelegt ist, können die Medien nicht gesperrt werden. Andernfalls können die Gerätemedien gesperrt werden.
DeviceHotplug
Wenn dieser Member auf einen Wert ungleich null festgelegt ist, handelt es sich bei dem Gerät um 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 gibt auch die Version dieser Struktur an, da dieser Struktur in Zukunft Member hinzugefügt werden. Wenn der Wert des Size-Elements ist, entspricht sizeof(STORAGE_HOTPLUG_INFO)die aktuelle Version der Struktur der Version, mit der Sie kompiliert haben. Wenn der Wert nicht sizeof(STORAGE_HOTPLUG_INFO)ist, enthält die aktuelle Version zusätzliche Member.
Ein Hotplug-Gerät bezieht sich auf ein Gerät, dessen RemovalPolicy-Wert in der Geräte-Manager "ExpectSurpriseRemoval" angezeigt wird. Um abzufragen, ob ein bestimmtes Gerät ein Hotplug-Gerät ist, verwenden Sie den vorgang IOCTL_STORAGE_GET_HOTPLUG_INFO . Verwenden Sie den Vorgang IOCTL_STORAGE_SET_HOTPLUG_INFO , um die Hotplug-Eigenschaften eines Geräts festzulegen.
Der vorgang IOCTL_STORAGE_SET_HOTPLUG_INFO legt nur den Wert des DeviceHotplug-Elements dieser Struktur fest. Wenn der Wert dieses Members festgelegt ist, wird die Entfernungsrichtlinie des angegebenen Geräts auf ExpectSurpriseRemoval festgelegt, und alle Ebenen der Zwischenspeicherung sind deaktiviert. Wenn der Wert dieses Members nicht festgelegt ist, wird die Entfernungsrichtlinie des angegebenen Geräts auf ExpectOrderlyRemoval festgelegt, und das Zwischenspeichern kann selektiv aktiviert werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP |
| Unterstützte Mindestversion (Server) | Windows Server 2003 |
| Kopfzeile | winioctl.h (windows.h einschließen) |