PHW_FIND_ADAPTER función de devolución de llamada (srb.h)

El PHW_FIND_ADAPTER prototipo declara una rutina que usa la configuración proporcionada para determinar si se admite un HBA específico y, si es así, devolver información de configuración sobre ese adaptador.

Sintaxis

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

Puntero al área de almacenamiento del controlador de miniporte por HBA.

[in] HwContext

Miembro reservado cuando lo usa uno de los controladores de minipuerto del controlador storport. Con los controladores de miniporte SCSI, este miembro apunta a un valor de contexto. Para obtener una descripción del significado de este miembro para un controlador de miniporte SCSI, consulte HwScsiFindAdapter.

[in] BusInformation

Miembro reservado cuando lo usa uno de los controladores de minipuerto del controlador storport. Con los controladores de miniporte SCSI, este miembro apunta a información específica del tipo de bus que ha recopilado el controlador de puerto específico del sistema operativo. Para obtener una descripción completa del significado de este miembro para un controlador de miniporte SCSI, consulte HwScsiFindAdapter.

[in] ArgumentString

Miembro reservado cuando lo usa uno de los controladores de minipuerto del controlador storport. Con los controladores de miniporte SCSI, este miembro apunta a una cadena ASCII terminada en null que contiene información del dispositivo, como un parámetro base o un nivel de interrupción del registro. Para obtener una descripción completa del significado de este miembro para un controlador de miniporte SCSI, consulte HwScsiFindAdapter.

[in, out] ConfigInfo

Puntero a una estructura de PORT_CONFIGURATION_INFORMATION que contiene información de configuración para el HBA.

[out] Again

Miembro reservado cuando lo usa uno de los controladores de minipuerto del controlador storport. Con los controladores de miniporte SCSI, este miembro apunta a una variable BOOLEAN que informa al controlador de puerto de si debe llamar a esta rutina de nuevo. Para obtener más información sobre el significado de este miembro para un controlador de miniporte SCSI, consulte HwScsiFindAdapter.

Valor devuelto

La rutina declarada por este prototipo debe devolver uno de los siguientes valores de estado:

Código devuelto	Descripción
SP_RETURN_FOUND	Indica que se encontró un HBA admitido y que la información de configuración pertinente para HBA se determinó correctamente y se estableció en la estructura de PORT_CONFIGURATION_INFORMATION.
SP_RETURN_ERROR	Indica que se encontró un HBA, pero se produjo un error al obtener la información de configuración. Si es posible, este error debe registrarse con ScsiPortLogError.
SP_RETURN_BAD_CONFIG	Indica que la información de configuración proporcionada no era válida para el adaptador.
SP_RETURN_NOT_FOUND	Indica que no se encontró ningún HBA admitido para la información de configuración proporcionada.

Comentarios

Esta declaración la usan los controladores de miniport SCSI y StorPort.

Para obtener más información sobre la versión del controlador de miniporte SCSI de la rutina asociada a esta declaración, consulte HwScsiFindAdapter.

Para obtener más información sobre la versión del controlador storport de la rutina asociada a esta declaración, consulte HwStorFindAdapter.

Requisitos

Requisito	Value
Plataforma de destino	Escritorio
Encabezado	srb.h (incluya Storport.h, Srb.h, Storport.h)

Consulte también

HwScsiFindAdapter

HwStorFindAdapter