Compartilhar via


estrutura STORAGE_HOTPLUG_INFO (winioctl.h)

Fornece informações sobre as informações de hotplug de um dispositivo.

Sintaxe

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

Membros

Size

O tamanho dessa estrutura, em bytes. O chamador deve definir esse membro como sizeof(STORAGE_HOTPLUG_INFO).

MediaRemovable

Se esse membro for definido como um valor diferente de zero, a mídia do dispositivo será removível. Caso contrário, a mídia do dispositivo não será removível.

MediaHotplug

Se esse membro for definido como um valor diferente de zero, a mídia não poderá ser bloqueada. Caso contrário, a mídia do dispositivo poderá ser bloqueada.

DeviceHotplug

Se esse membro for definido como um valor diferente de zero, o dispositivo será um dispositivo hotplug. Caso contrário, o dispositivo não é um dispositivo hotplug.

WriteCacheEnableOverride

Reservados; defina o valor como NULL.

Comentários

O valor do membro Size também identifica a versão dessa estrutura, pois os 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 sizeof(STORAGE_HOTPLUG_INFO)for , a versão atual conterá membros adicionais.

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 operação IOCTL_STORAGE_GET_HOTPLUG_INFO . Para definir as propriedades de hotplug de um dispositivo, use a operação IOCTL_STORAGE_SET_HOTPLUG_INFO .

A operação IOCTL_STORAGE_SET_HOTPLUG_INFO define apenas o valor do membro DeviceHotplug dessa estrutura. Se o valor desse membro estiver definido, a política de remoção do dispositivo especificado será definida como ExpectSurpriseRemoval e todos os níveis de cache serão desabilitados. Se o valor desse membro não estiver definido, a política de remoção do dispositivo especificado será definida como ExpectOrderlyRemoval e o cache poderá ser habilitado seletivamente.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP
Servidor mínimo com suporte Windows Server 2003
Cabeçalho winioctl.h (inclua Windows.h)

Confira também

IOCTL_STORAGE_GET_HOTPLUG_INFO

IOCTL_STORAGE_SET_HOTPLUG_INFO