estrutura NTMS_DRIVEINFORMATIONW (ntmsapi.h)

Artigo
11/20/2024

[Gerenciador de Armazenamento Removível não está mais disponível a partir do Windows 7 e do Windows Server 2008 R2.]

A estrutura NTMS_DRIVEINFORMATION define propriedades específicas para um objeto de unidade.

Sintaxe

typedef struct _NTMS_DRIVEINFORMATIONW {
  DWORD      Number;
  DWORD      State;
  NTMS_GUID  DriveType;
  WCHAR      szDeviceName[NTMS_DEVICENAME_LENGTH];
  WCHAR      szSerialNumber[NTMS_SERIALNUMBER_LENGTH];
  WCHAR      szRevision[NTMS_REVISION_LENGTH];
  WORD       ScsiPort;
  WORD       ScsiBus;
  WORD       ScsiTarget;
  WORD       ScsiLun;
  DWORD      dwMountCount;
  SYSTEMTIME LastCleanedTs;
  NTMS_GUID  SavedPartitionId;
  NTMS_GUID  Library;
  GUID       Reserved;
  DWORD      dwDeferDismountDelay;
} NTMS_DRIVEINFORMATIONW;

Membros

Number

Número da unidade na biblioteca. Isso é definido como zero ou um relativo ao valor com base no sistema de numeração da unidade do dispositivo. Algumas unidades de número de alteradores começam com zero e alguns changers começam com uma.

State

Estado da unidade. Esse pode ser um dos valores a seguir.

Valor	Significado
NTMS_DRIVESTATE_BEING_CLEANED	A unidade está sendo limpa e não está disponível.
NTMS_DRIVESTATE_DISMOUNTABLE	Se uma biblioteca estiver definida para desmontagem lenta, o meio poderá ser deixado na unidade da biblioteca em desmontagem. O RSM pode atender às solicitações de montagem para unidades carregadas e desmontadas.
NTMS_DRIVESTATE_DISMOUNTED	Nenhum meio na unidade.
NTMS_DRIVESTATE_LOADED	O meio é montado na unidade e é carregado para acesso de leitura e gravação.
NTMS_DRIVESTATE_MOUNTED	O meio é montado na unidade, mas não está pronto para acesso de leitura e gravação. Esse é um estado temporário que é usado enquanto uma unidade aguarda a sincronização de eixos ou o carregamento de mídia de fita no mecanismo principal.
NTMS_DRIVESTATE_UNLOADED	O meio foi desmontado pela unidade e está pronto para ser aberto. Esse estado indica que o eixo parou ou uma mídia de fita foi retornada para o cartucho de fita.

DriveType

Identificador exclusivo do objeto de tipo de unidade que contém os atributos da unidade.

szDeviceName[NTMS_DEVICENAME_LENGTH]

Nome do dispositivo usado para acessar a unidade. Para uma unidade de fita, isso contém o nome do dispositivo \.\tape0 ou \.\tape1. Outros dispositivos fornecem o nome de uma unidade de disco SCSI ou a raiz de um sistema de arquivos que atualmente tem o dispositivo montado (bruto, NTFS, FAT e assim por diante).

szSerialNumber[NTMS_SERIALNUMBER_LENGTH]

Número de série da unidade representada como uma cadeia de caracteres. Dispositivos que não dão suporte a números de série relatam NULL para esse membro.

szRevision[NTMS_REVISION_LENGTH]

Revisão da unidade representada como uma cadeia de caracteres.

ScsiPort

Adaptador de host SCSI ao qual a unidade está conectada.

ScsiBus

Barramento SCSI ao qual a unidade está conectada.

ScsiTarget

ID de destino SCSI para a unidade.

ScsiLun

ID da unidade lógica SCSI para a unidade.

dwMountCount

Número de vezes que a unidade teve um meio montado nele. Se a unidade der suporte ao relatório de um número de série exclusivo, esse valor será o número de vezes que a unidade foi montada desde que foi instalada. Se a unidade não der suporte ao relatório de números de série, esse membro refletirá o número de montagens para todas as unidades nesse local.

LastCleanedTs

Da última vez que a unidade foi limpa.

SavedPartitionId

Identificador de partição do meio que está na unidade. Se esse valor for NULL e a unidade estiver cheia, a mídia será carregada por um usuário e precisará ser classificada.

Library

Identificador exclusivo da biblioteca que contém a unidade.

Reserved

Reservado.

dwDeferDismountDelay

O número mínimo de segundos que um meio permanecerá em uma unidade de uma biblioteca após a execução de uma desmontagem adiada. O padrão é 5 minutos. Esse membro não se aplica a bibliotecas autônomas. Este membro é gravável.

Observações

A estrutura NTMS_DRIVEINFORMATION está incluída na estrutura NTMS_OBJECTINFORMATION.

Nota

O cabeçalho ntmsapi.h define NTMS_DRIVEINFORMATION como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows XP [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
cabeçalho	ntmsapi.h

Consulte também

NTMS_OBJECTINFORMATION

Compartilhar via