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)

Weitere Informationen

IOCTL_STORAGE_GET_HOTPLUG_INFO

IOCTL_STORAGE_SET_HOTPLUG_INFO