PHW_FIND_ADAPTER fonction de rappel (srb.h)
Le prototype PHW_FIND_ADAPTER déclare une routine qui utilise la configuration fournie pour déterminer si un HBA spécifique est pris en charge et, le cas échéant, pour retourner des informations de configuration sur cet adaptateur.
Syntaxe
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
)
{...}
Paramètres
[in] DeviceExtension
Pointeur vers la zone de stockage par HBA du pilote miniport.
[in] HwContext
Membre réservé lorsqu’il est utilisé par l’un des pilotes miniport du pilote Storport. Avec les pilotes miniport SCSI, ce membre pointe vers une valeur de contexte. Pour obtenir une description de la signification de ce membre pour un pilote miniport SCSI, consultez HwScsiFindAdapter.
[in] BusInformation
Membre réservé lorsqu’il est utilisé par l’un des pilotes miniport du pilote Storport. Avec les pilotes miniport SCSI, ce membre pointe vers des informations spécifiques au type de bus que le pilote de port spécifique au système d’exploitation a collectées. Pour obtenir une description complète de la signification de ce membre pour un pilote miniport SCSI, consultez HwScsiFindAdapter.
[in] ArgumentString
Membre réservé lorsqu’il est utilisé par l’un des pilotes miniport du pilote Storport. Avec les pilotes miniport SCSI, ce membre pointe vers une chaîne ASCII terminée par null qui contient des informations sur l’appareil telles qu’un paramètre de base ou un niveau d’interruption du Registre. Pour obtenir une description complète de la signification de ce membre pour un pilote miniport SCSI, consultez HwScsiFindAdapter.
[in, out] ConfigInfo
Pointeur vers une structure PORT_CONFIGURATION_INFORMATION qui contient des informations de configuration pour l’adaptateur HBA.
[out] Again
Membre réservé lorsqu’il est utilisé par l’un des pilotes miniport du pilote Storport. Avec les pilotes miniport SCSI, ce membre pointe vers une variable BOOLEAN qui indique au pilote de port s’il doit appeler à nouveau cette routine. Pour plus d’informations sur la signification de ce membre pour un pilote miniport SCSI, consultez HwScsiFindAdapter.
Valeur retournée
La routine déclarée par ce prototype doit retourner l’une des valeurs de status suivantes :
| Code de retour | Description |
|---|---|
| SP_RETURN_FOUND | Indique qu’un HBA pris en charge a été trouvé et que les informations de configuration pertinentes pour HBA ont été correctement déterminées et définies dans la structure PORT_CONFIGURATION_INFORMATION. |
| SP_RETURN_ERROR | Indique qu’un HBA a été trouvé, mais qu’une erreur s’est produite lors de l’obtention des informations de configuration. Si possible, une telle erreur doit être enregistrée avec ScsiPortLogError. |
| SP_RETURN_BAD_CONFIG | Indique que les informations de configuration fournies n’étaient pas valides pour l’adaptateur. |
| SP_RETURN_NOT_FOUND | Indique qu’aucun HBA pris en charge n’a été trouvé pour les informations de configuration fournies. |
Remarques
Cette déclaration est utilisée par les pilotes miniport SCSI et StorPort.
Pour plus d’informations sur la version du pilote miniport SCSI de la routine associée à cette déclaration, consultez HwScsiFindAdapter.
Pour plus d’informations sur la version du pilote Storport de la routine associée à cette déclaration, consultez HwStorFindAdapter.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | srb.h (inclure Storport.h, Srb.h, Storport.h) |