Partilhar via

Estrutura GETVERSIONINPARAMS (ntdddisk.h)

  • Artigo

A estrutura GETVERSIONINPARAMS é usada em conjunto com a solicitação SMART_GET_VERSION para recuperar informações de versão, uma máscara de funcionalidades e uma máscara de bits para o dispositivo indicado.

Sintaxe

typedef struct _GETVERSIONINPARAMS {
  UCHAR bVersion;
  UCHAR bRevision;
  UCHAR bReserved;
  UCHAR bIDEDeviceMap;
  ULONG fCapabilities;
  ULONG dwReserved[4];
} GETVERSIONINPARAMS, *PGETVERSIONINPARAMS, *LPGETVERSIONINPARAMS;

Membros

bVersion

Contém um inteiro que indica o número de versão do driver binário.

bRevision

Contém um inteiro que indica o número de revisão do driver binário.

bReserved

Reservado.

bIDEDeviceMap

Contém o bitmap. A tabela a seguir explica o significado do bitmap:

Sinalizadores de bitmap Significado
O bit 0 está definido como 1. O dispositivo é uma unidade SATA ou uma unidade IDE. Se for uma unidade IDE, será o dispositivo master no canal primário.
O bit 1 é definido como 1. O dispositivo é uma unidade IDE e é o dispositivo subordinado no canal primário.
O bit 2 está definido como 1. O dispositivo é uma unidade IDE e é o dispositivo master no canal secundário.
O bit 3 é definido como 1. O dispositivo é uma unidade IDE e é o dispositivo subordinado no canal secundário.
O bit 4 está definido como 1. O dispositivo é uma unidade de ATAPI e é o dispositivo master no canal primário.
O bit 5 está definido como 1. O dispositivo é uma unidade de ATAPI e é o dispositivo subordinado no canal primário.
O bit 6 está definido como 1. O dispositivo é uma unidade de ATAPI e é o dispositivo master no canal secundário.
O bit 7 está definido como 1. O dispositivo é uma unidade de ATAPI e é o dispositivo subordinado no canal secundário.

fCapabilities

Contém a máscara de bits das funcionalidades do driver.

Sinalizadores de bitmap Significado
CAP_ATA_ID_CMD O dispositivo dá suporte ao comando ID do ATA.
CAP_ATAPI_ID_CMD O dispositivo dá suporte ao comando ID da ATAPI.
CAP_SMART_CMD O dispositivo dá suporte a comandos SMART.

dwReserved[4]

Reservado.

Comentários

O código de controle SMART_GET_VERSION retorna informações de versão, uma máscara de funcionalidades e uma máscara de bits para o dispositivo. Esse IOCTL deve ser tratado por drivers que dão suporte a Self-Monitoring SMART (Analysis and Reporting Technology).

  • Parâmetros de Entrada

    Parameters.DeviceIoControl.OutputBufferLength indica o tamanho, em bytes, do buffer, que deve ser >= sizeof(GETVERSIONINPARAMS).

  • Parâmetros de saída

    O driver retorna as informações para o buffer em Irp-AssociatedIrp.SystemBuffer>.

  • Bloco de Status de E/S

    O driver define o campo Informações como sizeof(GETVERSIONINPARAMS) quando define o campo Status como STATUS_SUCCESS. Caso contrário, o driver define o campo Informações como zero e define o campo Status como possivelmente STATUS_INVALID_PARAMETER.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000
Cabeçalho ntdddisk.h (inclua Ntdddisk.h)