GETVERSIONINPARAMS-Struktur (ntdddisk.h)

Die GETVERSIONINPARAMS-Struktur wird in Verbindung mit der SMART_GET_VERSION Anforderung zum Abrufen von Versionsinformationen, einer Funktionsmaske und einer Bitmaske für das angegebene Gerät verwendet.

Syntax

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

Angehörige

bVersion

Enthält eine ganze Zahl, die die Versionsnummer des binären Treibers angibt.

bRevision

Enthält eine ganze Zahl, die die Revisionsnummer des binären Treibers angibt.

bReserved

Reserviert.

bIDEDeviceMap

Enthält die Bitmap. In der folgenden Tabelle wird die Bedeutung der Bitmap erläutert:

Bitmap-Flags	Bedeutung
Bit 0 ist auf 1 festgelegt.	Das Gerät ist entweder ein SATA-Laufwerk oder ein IDE-Laufwerk. Wenn es sich um ein IDE-Laufwerk handelt, handelt es sich um das Mastergerät im primären Kanal.
Bit 1 ist auf 1 festgelegt.	Das Gerät ist ein IDE-Laufwerk, und es handelt sich um das untergeordnete Gerät im primären Kanal.
Bit 2 ist auf 1 festgelegt.	Das Gerät ist ein IDE-Laufwerk, und es handelt sich um das Mastergerät im sekundären Kanal.
Bit 3 ist auf 1 festgelegt.	Das Gerät ist ein IDE-Laufwerk, und es handelt sich um das untergeordnete Gerät im sekundären Kanal.
Bit 4 ist auf 1 festgelegt.	Das Gerät ist ein ATAPI-Laufwerk, und es handelt sich um das Mastergerät im primären Kanal.
Bit 5 ist auf 1 festgelegt.	Das Gerät ist ein ATAPI-Laufwerk und das untergeordnete Gerät im primären Kanal.
Bit 6 ist auf 1 festgelegt.	Das Gerät ist ein ATAPI-Laufwerk, und es handelt sich um das Mastergerät im sekundären Kanal.
Bit 7 ist auf 1 festgelegt.	Das Gerät ist ein ATAPI-Laufwerk, und es handelt sich um das untergeordnete Gerät im sekundären Kanal.

fCapabilities

Enthält die Bitmaske der Treiberfunktionen.

Bitmap-Flags	Bedeutung
CAP_ATA_ID_CMD	Das Gerät unterstützt den ATA-ID-Befehl.
CAP_ATAPI_ID_CMD	Das Gerät unterstützt den ATAPI-ID-Befehl.
CAP_SMART_CMD	Das Gerät unterstützt SMART-Befehle.

dwReserved[4]

Reserviert.

Bemerkungen

Der SMART_GET_VERSION Steuerelementcode gibt Versionsinformationen, ein Funktionsformat und eine Bitmaske für das Gerät zurück. Diese IOCTL muss von Treibern verarbeitet werden, die Self-Monitoring Analysis and Reporting Technology (SMART) unterstützen.

• Eingabeparameter

  Parameters.DeviceIoControl.OutputBufferLength gibt die Größe des Puffers in Bytes an, die >= sizeof(GETVERSIONINPARAMS) sein muss.

• Ausgabeparameter

  Der Treiber gibt die Informationen an den Puffer bei Irp->AssociatedIrp.SystemBuffer zurück.

• E/A-Statusblock

  Der Treiber legt das Feld "Information" auf "sizeof(GETVERSIONINPARAMS)" fest, wenn das Feld "Status" auf STATUS_SUCCESS festgelegt wird. Andernfalls legt der Treiber das Feld "Information" auf Null fest und legt das Feld "Status" auf möglicherweise STATUS_INVALID_PARAMETER fest.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000
Header-	ntdddisk.h (include Ntdddisk.h)