Função StorPortLogError (storport.h)

  • Artigo

A rotina StorPortLogError notifica o driver de porta de que ocorreu um erro.

Sintaxe

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

Um ponteiro para a extensão do dispositivo de hardware. Essa é uma área de armazenamento por HBA que o driver de porta aloca e inicializa em nome do driver de miniporta. Os drivers de miniporta geralmente armazenam informações específicas do HBA nessa extensão, como o estado do HBA e os intervalos de acesso mapeados para o HBA. Essa área está disponível para o miniporto imediatamente após o driver de miniporto chamar StorPortInitialize. O driver de porta libera essa memória quando remove o dispositivo.

[in, optional] Srb

Ponteiro para um bloco de solicitação SCSI se um estiver associado ao erro. Caso contrário, esse parâmetro será NULL.

[in] PathId

Identifica o barramento SCSI.

[in] TargetId

Identifica o controlador de destino ou o dispositivo no barramento.

[in] Lun

Identifica o número da unidade lógica do dispositivo de destino.

[in] ErrorCode

Especifica um código de erro que indica um dos valores a seguir como o tipo de erro.

Valor Significado
SP_BAD_FW_ERROR Indica que o driver detectou firmware inválido ou antigo. O dispositivo não será usado.
SP_BAD_FW_WARNING Indica que o driver detectou um cartão com firmware antigo ou inválido, o que pode resultar em desempenho ou funcionalidade reduzidos.
SP_BUS_PARITY_ERROR Indica que um erro de paridade de barramento SCSI foi detectado.
SP_BUS_TIME_OUT Indica que uma conexão de barramento SCSI com uma unidade lógica atingiu o tempo limite.
SP_INTERNAL_ADAPTER_ERROR Indica que um erro interno do HBA foi detectado.
SP_INVALID_RESELECTION Indica uma unidade lógica reeleita inesperadamente ou com uma marca de fila inválida.
SP_IRQ_NOT_RESPONDING Indica que o HBA não está interrompendo quando esperado.
SP_PROTOCOL_ERROR Indica que o driver de miniporta detectou um erro de protocolo de barramento SCSI.
SP_REQUEST_TIMEOUT Indica que uma operação para o controlador atingiu o tempo limite.
SP_UNEXPECTED_DISCONNECT Indica que um destino foi desconectado inesperadamente.

[in] UniqueId

Especifica um identificador exclusivo para o erro. Esse valor diferencia o erro atual de outros erros com o mesmo valor ErrorCode . Para alguns drivers de miniporta, isso identifica a linha de código em que o erro foi detectado. Para outros, são informações adicionais retornadas pelo HBA.

Retornar valor

Nenhum

Comentários

O driver de porta registrará um erro no log de eventos do sistema.

Começando no Windows 8, o parâmetro Srb pode apontar para SCSI_REQUEST_BLOCK ou STORAGE_REQUEST_BLOCK. Se o identificador de função no campo Função de Srb for SRB_FUNCTION_STORAGE_REQUEST_BLOCK, o SRB será uma estrutura de solicitação STORAGE_REQUEST_BLOCK .

Requisitos

Requisito Valor
Plataforma de Destino Universal
Cabeçalho storport.h (inclua Storport.h)
Biblioteca Storport.lib
Regras de conformidade da DDI StorPortDeprecated(storport)

Confira também

SCSI_REQUEST_BLOCK

STORAGE_REQUEST_BLOCK

ScsiPortLogError

StorPortLogSystemEvent