Share via

estrutura VDS_DRIVE_NOTIFICATION (vds.h)

  • Artigo

[Começando com Windows 8 e Windows Server 2012, a interface COM do Serviço de Disco Virtual é substituída pela API de Gerenciamento de Armazenamento do Windows.]

Define os detalhes dos eventos de unidade.

Sintaxe

typedef struct _VDS_DRIVE_NOTIFICATION {
  ULONG         ulEvent;
  VDS_OBJECT_ID driveId;
} VDS_DRIVE_NOTIFICATION;

Membros

ulEvent

Determina o evento de unidade para o qual um aplicativo será notificado, como um dos valores a seguir.

Valor Significado
VDS_NF_DRIVE_ARRIVE
105
 Uma unidade é relatada como fisicamente presente no subsistema. O valor VDS_DRIVE_STATUS associado a essa notificação deve ser qualquer valor, exceto VDS_DRS_REMOVED.
VDS_NF_DRIVE_DEPART
106
 Uma unidade foi fisicamente removida do subsistema. O valor VDS_DRIVE_STATUS deve ser VDS_DRS_UNKNOWN ou VDS_DRS_REMOVED.
VDS_NF_DRIVE_MODIFY
107
 Um membro da estrutura VDS_DRIVE_PROP foi alterado ou uma extensão em uma unidade foi alterada.
VDS_NF_DRIVE_REMOVED
354
 Uma unidade que estava em uso como parte de um grupo RAID ou pool de armazenamento não está mais em uso como parte do grupo RAID ou do pool de armazenamento. Por exemplo, se uma unidade de grupo RAID foi detectada como falha e foi substituída por uma sobressalente quente, o valor VDS_DRIVE_STATUS deve ser VDS_DRS_FAILED (removido do uso devido a uma falha), VDS_DRS_OFFLINE (não falhou, mas não está em uso), VDS_DRS_NOT_READY ou VDS_DRS_UNKNOWN. Se a unidade foi removida como parte do rebalanceamento do armazenamento, a unidade não está falhando e o valor VDS_DRIVE_STATUS deve ser VDS_DRS_OFFLINE ou VDS_DRS_NOT_READY.

Windows Server 2008, Windows Vista e Windows Server 2003: Não há suporte para esse valor.

driveId

O GUID da unidade que disparou o evento.

Comentários

A estrutura VDS_NOTIFICATION inclui essa estrutura como membro.

Um aplicativo pode receber eventos de unidade implementando a interface IVdsAdviseSink e passando o ponteiro da interface como um argumento para o método IVdsService::Advise .

Para obter o objeto de unidade, use o método IVdsService::GetObject . Em seguida, você pode usar o método IVdsDrive::GetProperties ou o método IVdsDrive2::GetProperties2 para obter as propriedades da unidade.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho vds.h

Confira também

IVdsAdviseSink

IVdsService::Advise

Estruturas VDS

VDS_DRIVE_PROP

VDS_NOTIFICATION