Função ScsiPortCompleteRequest (srb.h)

Artigo
02/07/2025

A rotina ScsiPortCompleteRequest completa todas as solicitações ativas para o barramento, controlador ou LU scsi especificado, incluindo uma solicitação que está sendo processada pela rotina de driver de miniporto de chamada.

Observação o driver de porta SCSI e os modelos de driver de miniporto SCSI podem estar alterados ou indisponíveis no futuro. Em vez disso, recomendamos usar o de driver do Storport e miniporto storport modelos de driver.

Sintaxe

SCSIPORT_API VOID ScsiPortCompleteRequest(
  [in] PVOID HwDeviceExtension,
  [in] UCHAR PathId,
  [in] UCHAR TargetId,
  [in] UCHAR Lun,
  [in] UCHAR SrbStatus
);

Parâmetros

[in] HwDeviceExtension

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 miniporto. Os drivers de miniporto geralmente armazenam informações específicas do HBA nessa extensão, como o estado do HBA e os intervalos de acesso mapeados do HBA. Essa área está disponível para o driver de miniporto no DeviceExtension->HwDeviceExtension membro do objeto de dispositivo do HBA imediatamente após o driver de miniporto chamar ScsiPortInitialize. O driver de porta libera essa memória quando remove o dispositivo.

[in] PathId

Identifica o barramento SCSI; SP_UNTAGGED indica todos os ônibus controlados pelo HBA.

[in] TargetId

Identifica o controlador de destino ou o dispositivo nos ônibus determinados; SP_UNTAGGED indica todos os destinos no ônibus.

[in] Lun

Identifica a unidade lógica para o determinado controlador de destino ou dispositivo; SP_UNTAGGED indica todas as unidades lógicas para os controladores de destino determinados nos ônibus determinados.

[in] SrbStatus

Especifica o status de conclusão a ser definido no SrbStatus membro de cada SRB.

Valor de retorno

Nenhum

Observações

ScsiPortCompleteRequest pode ser chamado para concluir solicitações pendentes após uma redefinição de barramento, uma redefinição de dispositivo ou uma anulação, em vez de chamar ScsiPortNotification para cada solicitação pendente individualmente. Depois de chamar ScsiPortCompleteRequest, não chame também ScsiPortNotification.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	srb.h (inclua Miniport.h, Scsi.h)
biblioteca	Scsiport.lib

Consulte também

SCSI_REQUEST_BLOCK

ScsiPortNotification

Partilhar via