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) |