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)

Consulte también

SCSI_REQUEST_BLOCK

STORAGE_REQUEST_BLOCK

ScsiPortLogError

StorPortLogSystemEvent