PHW_FIND_ADAPTER Rückruffunktion (srb.h)
Der PHW_FIND_ADAPTER Prototyp deklariert eine Routine, die die bereitgestellte Konfiguration verwendet, um zu bestimmen, ob ein bestimmter HBA unterstützt wird und falls ja, Konfigurationsinformationen zu diesem Adapter zurückzugeben.
Syntax
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
)
{...}
Parameter
[in] DeviceExtension
Zeigen Sie auf den Speicherbereich des Miniporttreibers pro HBA.
[in] HwContext
Reserviertes Mitglied, wenn er von einem der Storport-Treiber-Miniporttreiber verwendet wird. Bei SCSI-Miniporttreibern verweist dieses Element auf einen Kontextwert. Eine Beschreibung der Bedeutung dieses Elements für einen SCSI-Miniporttreiber finden Sie unter HwScsiFindAdapter.
[in] BusInformation
Reserviertes Mitglied, wenn er von einem der Storport-Treiber-Miniporttreiber verwendet wird. Bei SCSI-Miniporttreibern verweist dieses Mitglied auf bustypspezifische Informationen, die der betriebssystemspezifische Porttreiber gesammelt hat. Eine vollständige Beschreibung der Bedeutung dieses Elements für einen SCSI-Miniporttreiber finden Sie unter HwScsiFindAdapter.
[in] ArgumentString
Reserviertes Mitglied, wenn er von einem der Storport-Treiber-Miniporttreiber verwendet wird. Bei SCSI-Miniporttreibern verweist dieses Element auf eine MIT NULL beendete ASCII-Zeichenfolge, die Geräteinformationen wie einen Basisparameter oder eine Unterbrechungsebene aus der Registrierung enthält. Eine vollständige Beschreibung der Bedeutung dieses Elements für einen SCSI-Miniporttreiber finden Sie unter HwScsiFindAdapter.
[in, out] ConfigInfo
Zeigen Sie auf eine PORT_CONFIGURATION_INFORMATION-Struktur, die Konfigurationsinformationen für die HBA enthält.
[out] Again
Reserviertes Mitglied, wenn er von einem der Storport-Treiber-Miniporttreiber verwendet wird. Bei SCSI-Miniporttreibern verweist dieses Element auf eine BOOLEAN-Variable, die den Porttreiber darüber informiert, ob diese Routine erneut aufgerufen werden soll. Weitere Informationen zur Bedeutung dieses Elements für einen SCSI-Miniporttreiber finden Sie unter HwScsiFindAdapter.
Rückgabewert
Die von diesem Prototyp deklarierte Routine muss einen der folgenden Statuswerte zurückgeben:
| Rückgabecode | Beschreibung |
|---|---|
| SP_RETURN_FOUND | Gibt an, dass eine unterstützte HBA gefunden wurde und dass die HBA-relevanten Konfigurationsinformationen erfolgreich ermittelt und in der PORT_CONFIGURATION_INFORMATION Struktur festgelegt wurden. |
| SP_RETURN_ERROR | Gibt an, dass eine HBA gefunden wurde, aber fehler beim Abrufen der Konfigurationsinformationen. Wenn möglich, sollte ein solcher Fehler mit ScsiPortLogError-protokolliert werden. |
| SP_RETURN_BAD_CONFIG | Gibt an, dass die bereitgestellten Konfigurationsinformationen für den Adapter ungültig waren. |
| SP_RETURN_NOT_FOUND | Gibt an, dass für die bereitgestellten Konfigurationsinformationen keine unterstützte HBA gefunden wurde. |
Bemerkungen
Diese Deklaration wird sowohl von SCSI- als auch storPort-Miniporttreibern verwendet.
Weitere Informationen zur Version des SCSI-Miniporttreibers der dieser Deklaration zugeordneten Routine finden Sie unter HwScsiFindAdapter.
Weitere Informationen zur Storport-Treiberversion der dieser Deklaration zugeordneten Routine finden Sie unter HwStorFindAdapter.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Desktop |
| Header- | srb.h (include Storport.h, Srb.h, Storport.h) |