Share via

Структура GETVERSIONINPARAMS (ntdddisk.h)

  • Статья

Структура GETVERSIONINPARAMS используется в сочетании с запросом SMART_GET_VERSION для получения сведений о версии, маски возможностей и битовой маски для указанного устройства.

Синтаксис

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

Члены

bVersion

Содержит целое число, указывающее номер версии двоичного драйвера.

bRevision

Содержит целое число, указывающее номер редакции двоичного драйвера.

bReserved

Зарезервировано.

bIDEDeviceMap

Содержит растровое изображение. В следующей таблице объясняется значение растрового изображения:

Флаги растрового изображения Значение
Бит 0 имеет значение 1. Устройство является либо диском SATA, либо диском IDE. Если это диск интегрированной среды разработки, это master устройство в основном канале.
Бит 1 имеет значение 1. Устройство является диском интегрированной среды разработки и подчиненным устройством в основном канале.
Бит 2 имеет значение 1. Устройство является диском интегрированной среды разработки и является master устройством на вторичном канале.
Бит 3 имеет значение 1. Устройство является диском интегрированной среды разработки и подчиненным устройством в дополнительном канале.
Бит 4 имеет значение 1. Устройство является диском ATAPI и master устройством в основном канале.
Бит 5 имеет значение 1. Устройство является диском ATAPI и подчиненным устройством в основном канале.
Бит 6 имеет значение 1. Устройство является диском ATAPI и master устройством на вторичном канале.
Бит 7 имеет значение 1. Устройство является диском ATAPI и подчиненным устройством в дополнительном канале.

fCapabilities

Содержит битовую маску возможностей драйвера.

Флаги растрового изображения Значение
CAP_ATA_ID_CMD Устройство поддерживает команду ATA ID.
CAP_ATAPI_ID_CMD Устройство поддерживает команду ATAPI ID.
CAP_SMART_CMD Устройство поддерживает команды SMART.

dwReserved[4]

Зарезервировано.

Комментарии

Код элемента управления SMART_GET_VERSION возвращает сведения о версии, маску возможностей и битовую маску для устройства. Эти IOCTL должны обрабатываться драйверами, поддерживающими технологию Self-Monitoring анализа и отчетности (SMART).

  • Входные параметры

    Parameters.DeviceIoControl.OutputBufferLength указывает размер буфера в байтах, который должен иметь >значение = sizeof(GETVERSIONINPARAMS).

  • Выходные параметры

    Драйвер возвращает сведения в буфер по адресу Irp-AssociatedIrp.SystemBuffer>.

  • Блок состояния ввода-вывода

    Драйвер задает для поля Information значение sizeof(GETVERSIONINPARAMS), если для поля Состояние задано значение STATUS_SUCCESS. В противном случае драйвер задает для поля Сведения нулевое значение, а для поля Состояние — возможно, STATUS_INVALID_PARAMETER.

Требования

Требование Значение
Минимальная версия клиента Windows 2000
Верхняя часть ntdddisk.h (включая Ntdddisk.h)