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 poderá ser bloqueada. Se definido como zero, a mídia do dispositivo poderá ser bloqueada.

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 será um dispositivo hotplug.

WriteCacheEnableOverride

Não use; defina o valor como NULL.

Comentários

O valor do membro Size também identifica a versão dessa estrutura. Novos membros serão adicionados a essa estrutura no futuro. Se o valor do membro Size for sizeof(STORAGE_HOTPLUG_INFO), a versão atual da estrutura será igual à versão com a qual você compilou. Se o valor não for sizeof(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 dispositivo específico é um dispositivo hotplug, use a solicitação IOCTL_STORAGE_GET_HOTPLUG_INFO . Para definir as propriedades 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 membro DeviceHotplug 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 (inclua Ntddstor.h)

Confira também

IOCTL_STORAGE_GET_HOTPLUG_INFO

IOCTL_STORAGE_SET_HOTPLUG_INFO