Compartilhar via


PHW_FIND_ADAPTER função de retorno de chamada (srb.h)

O protótipo PHW_FIND_ADAPTER declara uma rotina que usa a configuração fornecida para determinar se há suporte para um HBA específico e, se for, para retornar informações de configuração sobre esse adaptador.

Sintaxe

PHW_FIND_ADAPTER PhwFindAdapter;

ULONG PhwFindAdapter(
  [in]      PVOID DeviceExtension,
  [in]      PVOID HwContext,
  [in]      PVOID BusInformation,
  [in]      PCHAR ArgumentString,
  [in, out] PPORT_CONFIGURATION_INFORMATION ConfigInfo,
  [out]     PBOOLEAN Again
)
{...}

Parâmetros

[in] DeviceExtension

Ponteiro para a área de armazenamento por HBA do driver de miniporto.

[in] HwContext

Membro reservado quando usado por um dos drivers de miniporto do driver Storport. Com os drivers de miniport scsi, esse membro aponta para um valor de contexto. Para obter uma descrição do significado desse membro para um driver de miniporto SCSI, consulte HwScsiFindAdapter.

[in] BusInformation

Membro reservado quando usado por um dos drivers de miniporto do driver Storport. Com os drivers de miniporto SCSI, esse membro aponta para informações específicas do tipo de ônibus que o driver de porta específico do sistema operacional reuniu. Para obter uma descrição completa do significado desse membro para um driver de miniporto SCSI, consulte HwScsiFindAdapter.

[in] ArgumentString

Membro reservado quando usado por um dos drivers de miniporto do driver Storport. Com os drivers de miniport scsi, esse membro aponta para uma cadeia de caracteres ASCII terminada em nulo que contém informações do dispositivo, como um parâmetro base ou um nível de interrupção do registro. Para obter uma descrição completa do significado desse membro para um driver de miniporto SCSI, consulte HwScsiFindAdapter.

[in, out] ConfigInfo

Ponteiro para uma estrutura de PORT_CONFIGURATION_INFORMATION que contém informações de configuração para o HBA.

[out] Again

Membro reservado quando usado por um dos drivers de miniporto do driver Storport. Com os drivers de miniport scsi, esse membro aponta para uma variável BOOLEAN que informa ao driver de porta se ele deve chamar essa rotina novamente. Para obter mais informações sobre o significado desse membro para um driver de miniporto SCSI, consulte HwScsiFindAdapter.

Valor de retorno

A rotina declarada por este protótipo deve retornar um dos seguintes valores de status:

Código de retorno Descrição
SP_RETURN_FOUND Indica que um HBA com suporte foi encontrado e que as informações de configuração relevantes ao HBA foram determinadas e definidas com êxito na estrutura PORT_CONFIGURATION_INFORMATION.
SP_RETURN_ERROR Indica que um HBA foi encontrado, mas erro ao obter as informações de configuração. Se possível, esse erro deve ser registrado com ScsiPortLogError.
SP_RETURN_BAD_CONFIG Indica que as informações de configuração fornecidas eram inválidas para o adaptador.
SP_RETURN_NOT_FOUND Indica que nenhum HBA com suporte foi encontrado para as informações de configuração fornecidas.

Observações

Essa declaração é usada por drivers de miniportos SCSI e StorPort.

Para obter mais informações sobre a versão do driver de miniporto SCSI da rotina associada a essa declaração, consulte HwScsiFindAdapter.

Para obter mais informações sobre a versão do driver Storport da rotina associada a essa declaração, consulte HwStorFindAdapter.

Requisitos

Requisito Valor
da Plataforma de Destino Área de trabalho
cabeçalho srb.h (incluem Storport.h, Srb.h, Storport.h)

Consulte também

HwScsiFindAdapter

HwStorFindAdapter