Freigeben über


STORAGE_HOTPLUG_INFO Struktur (ntddstor.h)

Die STORAGE_HOTPLUG_INFO-Struktur stellt Hotplug-Informationen für ein Gerät bereit.

Syntax

typedef struct _STORAGE_HOTPLUG_INFO {
  ULONG   Size;
  BOOLEAN MediaRemovable;
  BOOLEAN MediaHotplug;
  BOOLEAN DeviceHotplug;
  BOOLEAN WriteCacheEnableOverride;
} STORAGE_HOTPLUG_INFO, *PSTORAGE_HOTPLUG_INFO;

Angehörige

Size

Gibt die Größe dieser Struktur in Bytes an.

MediaRemovable

Gibt an, ob das Medium wechselbar ist. Wenn dieser Wert auf einen Wert ungleich Null festgelegt ist, ist das Gerätemedium wechselbar. Wenn dieser Wert auf Null festgelegt ist, ist das Gerätemedium nicht wechselbar.

MediaHotplug

Gibt an, ob das Medium gesperrt werden kann. Wenn dieser Wert auf einen Wert ungleich Null festgelegt ist, kann das Gerätemedium nicht gesperrt werden. Bei Festlegung auf Null ist das Gerätemedium sperrbar.

DeviceHotplug

Gibt an, ob es sich bei dem Gerät um ein Hotplug-Gerät handelt. Wenn dieser Wert auf einen Wert ungleich Null festgelegt ist, handelt es sich bei dem Gerät um ein Hotplug-Gerät. Bei Festlegung auf Null ist das Gerät kein Hotplug-Gerät.

WriteCacheEnableOverride

Nicht verwenden; legen Sie den Wert auf NULL-fest.

Bemerkungen

Der Wert des Size Member identifiziert auch die Version dieser Struktur. Neue Mitglieder werden in Zukunft dieser Struktur hinzugefügt. Wenn der Wert des members Sizesizeof(STORAGE_HOTPLUG_INFO) ist, entspricht die aktuelle Version der Struktur der Version, mit der Sie kompiliert haben. Wenn der Wert nicht Größe(STORAGE_HOTPLUG_INFO) ist, enthält die aktuelle Version zusätzliche Member.

Microsoft Windows XP enthält Unterstützung für Hotplug-Geräte. Ein Hotplug-Gerät bezieht sich auf ein Gerät, dessen RemovalPolicy-wert im Geräte-Manager angezeigt wird, ExpectSurpriseRemovalist. Um abzufragen, ob ein bestimmtes Gerät ein Hotplug-Gerät ist, verwenden Sie die IOCTL_STORAGE_GET_HOTPLUG_INFO Anforderung. Verwenden Sie die IOCTL_STORAGE_SET_HOTPLUG_INFO Anforderung, um die Hotplug-Eigenschaften eines Geräts festzulegen.

Im Falle der IOCTL_STORAGE_SET_HOTPLUG_INFO-Anforderung bestimmt das DeviceHotplug- Mitglied der STORAGE_HOTPLUG_INFO-Struktur, welche Aktion ausgeführt wird. Wenn der Wert dieses Elements "nonzero" ist, wird der Wert für die Entfernungsrichtlinie des Geräts in der Registrierung auf ExpectSurpriseRemoval festgelegt, und alle Zwischenspeicherungsebenen sind deaktiviert. Wenn der Wert von DeviceHotplug null ist, wird die Entfernungsrichtlinie auf ExpectOrderlyRemovalfestgelegt, und die Zwischenspeicherung kann selektiv aktiviert werden.

Anforderungen

Anforderung Wert
Header- ntddstor.h (include Ntddstor.h)

Siehe auch

IOCTL_STORAGE_GET_HOTPLUG_INFO

IOCTL_STORAGE_SET_HOTPLUG_INFO