Поделиться через


функция обратного вызова 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)

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

HwScsiFindAdapter

HwStorFindAdapter