Função StorPortLogError (storport.h)
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) |