Struktur GETVERSIONINPARAMS (ntdddisk.h)

  • Artikel

Struktur GETVERSIONINPARAMS digunakan bersama dengan permintaan SMART_GET_VERSION untuk mengambil informasi versi, masker kemampuan, dan bitmask untuk perangkat yang ditunjukkan.

Sintaks

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

Anggota

bVersion

Berisi bilangan bulat yang menunjukkan nomor versi driver biner.

bRevision

Berisi bilangan bulat yang menunjukkan nomor revisi driver biner.

bReserved

Dicadangkan.

bIDEDeviceMap

Berisi bitmap. Tabel berikut menjelaskan arti bitmap:

Bendera Bitmap Makna
Bit 0 diatur ke 1. Perangkat ini adalah drive SATA atau drive IDE. Jika itu adalah drive IDE, itu adalah perangkat master di saluran utama.
Bit 1 diatur ke 1. Perangkat ini adalah drive IDE, dan merupakan perangkat subordinat di saluran utama.
Bit 2 diatur ke 1. Perangkat ini adalah drive IDE, dan merupakan perangkat master di saluran sekunder.
Bit 3 diatur ke 1. Perangkat ini adalah drive IDE, dan merupakan perangkat bawahan pada saluran sekunder.
Bit 4 diatur ke 1. Perangkat ini adalah drive ATAPI, dan merupakan perangkat master di saluran utama.
Bit 5 diatur ke 1. Perangkat ini adalah drive ATAPI, dan merupakan perangkat bawahan di saluran utama.
Bit 6 diatur ke 1. Perangkat ini adalah drive ATAPI, dan merupakan perangkat master di saluran sekunder.
Bit 7 diatur ke 1. Perangkat ini adalah drive ATAPI, dan merupakan perangkat bawahan pada saluran sekunder.

fCapabilities

Berisi bitmask kemampuan driver.

Bendera Bitmap Makna
CAP_ATA_ID_CMD Perangkat mendukung perintah ID ATA.
CAP_ATAPI_ID_CMD Perangkat mendukung perintah ID ATAPI.
CAP_SMART_CMD Perangkat mendukung perintah SMART.

dwReserved[4]

Dicadangkan.

Keterangan

Kode kontrol SMART_GET_VERSION mengembalikan informasi versi, masker kemampuan, dan bitmask untuk perangkat. IOCTL ini harus ditangani oleh driver yang mendukung Self-Monitoring Analysis and Reporting Technology (SMART).

  • Parameter Input

    Parameters.DeviceIoControl.OutputBufferLength menunjukkan ukuran, dalam byte, dari buffer, yang harus >= sizeof(GETVERSIONINPARAMS).

  • Parameter Output

    Driver mengembalikan informasi ke buffer di Irp-AssociatedIrp.SystemBuffer>.

  • Blok Status I/O

    Driver mengatur bidang Informasi ke sizeof(GETVERSIONINPARAMS) saat mengatur bidang Status ke STATUS_SUCCESS. Jika tidak, driver mengatur bidang Informasi ke nol dan mengatur bidang Status ke mungkin STATUS_INVALID_PARAMETER.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 2000
Header ntdddisk.h (termasuk Ntdddisk.h)