GETVERSIONINPARAMS, structure (ntdddisk.h)
La structure GETVERSIONINPARAMS est utilisée conjointement avec la demande SMART_GET_VERSION pour récupérer des 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 |
---|---|
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 master sur le canal principal. |
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. |
Bit 2 est défini sur 1. | L’appareil est un lecteur IDE et il s’agit de l’appareil master sur le canal secondaire. |
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. |
Bit 4 est défini sur 1. | L’appareil est un lecteur ATAPI et il s’agit de l’appareil master sur le canal principal. |
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. |
Bit 6 est défini sur 1. | L’appareil est un lecteur ATAPI, et il s’agit de l’appareil master sur le canal secondaire. |
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 de pilote.
Indicateurs bitmap | Signification |
---|---|
CAP_ATA_ID_CMD | L’appareil prend en charge la commande ATA ID. |
CAP_ATAPI_ID_CMD | L’appareil prend en charge la commande ATAPI ID. |
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 des 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 technologie d’analyse et 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 à l’adresse Irp-AssociatedIrp.SystemBuffer>.
Bloc d’état E/S
Le pilote définit le champ Information 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 éventuellement STATUS_INVALID_PARAMETER.
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Windows 2000 |
En-tête | ntdddisk.h (incluez Ntdddisk.h) |