PHW_FIND_ADAPTER funzione di callback (srb.h)

  • Articolo

Il prototipo PHW_FIND_ADAPTER dichiara una routine che usa la configurazione fornita per determinare se è supportato un hbA specifico e, se è, per restituire informazioni di configurazione su tale scheda.

Sintassi

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
)
{...}

Parametri

[in] DeviceExtension

Puntatore all'area di archiviazione per-HBA del driver miniport.

[in] HwContext

Membro riservato quando usato da uno dei driver miniport storport. Con i driver miniport SCSI questo membro punta a un valore di contesto. Per una descrizione del significato di questo membro per un driver miniport SCSI, vedere HwSCSIFindAdapter.

[in] BusInformation

Membro riservato quando usato da uno dei driver miniport storport. Con i driver miniport SCSI questo membro punta a informazioni specifiche del tipo di bus che il driver di porta specifico del sistema operativo ha raccolto. Per una descrizione completa del significato di questo membro per un driver miniport SCSI, vedere HwScsiFindAdapter.

[in] ArgumentString

Membro riservato quando usato da uno dei driver miniport storport. Con i driver miniport SCSI questo membro punta a una stringa ASCII con terminazione null che contiene informazioni sul dispositivo, ad esempio un parametro di base o un livello di interruzione dal Registro di sistema. Per una descrizione completa del significato di questo membro per un driver miniport SCSI, vedere HwScsiFindAdapter.

[in, out] ConfigInfo

Puntatore a una struttura PORT_CONFIGURATION_INFORMATION che contiene informazioni di configurazione per l'HBA.

[out] Again

Membro riservato quando usato da uno dei driver miniport storport. Con i driver miniport SCSI questo membro punta a una variabile BOOLEAN che informa il driver della porta se deve chiamare di nuovo questa routine. Per altre informazioni sul significato di questo membro per un driver miniport SCSI, vedere HwScsiFindAdapter.

Valore restituito

La routine dichiarata da questo prototipo deve restituire uno dei valori di stato seguenti:

Codice restituito Descrizione
SP_RETURN_FOUND Indica che è stato trovato un HBA supportato e che le informazioni di configurazione rilevanti per HBA sono state determinate e impostate nella struttura PORT_CONFIGURATION_INFORMATION.
SP_RETURN_ERROR Indica che è stato trovato un HBA, ma si è verificato un errore durante l'acquisizione delle informazioni di configurazione. Se possibile, tale errore deve essere registrato con SCSIPortLogError.
SP_RETURN_BAD_CONFIG Indica che le informazioni di configurazione fornite non sono valide per l'adapter.
SP_RETURN_NOT_FOUND Indica che non è stato trovato alcun HBA supportato per le informazioni di configurazione fornite.

Commenti

Questa dichiarazione viene usata dai driver miniport SCSI e StorPort.

Per altre informazioni sulla versione del miniport SCSI della routine associata a questa dichiarazione, vedere HwScsiFindAdapter.

Per altre informazioni sulla versione del driver Storport della routine associata a questa dichiarazione, vedere HwStorFindAdapter.

Requisiti

Requisito Valore
Piattaforma di destinazione Desktop
Intestazione srb.h (include Storport.h, Srb.h, Storport.h)

Vedi anche

HwScsiFindAdapter

HwStorFindAdapter