Partilhar via


estrutura STORAGE_HOTPLUG_INFO (ntddstor.h)

A estrutura STORAGE_HOTPLUG_INFO fornece informações de hotplug para um dispositivo.

Sintaxe

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

Membros

Size

Indica o tamanho, em bytes, dessa estrutura.

MediaRemovable

Especifica se a mídia é removível. Se definido como um valor diferente de zero, a mídia do dispositivo será removível. Se definido como zero, a mídia do dispositivo não será removível.

MediaHotplug

Especifica se a mídia é bloqueável. Se definido como um valor diferente de zero, a mídia do dispositivo não será bloqueável. Se definido como zero, a mídia do dispositivo será bloqueável.

DeviceHotplug

Especifica se o dispositivo é um dispositivo hotplug. Se definido como um valor diferente de zero, o dispositivo será um dispositivo hotplug. Se definido como zero, o dispositivo não é um dispositivo hotplug.

WriteCacheEnableOverride

Não use; defina o valor como NULL.

Observações

O valor do membro tamanho do também identifica a versão dessa estrutura. Novos membros serão adicionados a essa estrutura no futuro. Se o valor do membro tamanho do for tamanho de(STORAGE_HOTPLUG_INFO), a versão atual da estrutura será a mesma da versão com a qual você compilou. Se o valor não for tamanho de(STORAGE_HOTPLUG_INFO), a versão atual conterá membros adicionais.

O Microsoft Windows XP inclui suporte para dispositivos hotplug. Um dispositivo hotplug refere-se a um dispositivo cujo valor RemovalPolicy exibido no Gerenciador de Dispositivos é ExpectSurpriseRemoval. Para consultar se um determinado dispositivo é um dispositivo hotplug, use a solicitação IOCTL_STORAGE_GET_HOTPLUG_INFO. Para definir as propriedades de hotplug de um dispositivo, use a solicitação IOCTL_STORAGE_SET_HOTPLUG_INFO.

No caso da solicitação de IOCTL_STORAGE_SET_HOTPLUG_INFO, o DeviceHotplug membro da estrutura STORAGE_HOTPLUG_INFO determina qual ação é tomada. Se o valor desse membro não for zero, o valor da política de remoção do dispositivo no registro será definido como ExpectSurpriseRemoval e todos os níveis de cache serão desabilitados. Se o valor de DeviceHotplug for zero, a política de remoção será definida como ExpectOrderlyRemoval e o cache poderá ser habilitado seletivamente.

Requisitos

Requisito Valor
cabeçalho ntddstor.h (include Ntddstor.h)

Consulte também

IOCTL_STORAGE_GET_HOTPLUG_INFO

IOCTL_STORAGE_SET_HOTPLUG_INFO