функция обратного вызова PHW_FIND_ADAPTER (srb.h)

Статья
08/07/2023

Прототип 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.

Требования

Требование	Значение
Целевая платформа	Персональный компьютер
Верхняя часть	srb.h (включая Storport.h, Srb.h, Storport.h)

См. также раздел

HwScsiFindAdapter

HwStorFindAdapter