structure STORAGE_HOTPLUG_INFO (winioctl.h)

Article
08/27/2023

Fournit des informations sur les informations de hotplug d’un appareil.

Syntaxe

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

Membres

Size

Taille de cette structure, en octets. L’appelant doit définir ce membre sur sizeof(STORAGE_HOTPLUG_INFO).

MediaRemovable

Si ce membre est défini sur une valeur différente de zéro, le support de l’appareil est amovible. Sinon, le support de l’appareil n’est pas amovible.

MediaHotplug

Si ce membre est défini sur une valeur différente de zéro, le média n’est pas verrouillable. Sinon, le média de l’appareil est verrouillable.

DeviceHotplug

Si ce membre est défini sur une valeur différente de zéro, l’appareil est un appareil à chaud débranché. Sinon, l’appareil n’est pas un appareil à chaud débranché.

WriteCacheEnableOverride

Réservés au; définissez la valeur NULL.

Remarques

La valeur du membre Size identifie également la version de cette structure, car des 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 que vous avez compilée. Si la valeur n’est pas sizeof(STORAGE_HOTPLUG_INFO), la version actuelle contient des membres supplémentaires.

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 débranché, utilisez l’opération IOCTL_STORAGE_GET_HOTPLUG_INFO . Pour définir les propriétés hotplug d’un appareil, utilisez l’opération IOCTL_STORAGE_SET_HOTPLUG_INFO .

L’opération IOCTL_STORAGE_SET_HOTPLUG_INFO définit uniquement la valeur du membre DeviceHotplug de cette structure. Si la valeur de ce membre est définie, la stratégie de suppression de l’appareil spécifié est définie sur ExpectSurpriseRemoval et tous les niveaux de mise en cache sont désactivés. Si la valeur de ce membre n’est pas définie, la stratégie de suppression de l’appareil spécifié est définie sur ExpectOrderlyRemoval et la mise en cache peut être activée de manière sélective.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP
Serveur minimal pris en charge	Windows Server 2003
En-tête	winioctl.h (inclure Windows.h)

Voir aussi

IOCTL_STORAGE_GET_HOTPLUG_INFO

IOCTL_STORAGE_SET_HOTPLUG_INFO

Partager via