IOCTL_CHANGER_GET_ELEMENT_STATUS IOCTL (ntddchgr.h)

Artículo
08/07/2023

Devuelve el estado de todos los elementos o el estado de un número especificado de elementos de un tipo determinado.

Para obtener una descripción de los posibles tipos de elementos, vea CHANGER_ELEMENT.

Código principal

Búfer de entrada

El búfer de Irp-AssociatedIrp.SystemBuffer> contiene los datos CHANGER_READ_ELEMENT_STATUS que indican el tipo de elemento y el número de elementos para los que se va a devolver el estado.

Si el autor de la llamada establece el miembro VolumeTagInfo de CHANGER_READ_ELEMENT_STATUS en TRUE, el estado del elemento devuelto incluirá información de etiqueta de volumen.

Longitud del búfer de entrada

Parameters.DeviceIoControl.InputBufferLength en la ubicación de la pila de E/S indica el tamaño, en bytes, del búfer de parámetros para la entrada, que debe ser >= sizeof(CHANGER_READ_ELEMENT_STATUS).

Búfer de salida

El controlador de miniclase del modificador devuelve los datos de estado del elemento changer en el búfer en Irp-AssociatedIrp.SystemBuffer>. Algunos elementos del tipo ChangerDrive devuelven datos de información del producto. Si el dispositivo proporciona información del producto, el controlador de miniclase notificará los datos de estado del elemento en una estructura de tipo CHANGER_ELEMENT_STATUS_EX. El controlador de miniclase establece ELEMENT_STATUS_PRODUCT_DATA en el miembro Flags de la estructura para indicar que contiene datos de información del producto. Para los elementos de todos los tipos distintos de ChangerDrive, el controlador notifica los datos de estado del elemento en una estructura de tipo CHANGER_ELEMENT_STATUS.

Longitud del búfer de salida

Parameters.DeviceIoControl.OutputBufferLength indica el tamaño, en bytes, del búfer de parámetros para la salida. Para los elementos de tipo ChangerDrive, este valor debe ser >= NumberOfElements * sizeof(CHANGER_ELEMENT_STATUS_EX). Para los elementos de todos los demás tipos, este valor debe ser >= NumberOfElements * sizeof(CHANGER_ELEMENT_STATUS).

Bloque de estado

El campo Información se establece en el número de bytes devueltos. El campo Estado se establece en STATUS_SUCCESS, o posiblemente en STATUS_BUFFER_TOO_SMALL, STATUS_INFO_LENGTH_MISMATCH, STATUS_INSUFFICIENT_RESOURCES, STATUS_INVALID_ELEMENT_ADDRESS o STATUS_INVALID_PARAMETER.