structure STORAGE_HOTPLUG_INFO (ntddstor.h)
La structure STORAGE_HOTPLUG_INFO fournit des informations sur le plug-in 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. S’il est défini sur une valeur différente de zéro, le support de l’appareil est amovible. Si la valeur est égale à zéro, le support de l’appareil n’est pas amovible.
MediaHotplug
Spécifie si le média est verrouillable. S’il est défini sur une valeur différente de zéro, le support de l’appareil n’est pas verrouillable. Si la valeur est égale à zéro, le support de l’appareil est verrouillable.
DeviceHotplug
Spécifie si l’appareil est un appareil à chaud. Si la valeur est différente de zéro, l’appareil est un appareil à chaud. Si la valeur est égale à zéro, l’appareil n’est pas un appareil à 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 taille de(STORAGE_HOTPLUG_INFO), la version actuelle de la structure est la même que celle que vous avez compilée. Si la valeur n’est pas taille de(STORAGE_HOTPLUG_INFO), la version actuelle contient des membres supplémentaires.
Microsoft Windows XP inclut la prise en charge des appareils à chaud. Un appareil hotplug fait référence à un appareil dont la valeur RemovalPolicy affichée dans le Gestionnaire d’appareils est ExpectSurpriseRemoval. Pour interroger si un appareil particulier est un appareil à chaud, utilisez la demande de 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 quelle action est effectuée. Si la valeur de ce membre n’est pas nulle, 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 égale à 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.
Exigences
Exigence | Valeur |
---|---|
d’en-tête | ntddstor.h (include Ntddstor.h) |