Freigeben über

GETVERSIONINPARAMS-Struktur (ntdddisk.h)

  • Artikel

Die GETVERSIONINPARAMS-Struktur wird in Verbindung mit der SMART_GET_VERSION-Anforderung verwendet, um Versionsinformationen, eine Funktionsmaske und eine Bitmaske für das angegebene Gerät abzurufen.

Syntax

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

Member

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:

Bitmapflags 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 master Gerät im primären Kanal.
Bit 1 ist auf 1 festgelegt. Das Gerät ist ein IDE-Laufwerk und das untergeordnete Gerät im primären Kanal.
Bit 2 ist auf 1 festgelegt. Das Gerät ist ein IDE-Laufwerk und das master Gerät im sekundären Kanal.
Bit 3 ist auf 1 festgelegt. Das Gerät ist ein IDE-Laufwerk und das untergeordnete Gerät im sekundären Kanal.
Bit 4 ist auf 1 festgelegt. Das Gerät ist ein ATAPI-Laufwerk und das master Gerä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 das master Gerät im sekundären Kanal.
Bit 7 ist auf 1 festgelegt. Das Gerät ist ein ATAPI-Laufwerk und das untergeordnete Gerät im sekundären Kanal.

fCapabilities

Enthält die Bitmaske der Treiberfunktionen.

Bitmapflags 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.

Hinweise

Der SMART_GET_VERSION-Steuerelementcode gibt Versionsinformationen, eine Funktionsmaske 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 unter Irp-AssociatedIrp.SystemBuffer> zurück.

  • E/A-Statusblock

    Der Treiber legt das Feld Information auf sizeof(GETVERSIONINPARAMS) fest, wenn er das Feld Status auf STATUS_SUCCESS festlegt. Andernfalls legt der Treiber das Feld Information auf null und das Feld Status auf möglicherweise STATUS_INVALID_PARAMETER fest.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000
Kopfzeile ntdddisk.h (include Ntdddisk.h)