Función StorPortLogError (storport.h)
La rutina StorPortLogError notifica al controlador de puerto que se produjo un error.
Sintaxis
STORPORT_API VOID StorPortLogError(
[in] PVOID HwDeviceExtension,
[in, optional] PSCSI_REQUEST_BLOCK Srb,
[in] UCHAR PathId,
[in] UCHAR TargetId,
[in] UCHAR Lun,
[in] ULONG ErrorCode,
[in] ULONG UniqueId
);
Parámetros
[in] HwDeviceExtension
Puntero a la extensión de dispositivo de hardware. Se trata de un área de almacenamiento por HBA que el controlador de puerto asigna e inicializa en nombre del controlador de minipuerto. Los controladores de minipuerto suelen almacenar información específica de HBA en esta extensión, como el estado del HBA y los intervalos de acceso asignados para el HBA. Esta área está disponible para el miniporte inmediatamente después de que el controlador de minipuerto llame a StorPortInitialize. El controlador de puerto libera esta memoria cuando quita el dispositivo.
[in, optional] Srb
Puntero a un bloque de solicitud SCSI si uno está asociado al error. De lo contrario, este parámetro es NULL.
[in] PathId
Identifica el bus SCSI.
[in] TargetId
Identifica el controlador de destino o el dispositivo en el bus.
[in] Lun
Identifica el número de unidad lógica del dispositivo de destino.
[in] ErrorCode
Especifica un código de error que indica uno de los siguientes valores como el tipo de error.
| Valor | Significado |
|---|---|
| SP_BAD_FW_ERROR | Indica que el controlador ha detectado un firmware incorrecto o antiguo. El dispositivo no se usará. |
| SP_BAD_FW_WARNING | Indica que el controlador ha detectado una tarjeta con firmware antiguo o incorrecto, lo que puede dar lugar a una reducción del rendimiento o la funcionalidad. |
| SP_BUS_PARITY_ERROR | Indica que se detectó un error de paridad de bus SCSI. |
| SP_BUS_TIME_OUT | Indica una conexión de bus SCSI a una unidad lógica agota el tiempo de espera. |
| SP_INTERNAL_ADAPTER_ERROR | Indica que se ha detectado un error interno de HBA. |
| SP_INVALID_RESELECTION | Indica que una unidad lógica se vuelve a seleccionar inesperadamente o con una etiqueta de cola no válida. |
| SP_IRQ_NOT_RESPONDING | Indica que el HBA no se interrumpe cuando se espera. |
| SP_PROTOCOL_ERROR | Indica que el controlador de miniporte detectó un error de protocolo de bus SCSI. |
| SP_REQUEST_TIMEOUT | Indica que se agota el tiempo de espera de una operación para el controlador. |
| SP_UNEXPECTED_DISCONNECT | Indica que un destino se desconecta inesperadamente. |
[in] UniqueId
Especifica un identificador único para el error. Este valor diferencia el error actual de otros errores con el mismo valor ErrorCode . Para algunos controladores de minipuerto, esto identifica la línea de código donde se detectó el error. Para otros, es información adicional devuelta por el HBA.
Valor devuelto
None
Observaciones
El controlador de puerto registrará un error en el registro de eventos del sistema.
A partir de Windows 8, el parámetro Srb puede apuntar a SCSI_REQUEST_BLOCK o a STORAGE_REQUEST_BLOCK. Si el identificador de función del campo Función de Srb es SRB_FUNCTION_STORAGE_REQUEST_BLOCK, el SRB es una estructura de solicitud STORAGE_REQUEST_BLOCK .
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Encabezado | storport.h (incluya Storport.h) |
| Library | Storport.lib |
| Reglas de cumplimiento de DDI | StorPortDeprecated(storport) |