Condividi tramite

Struttura GETVERSIONINPARAMS (ntdddisk.h)

  • Articolo

La struttura GETVERSIONINPARAMS viene usata insieme alla richiesta di SMART_GET_VERSION per recuperare informazioni sulla versione, una maschera di funzionalità e una maschera di 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;

Membri

bVersion

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

bRevision

Contiene un numero 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, si tratta del 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 di 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.

Osservazioni

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

  • Parametri di input

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

  • Parametri di output

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

  • Blocco di stato di 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.

Fabbisogno

Requisito Valore
client minimo supportato Windows 2000
intestazione ntdddisk.h (include Ntdddisk.h)