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) |