Estructura GETVERSIONINPARAMS (ntdddisk.h)
La estructura GETVERSIONINPARAMS se usa junto con la solicitud de SMART_GET_VERSION para recuperar información de versión, una máscara de funcionalidad y una máscara de bits para el dispositivo indicado.
Sintaxis
typedef struct _GETVERSIONINPARAMS {
UCHAR bVersion;
UCHAR bRevision;
UCHAR bReserved;
UCHAR bIDEDeviceMap;
ULONG fCapabilities;
ULONG dwReserved[4];
} GETVERSIONINPARAMS, *PGETVERSIONINPARAMS, *LPGETVERSIONINPARAMS;
Miembros
bVersion
Contiene un entero que indica el número de versión del controlador binario.
bRevision
Contiene un entero que indica el número de revisión del controlador binario.
bReserved
Reservado.
bIDEDeviceMap
Contiene el mapa de bits. En la tabla siguiente se explica el significado del mapa de bits:
Marcas de mapa de bits | Significado |
---|---|
El bit 0 se establece en 1. | El dispositivo es una unidad SATA o una unidad IDE. Si es una unidad IDE, es el dispositivo maestro en el canal principal. |
El bit 1 se establece en 1. | El dispositivo es una unidad IDE y es el dispositivo subordinado en el canal principal. |
El bit 2 se establece en 1. | El dispositivo es una unidad IDE y es el dispositivo maestro en el canal secundario. |
El bit 3 se establece en 1. | El dispositivo es una unidad IDE y es el dispositivo subordinado en el canal secundario. |
El bit 4 se establece en 1. | El dispositivo es una unidad ATAPI y es el dispositivo maestro en el canal principal. |
El bit 5 se establece en 1. | El dispositivo es una unidad ATAPI y es el dispositivo subordinado en el canal principal. |
El bit 6 se establece en 1. | El dispositivo es una unidad ATAPI y es el dispositivo maestro en el canal secundario. |
El bit 7 se establece en 1. | El dispositivo es una unidad ATAPI y es el dispositivo subordinado en el canal secundario. |
fCapabilities
Contiene la máscara de bits de las funcionalidades del controlador.
Marcas de mapa de bits | Significado |
---|---|
CAP_ATA_ID_CMD | El dispositivo admite el comando id. de ATA. |
CAP_ATAPI_ID_CMD | El dispositivo admite el comando ATAPI ID. |
CAP_SMART_CMD | El dispositivo admite comandos SMART. |
dwReserved[4]
Reservado.
Observaciones
El código de control SMART_GET_VERSION devuelve información de versión, una máscara de funcionalidades y una máscara de bits para el dispositivo. Este IOCTL debe ser controlado por los controladores que admiten Self-Monitoring Tecnología de análisis e informes (SMART).
Parámetros de entrada
Parameters.DeviceIoControl.OutputBufferLength indica el tamaño, en bytes, del búfer, que debe ser >= sizeof(GETVERSIONINPARAMS).
Parámetros de salida
El controlador devuelve la información al búfer en Irp->AssociatedIrp.SystemBuffer.
Bloque de estado de E/S
El controlador establece el campo Información en sizeof(GETVERSIONINPARAMS) cuando establece el campo Estado en STATUS_SUCCESS. De lo contrario, el controlador establece el campo Información en cero y establece el campo Estado en posiblemente STATUS_INVALID_PARAMETER.
Requisitos
Requisito | Valor |
---|---|
cliente mínimo admitido | Windows 2000 |
encabezado de | ntdddisk.h (incluya Ntdddisk.h) |