Condividi tramite

Struttura GETVERSIONINPARAMS (ntdddisk.h)

  • Articolo

La struttura GETVERSIONINPARAMS viene usata insieme alla richiesta di SMART_GET_VERSION per recuperare le informazioni sulla versione, una maschera delle funzionalità e una maschera bit per il dispositivo indicato.

Sintassi

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

Members

bVersion

Contiene un numero intero che indica il numero di versione del driver binario.

bRevision

Contiene un intero che indica il numero di revisione del driver binario.

bReserved

Riservato.

bIDEDeviceMap

Contiene la bitmap. La tabella seguente illustra il significato della bitmap:

Flag bitmap Significato
Bit 0 è impostato su 1. Il dispositivo è un'unità SATA o un'unità IDE. Se si tratta di un'unità IDE, è il dispositivo master nel canale primario.
Bit 1 è impostato su 1. Il dispositivo è un'unità IDE ed è il dispositivo subordinato nel canale primario.
Bit 2 è impostato su 1. Il dispositivo è un'unità IDE ed è il dispositivo master nel canale secondario.
Bit 3 è impostato su 1. Il dispositivo è un'unità IDE ed è il dispositivo subordinato nel canale secondario.
Bit 4 è impostato su 1. Il dispositivo è un'unità ATAPI ed è il dispositivo master nel canale primario.
Bit 5 è impostato su 1. Il dispositivo è un'unità ATAPI ed è il dispositivo subordinato nel canale primario.
Bit 6 è impostato su 1. Il dispositivo è un'unità ATAPI ed è il dispositivo master nel canale secondario.
Bit 7 è impostato su 1. Il dispositivo è un'unità ATAPI ed è il dispositivo subordinato nel canale secondario.

fCapabilities

Contiene la maschera bit delle funzionalità del driver.

Flag bitmap Significato
CAP_ATA_ID_CMD Il dispositivo supporta il comando ATA ID.
CAP_ATAPI_ID_CMD Il dispositivo supporta il comando ATAPI ID.
CAP_SMART_CMD Il dispositivo supporta i comandi SMART.

dwReserved[4]

Riservato.

Commenti

Il codice di controllo SMART_GET_VERSION restituisce informazioni sulla versione, una maschera di funzionalità e una maschera bit per il dispositivo. Questo IOCTL deve essere gestito dai driver che supportano Self-Monitoring Analysis and Reporting Technology (SMART).

  • Parametri di input

    Parameters.DeviceIoControl.OutputBufferLength indica le dimensioni, in byte, del buffer, che deve essere >= sizeof(GETVERSIONINPARAMS).

  • Parametri di output

    Il driver restituisce le informazioni al buffer in Irp-AssociatedIrp.SystemBuffer>.

  • Blocco dello stato I/O

    Il driver imposta il campo Informazioni su sizeof(GETVERSIONINPARAMS) quando imposta il campo Stato su STATUS_SUCCESS. In caso contrario, il driver imposta il campo Informazioni su zero e imposta il campo Stato su possibilmente STATUS_INVALID_PARAMETER.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000
Intestazione ntdddisk.h (include Ntdddisk.h)