estructura CHANGER_ELEMENT_STATUS_EX (ntddchgr.h)
La rutina ChangerGetElementStatus devuelve información de estado en esta estructura.
Sintaxis
typedef struct _CHANGER_ELEMENT_STATUS_EX {
CHANGER_ELEMENT Element;
CHANGER_ELEMENT SrcElementAddress;
ULONG Flags;
ULONG ExceptionCode;
UCHAR TargetId;
UCHAR Lun;
USHORT Reserved;
UCHAR PrimaryVolumeID[MAX_VOLUME_ID_SIZE];
UCHAR AlternateVolumeID[MAX_VOLUME_ID_SIZE];
UCHAR VendorIdentification[VENDOR_ID_LENGTH];
UCHAR ProductIdentification[PRODUCT_ID_LENGTH];
UCHAR SerialNumber[SERIAL_NUMBER_LENGTH];
} CHANGER_ELEMENT_STATUS_EX, *PCHANGER_ELEMENT_STATUS_EX;
Miembros
Element
Especifica el elemento de tipo CHANGER_ELEMENT al que hace referencia esta estructura.
SrcElementAddress
Especifica el elemento de tipo CHANGER_ELEMENT desde el que se movió el medio actualmente en este elemento. Este miembro solo es válido si ELEMENT_STATUS_SVALID también se establece en Marcas. Este valor debe ser un desplazamiento de base cero del valor único del dispositivo.
Flags
Indica el estado del elemento , que puede ser uno o varios de los valores siguientes.
ELEMENT_STATUS_FULL
El elemento contiene un fragmento de medio. Esta marca es válida si ElementType en el miembro Element es ChangerDrive, ChangerSlot o ChangerTransport. Si ElementType es ChangerIEPort, esta marca solo es válida si CHANGER_REPORT_IEPORT_STATE también se establece en Características0 de GET_CHANGER_PARAMETERS.
ELEMENT_STATUS_IMPEXP
Un operador colocó allí el medio de este elemento. Esta marca solo es válida si ElementType en el miembro Element es ChangerIEPort.
ELEMENT_STATUS_EXCEPT
El elemento está en un estado anómalo. Consulte el miembro ExceptionCode para obtener más información.
ELEMENT_STATUS_ACCESS
El elemento de transporte del modificador puede tener acceso al elemento multimedia de este elemento. El controlador de miniclase borra esta marca para indicar que el medio no es accesible por uno de los siguientes motivos: Si ElementType en el miembro Element es ChangerSlot, la ranura no está presente en el modificador (por ejemplo, la revista que contiene la ranura se ha quitado físicamente). Si ElementType es ChangerDrive, la unidad se interrumpe o se ha quitado. Si ElementType es ChangerIEPort, se extiende IEport.
ELEMENT_STATUS_EXENAB
El elemento admite la exportación de medios a través del IEport del modificador.
ELEMENT_STATUS_INENAB
El elemento admite la importación de medios a través del IEport del modificador.
ELEMENT_STATUS_LUN_VALID
El número de dispositivo del miembro Lun es válido. Esta marca solo es válida si ElementType en el miembro Element es ChangerDrive.
ELEMENT_STATUS_ID_VALID
El identificador de destino SCSI del miembro TargetID es válido. Esta marca solo es válida si ElementType en el miembro Element es ChangerDrive.
ELEMENT_STATUS_NOT_BUS
La unidad en la dirección indicada por Lun y TargetID está en un bus SCSI diferente que el propio modificador.
ELEMENT_STATUS_PRODUCT_DATA
El número de serie del miembro SerialNumber es válido.
ELEMENT_STATUS_INVERT
El medio del elemento se ha volteado. Esta marca solo es válida si también se establece la marca ELEMENT_STATUS_SVALID.
ELEMENT_STATUS_SVALID
El miembro SourceElement y la marca ELEMENT_STATUS_INVERT son válidos.
ELEMENT_STATUS_PVOLTAG
La información del volumen principal del miembro PrimaryVolumeID es válida.
ELEMENT_STATUS_AVOLTAG
La información alternativa del volumen en el miembro AlternateVolumeID es válida.
ExceptionCode
Indica que el elemento está en un estado anómalo. Este miembro solo es válido si ELEMENT_STATUS_EXCEPT está establecido en Marcas. ExceptionCode se puede establecer en uno de los valores siguientes.
ERROR_LABEL_UNREADABLE
El lector de código de barras del modificador no pudo leer la etiqueta de código de la barra en el elemento multimedia de este elemento, porque falta el medio, está dañado, colocado incorrectamente o al revés.
ERROR_LABEL_QUESTIONABLE
La etiqueta podría no ser válida debido a una condición de atención unitaria.
ERROR_SLOT_NOT_PRESENT
La ranura de esta dirección de elemento no está instalada actualmente en el modificador. Un controlador de miniclase establece este código para cada ranura de una revista extraíble para indicar que se ha quitado la revista.
ERROR_DRIVE_NOT_INSTALLED
La unidad de esta dirección de elemento no está presente. Si un modificador puede seguir funcionando sin la unidad, su controlador de miniclase establece ERROR_DRIVE_NOT_INSTALLED para la unidad.
ERROR_TRAY_MALFUNCTION
La unidad de esta dirección de elemento tiene una bandeja que debe extenderse para cargar o quitar medios, y la bandeja no se extiende según sea necesario.
ERROR_UNHANDLED_ERROR
Condición de error desconocida.
TargetId
Especifica el identificador de destino SCSI de la unidad en esta dirección de elemento para un modificador SCSI. Este miembro solo es válido si ElementType en el miembro Element es ChangerDrive y ELEMENT_STATUS_ID_VALID se establece en Flags.
Lun
Especifica el número de dispositivo SCSI de la unidad en esta dirección de elemento. Este miembro solo es válido si ElementType en el miembro Element es ChangerDrive y ELEMENT_STATUS_LUN_VALID se establece en Flags.
Reserved
Reservado para uso futuro. El valor de este miembro debe ser cero.
PrimaryVolumeID[MAX_VOLUME_ID_SIZE]
Especifica el identificador de volumen principal para el medio. Si el modificador admite un lector de código de barra y el lector se instala (como se indica en CHANGER_BAR_CODE_SCANNER_INSTALLED en Características0 de GET_CHANGER_PARAMETERS), el controlador de miniclase debe establecer PrimaryVolumeID en el código de barra del medio. Si el modificador no admite un lector de código de barras, el controlador de miniclase debe establecer PrimaryVolumeID en el valor asignado previamente al medio mediante la rutina ChangerQueryVolumeTags con una acción ASSERT_PRIMARY o REPLACE_PRIMARY. Este miembro solo es válido si ELEMENT_STATUS_PVOLTAG también se establece en Marcas. Si falta el identificador de volumen o no se puede leer, el controlador de miniclase debe borrar esta marca y establecer el estado de error adecuado. Este identificador no debe ser mayor que MAX_VOLUME_ID_SIZE bytes.
AlternateVolumeID[MAX_VOLUME_ID_SIZE]
Especifica la identificación de volumen alternativa para los medios. Este miembro solo es válido para medios de dos lados y pertenece al identificador del lado invertido. Nunca representa un código de barras. El controlador de miniclase debe establecer AlternateVolumeID en el valor asignado previamente al medio mediante la rutina ChangerQueryVolumeTags con una acción ASSERT_ALTERNATE o REPLACE_ALTERNATE. El identificador no debe ser mayor que MAX_VOLUME_ID_SIZE bytes y solo es válido si ELEMENT_STATUS_AVOLTAG también se establece en Marcas.
VendorIdentification[VENDOR_ID_LENGTH]
Contiene el identificador del proveedor. Este identificador no debe ser mayor que VENDOR_ID_LENGTH bytes.
ProductIdentification[PRODUCT_ID_LENGTH]
Contiene el identificador del producto. Este identificador no debe ser mayor que PRODUCT_ID_LENGTH bytes.
SerialNumber[SERIAL_NUMBER_LENGTH]
Contiene el número de serie. Este identificador no debe ser mayor que SERIAL_NUMBER_LENGTH bytes.
Comentarios
La rutina ChangerGetElementStatus devuelve información de estado en esta estructura si se necesita información de proveedor, producto o número de serie. De lo contrario, ChangerGetElementStatus devuelve información de estado en la estructura CHANGER_ELEMENT_STATUS .
Requisitos
| Requisito | Valor |
|---|---|
| Header | ntddchgr.h |
Consulte también
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de