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)

Weitere Informationen

IOCTL_STORAGE_GET_HOTPLUG_INFO

IOCTL_STORAGE_SET_HOTPLUG_INFO