STORAGE_HOTPLUG_INFO structure (ntddstor.h)

La structure STORAGE_HOTPLUG_INFO fournit des informations sur les bouchons à chaud pour un appareil.

Syntaxe

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

Membres

Size

Indique la taille, en octets, de cette structure.

MediaRemovable

Spécifie si le média est amovible. Si la valeur est différente de zéro, le support de l’appareil est amovible. Si la valeur est zéro, le support de l’appareil n’est pas amovible.

MediaHotplug

Spécifie si le média est verrouillable. Si la valeur est différente de zéro, le média de l’appareil n’est pas verrouillable. Si la valeur est zéro, le média de l’appareil est verrouillable.

DeviceHotplug

Spécifie si l’appareil est un appareil de débranchement à chaud. S’il est défini sur une valeur différente de zéro, l’appareil est un appareil de débranchement à chaud. S’il est défini sur zéro, l’appareil n’est pas un appareil de débranchement à chaud.

WriteCacheEnableOverride

N’utilisez pas ; définissez la valeur sur NULL.

Remarques

La valeur du membre Size identifie également la version de cette structure. De nouveaux membres seront ajoutés à cette structure à l’avenir. Si la valeur du membre Size est sizeof(STORAGE_HOTPLUG_INFO), la version actuelle de la structure est identique à la version avec laquelle vous avez compilé. Si la valeur n’est pas sizeof(STORAGE_HOTPLUG_INFO), la version actuelle contient des membres supplémentaires.

Microsoft Windows XP prend en charge les appareils hotplug. Un appareil hotplug fait référence à un appareil dont la valeur RemovalPolicy affichée dans le Gestionnaire de périphériques est ExpectSurpriseRemoval. Pour savoir si un appareil particulier est un appareil à chaud, utilisez la demande IOCTL_STORAGE_GET_HOTPLUG_INFO . Pour définir les propriétés hotplug d’un appareil, utilisez la requête IOCTL_STORAGE_SET_HOTPLUG_INFO .

Dans le cas de la demande de IOCTL_STORAGE_SET_HOTPLUG_INFO, le membre DeviceHotplug de la structure STORAGE_HOTPLUG_INFO détermine l’action qui est effectuée. Si la valeur de ce membre est différente de zéro, la valeur de la stratégie de suppression de l’appareil dans le Registre est définie sur ExpectSurpriseRemoval et tous les niveaux de mise en cache sont désactivés. Si la valeur de DeviceHotplug est zéro, la stratégie de suppression est définie sur ExpectOrderlyRemoval et la mise en cache peut être activée de manière sélective.

Configuration requise

Condition requise	Valeur
En-tête	ntddstor.h (inclure Ntddstor.h)

Voir aussi

IOCTL_STORAGE_GET_HOTPLUG_INFO

IOCTL_STORAGE_SET_HOTPLUG_INFO