функция обратного вызова PHW_FIND_ADAPTER (srb.h)
Прототип PHW_FIND_ADAPTER объявляет подпрограмму, которая использует предоставленную конфигурацию, чтобы определить, поддерживается ли конкретный адаптер HBA, и, если это так, для возврата сведений о конфигурации этого адаптера.
Синтаксис
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
)
{...}
Параметры
[in] DeviceExtension
Указатель на область хранения драйвера мини-порта на единицу шины.
[in] HwContext
Зарезервированный член при использовании одним из драйверов минипорта драйвера Storport. При использовании драйверов SCSI miniport этот элемент указывает на значение контекста. Описание значения этого элемента для драйвера мини-порта SCSI см. в разделе HwScsiFindAdapter.
[in] BusInformation
Зарезервированный член при использовании одним из драйверов минипорта драйвера Storport. При использовании драйверов SCSI miniport этот член указывает на сведения, относящиеся к типу шины, собранные драйвером портов операционной системы. Полное описание значения этого элемента для драйвера мини-порта SCSI см. в разделе HwScsiFindAdapter.
[in] ArgumentString
Зарезервированный член при использовании одним из драйверов минипорта драйвера Storport. При использовании драйверов SCSI miniport этот элемент указывает на строку ASCII, завершающуюся null, которая содержит сведения об устройстве, такие как базовый параметр или уровень прерывания из реестра. Полное описание значения этого элемента для драйвера мини-порта SCSI см. в разделе HwScsiFindAdapter.
[in, out] ConfigInfo
Указатель на структуру PORT_CONFIGURATION_INFORMATION , которая содержит сведения о конфигурации для HBA.
[out] Again
Зарезервированный член при использовании одним из драйверов минипорта драйвера Storport. При использовании драйверов SCSI miniport этот элемент указывает на переменную BOOLEAN, которая сообщает драйверу порта, следует ли снова вызывать эту подпрограмму. Дополнительные сведения о значении этого элемента для драйвера мини-порта SCSI см. в разделе HwScsiFindAdapter.
Возвращаемое значение
Подпрограмма, объявленная этим прототипом, должна возвращать одно из следующих значений состояния:
| Код возврата | Описание |
|---|---|
| SP_RETURN_FOUND | Указывает, что обнаружен поддерживаемый адаптер HBA и что сведения о конфигурации, относящиеся к HBA, были успешно определены и заданы в структуре PORT_CONFIGURATION_INFORMATION. |
| SP_RETURN_ERROR | Указывает, что HBA был найден, но при получении сведений о конфигурации произошла ошибка. По возможности такая ошибка должна быть зарегистрирована с помощью ScsiPortLogError. |
| SP_RETURN_BAD_CONFIG | Указывает, что предоставленные сведения о конфигурации были недопустимыми для адаптера. |
| SP_RETURN_NOT_FOUND | Указывает, что для предоставленных сведений о конфигурации не найдено поддерживаемое HBA. |
Комментарии
Это объявление используется драйверами мини-портов SCSI и StorPort.
Дополнительные сведения о версии подпрограммы драйвера минипорта SCSI, связанной с этим объявлением, см. в разделе HwScsiFindAdapter.
Дополнительные сведения о версии подпрограммы драйвера Storport, связанной с этим объявлением, см. в разделе HwStorFindAdapter.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Персональный компьютер |
| Верхняя часть | srb.h (включая Storport.h, Srb.h, Storport.h) |