Структура 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 или диск интегрированной среды разработки. Если это диск интегрированной среды разработки, это главное устройство на основном канале.
Бит 1 имеет значение 1. Устройство является диском интегрированной среды разработки и является подчиненным устройством в основном канале.
Бит 2 имеет значение 1. Устройство является диском интегрированной среды разработки и является главным устройством на вторичном канале.
Бит 3 имеет значение 1. Устройство является диском интегрированной среды разработки и является подчиненным устройством на вторичном канале.
Бит 4 имеет значение 1. Устройство является диском ATAPI, и это главное устройство на основном канале.
Бит 5 имеет значение 1. Устройство является диском ATAPI, и оно является подчиненным устройством на основном канале.
Бит 6 имеет значение 1. Устройство является диском ATAPI, и это главное устройство на вторичном канале.
Бит 7 имеет значение 1. Устройство — это диск ATAPI, который является подчиненным устройством на вторичном канале.

fCapabilities

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

Флаги растрового изображения Значение
CAP_ATA_ID_CMD Устройство поддерживает команду ATA ID.
CAP_ATAPI_ID_CMD Устройство поддерживает команду ИДЕНТИФИКАТОРА ATAPI.
CAP_SMART_CMD Устройство поддерживает команды SMART.

dwReserved[4]

Скрытный.

Замечания

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

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

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

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

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

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

    Драйвер задает поле сведений для sizeof(GETVERSIONINPARAMS), когда оно задает для поля "Состояние" значение STATUS_SUCCESS. В противном случае драйвер задает поле "Информация" равным нулю и задает поле "Состояние", возможно, STATUS_INVALID_PARAMETER.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows 2000
заголовка ntdddisk.h (include Ntdddisk.h)
  • Last updated on