PHW_FIND_ADAPTER funzione di callback (srb.h)
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) |