PHW_FIND_ADAPTER Rückruffunktion (srb.h)

  • Artikel

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)

Weitere Informationen

HwScsiFindAdapter

HwStorFindAdapter