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;

Member

Size

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

MediaRemovable

Gibt an, ob das Medium wechselbar ist. Wenn sie auf einen wert ohne Wert festgelegt ist, kann das Gerätemedium entfernbar sein. Wenn auf Null festgelegt ist, können die Gerätemedien nicht entfernbar sein.

MediaHotplug

Gibt an, ob die Medien gesperrt werden können. Wenn sie auf einen wert ohne Wert festgelegt ist, können die Gerätemedien nicht gesperrt werden. Wenn auf null festgelegt ist, können die Gerätemedien gesperrt werden.

DeviceHotplug

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

WriteCacheEnableOverride

Nicht verwenden; Legen Sie den Wert auf NULL fest.

Hinweise

Der Wert des Size-Members gibt auch die Version dieser Struktur an. Dieser Struktur werden in Zukunft neue Mitglieder hinzugefügt. Wenn der Wert des Size-Memberssizeof(STORAGE_HOTPLUG_INFO ist), ist die aktuelle Version der Struktur mit der Version identisch, mit der Sie kompiliert haben. Wenn der Wert nicht sizeof(STORAGE_HOTPLUG_INFO ist), enthält die aktuelle Version zusätzliche Member.

Microsoft Windows XP bietet Unterstützung für Hotplug-Geräte. Ein Hotplug-Gerät bezieht sich auf ein Gerät, dessen RemovalPolicy-Wert im Geräte-Manager ExpectSurpriseRemoval angezeigt wird. Verwenden Sie die IOCTL_STORAGE_GET_HOTPLUG_INFO-Anforderung , um abzufragen, ob es sich bei einem bestimmten Gerät um ein Hotplug-Gerät handelt. Um die Hotplug-Eigenschaften eines Geräts festzulegen, verwenden Sie die IOCTL_STORAGE_SET_HOTPLUG_INFO Anforderung.

Im Fall der IOCTL_STORAGE_SET_HOTPLUG_INFO Anforderung bestimmt das DeviceHotplug-Element der STORAGE_HOTPLUG_INFO-Struktur, welche Aktion ausgeführt wird. Wenn der Wert dieses Members nichtzero 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 0 ist, wird die Entfernungsrichtlinie auf ExpectOrderlyRemoval festgelegt, und die Zwischenspeicherung kann selektiv aktiviert werden.

Anforderungen

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

Weitere Informationen

IOCTL_STORAGE_GET_HOTPLUG_INFO

IOCTL_STORAGE_SET_HOTPLUG_INFO