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 um HBA específico tem suporte 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 miniport.

[in] HwContext

Membro reservado quando usado por um dos drivers de miniporto do driver Storport. Com os drivers de miniporto 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 miniporto 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 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 miniporto 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.

Retornar valor

A rotina declarada por esse 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 do HBA foram determinadas com êxito e definidas na estrutura PORT_CONFIGURATION_INFORMATION.
SP_RETURN_ERROR	Indica que um HBA foi encontrado, mas ocorreu um 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.

Comentários

Essa declaração é usada por drivers de miniporta 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
Plataforma de Destino	Área de Trabalho
Cabeçalho	srb.h (inclua Storport.h, Srb.h, Storport.h)

Confira também

HwScsiFindAdapter

HwStorFindAdapter