Partager via

GETVERSIONINPARAMS, structure (ntdddisk.h)

  • Article

La structure GETVERSIONINPARAMS est utilisée conjointement avec la requête SMART_GET_VERSION pour récupérer les informations de version, un masque de fonctionnalités et un masque de bits pour l’appareil indiqué.

Syntaxe

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

Membres

bVersion

Contient un entier qui indique le numéro de version du pilote binaire.

bRevision

Contient un entier qui indique le numéro de révision du pilote binaire.

bReserved

Réservé.

bIDEDeviceMap

Contient la bitmap. Le tableau suivant explique la signification de la bitmap :

Indicateurs bitmap Signification
Le bit 0 est défini sur 1. L’appareil est un lecteur SATA ou un lecteur IDE. S’il s’agit d’un lecteur IDE, il s’agit de l’appareil maître sur le canal principal.
Le bit 1 est défini sur 1. L’appareil est un lecteur IDE et il s’agit de l’appareil subordonné sur le canal principal.
Le bit 2 est défini sur 1. L’appareil est un lecteur IDE et il s’agit de l’appareil maître sur le canal secondaire.
Le bit 3 est défini sur 1. L’appareil est un lecteur IDE et il s’agit de l’appareil subordonné sur le canal secondaire.
Le bit 4 est défini sur 1. L’appareil est un lecteur ATAPI et il s’agit de l’appareil maître sur le canal principal.
Le bit 5 est défini sur 1. L’appareil est un lecteur ATAPI et il s’agit de l’appareil subordonné sur le canal principal.
Le bit 6 est défini sur 1. L’appareil est un lecteur ATAPI et il s’agit de l’appareil maître sur le canal secondaire.
Le bit 7 est défini sur 1. L’appareil est un lecteur ATAPI et il s’agit de l’appareil subordonné sur le canal secondaire.

fCapabilities

Contient le masque de bits des fonctionnalités du pilote.

Indicateurs bitmap Signification
CAP_ATA_ID_CMD L’appareil prend en charge la commande ID ATA.
CAP_ATAPI_ID_CMD L’appareil prend en charge la commande ID ATAPI.
CAP_SMART_CMD L’appareil prend en charge les commandes SMART.

dwReserved[4]

Réservé.

Remarques

Le code de contrôle SMART_GET_VERSION retourne les informations de version, un masque de fonctionnalités et un masque de bits pour l’appareil. Ce IOCTL doit être géré par les pilotes qui prennent en charge Self-Monitoring'analyse et la technologie de création de rapports (SMART).

  • Paramètres d’entrée

    Parameters.DeviceIoControl.OutputBufferLength indique la taille, en octets, de la mémoire tampon, qui doit être >= sizeof(GETVERSIONINPARAMS).

  • Paramètres de sortie

    Le pilote retourne les informations à la mémoire tampon sur Irp->AssociatedIrp.SystemBuffer.

  • Bloc d’état d’E/S

    Le pilote définit le champ Informations sur sizeof(GETVERSIONINPARAMS) lorsqu’il définit le champ Status sur STATUS_SUCCESS. Sinon, le pilote définit le champ Informations sur zéro et définit le champ État sur STATUS_INVALID_PARAMETER éventuellement.

Exigences

Exigence Valeur
client minimum pris en charge Windows 2000
d’en-tête ntdddisk.h (include Ntdddisk.h)