PHW_FIND_ADAPTER Rückruffunktion (srb.h)
Der PHW_FIND_ADAPTER Prototyps deklariert eine Routine, die die angegebene Konfiguration verwendet, um zu bestimmen, ob ein bestimmter HBA unterstützt wird, und, wenn dies der Grund ist, 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
Zeiger auf den HBA-Speicherbereich des Miniporttreibers.
[in] HwContext
Reservierter Member, wenn es von einem der Miniporttreiber des Storport-Treibers verwendet wird. Bei SCSI-Miniporttreibern zeigt dieses Element auf einen Kontextwert. Eine Beschreibung der Bedeutung dieses Members für einen SCSI-Miniporttreiber finden Sie unter HwScsiFindAdapter.
[in] BusInformation
Reservierter Member, wenn es von einem der Miniporttreiber des Storport-Treibers verwendet wird. Bei SCSI-Miniporttreibern verweist dieses Mitglied auf bustypspezifische Informationen, die der betriebssystemspezifische Porttreiber erfasst hat. Eine vollständige Beschreibung der Bedeutung dieses Members für einen SCSI-Miniporttreiber finden Sie unter HwScsiFindAdapter.
[in] ArgumentString
Reservierter Member, wenn es von einem der Miniporttreiber des Storport-Treibers verwendet wird. Bei SCSI-Miniporttreibern verweist dieser Member auf eine ASCII-Zeichenfolge mit Null-Beendigung, die Geräteinformationen wie einen Basisparameter oder eine Interruptebene aus der Registrierung enthält. Eine vollständige Beschreibung der Bedeutung dieses Members für einen SCSI-Miniporttreiber finden Sie unter HwScsiFindAdapter.
[in, out] ConfigInfo
Zeiger auf eine PORT_CONFIGURATION_INFORMATION-Struktur , die Konfigurationsinformationen für den HBA enthält.
[out] Again
Reservierter Member, wenn es von einem der Miniporttreiber des Storport-Treibers verwendet wird. Bei SCSI-Miniporttreibern verweist dieser Member auf eine BOOLEAN-Variable, die den Porttreiber informiert, ob diese Routine erneut aufgerufen werden soll. Weitere Informationen zur Bedeutung dieses Members für einen SCSI-Miniporttreiber finden Sie unter HwScsiFindAdapter.
Rückgabewert
Die von diesem Prototyp deklarierte Routine muss einen der folgenden status Werte zurückgeben:
| Rückgabecode | Beschreibung |
|---|---|
| SP_RETURN_FOUND | Gibt an, dass ein unterstützter 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 ein HBA gefunden wurde, aber fehler beim Abrufen der Konfigurationsinformationen aufgetreten ist. Wenn möglich, sollte ein solcher Fehler mit ScsiPortLogError protokolliert werden. |
| SP_RETURN_BAD_CONFIG | Gibt an, dass die angegebenen Konfigurationsinformationen für den Adapter ungültig waren. |
| SP_RETURN_NOT_FOUND | Gibt an, dass für die bereitgestellten Konfigurationsinformationen kein unterstützter HBA gefunden wurde. |
Hinweise
Diese Deklaration wird von SCSI- und StorPort-Miniporttreibern verwendet.
Weitere Informationen zur Version der dieser Deklaration zugeordneten Routine des SCSI-Miniporttreibers finden Sie unter HwScsiFindAdapter.
Weitere Informationen zur Version der dieser Deklaration zugeordneten Routine des Storport-Treibers finden Sie unter HwStorFindAdapter.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | srb.h (einschließlich Storport.h, Srb.h, Storport.h) |