Функция ScsiPortInitialize (srb.h)

  • Статья

Для драйвера мини-порта, не являющегося Plug and Play, подпрограмма ScsiPortInitialize настраивает структуру PORT_CONFIGURATION_INFORMATION и вызывает подпрограмму HwScsiFindAdapter драйвера miniport. ScsiPortInitialize также настраивает системные объекты и ресурсы от имени драйверов мини-порта. Для драйвера Plug and Play минипорта ScsiPortInitialize сохраняет данные инициализации драйвера минипорта для дальнейшего использования.

Примечание В будущем модели драйвера портов SCSI и драйвера для минипорта SCSI могут быть изменены или недоступны. Вместо этого рекомендуется использовать модели драйверов Storport и драйверов для мини-портов Storport .
 

Синтаксис

SCSIPORT_API ULONG ScsiPortInitialize(
  [in] PVOID                   Argument1,
  [in] PVOID                   Argument2,
  [in] _HW_INITIALIZATION_DATA *HwInitializationData,
  [in] PVOID                   HwContext
);

Параметры

[in] Argument1

Указатель на объект драйвера, который операционная система передала драйверу miniport в первом аргументе процедуры DriverEntry .

[in] Argument2

Указатель на некоторые контекстные сведения, которые операционная система передала драйверу miniport во втором аргументе driverEntry.

[in] HwInitializationData

Указатель на сведения об инициализации и конфигурации, предоставляемые DriverEntry.

[in] HwContext

Указывает адрес значения контекста, передаваемого в подпрограмму HwScsiFindAdapter драйвера мини-порта. Использовать этот параметр для хранения состояния между вызовами HwScsiFindAdapter могут только устаревшие драйверы минипорта, которые сканируют шину на наличие адаптеров HwScsiFindAdapter, а не получают сведения о конфигурации от драйвера порта.

Возвращаемое значение

ScsiPortInitialize возвращает значение состояния, которое используется в качестве возвращаемого значения из подпрограммы DriverEntry драйвера мини-порта.

Комментарии

Подпрограмма DriverEntry каждого драйвера минипорта должна вызывать ScsiPortInitialize после того, как драйвер мини-порта сначала обнуляется, а затем настраивает HW_INITIALIZATION_DATA.

Если драйвер минипорта может поддерживать адаптеры HBA для различных типов шин ввода-вывода, таких как шины ввода-вывода типа Isa и MicroChannel , драйвер минипорта должен вызывать ScsiPortInitialize для каждого поддерживаемого типа интерфейса.

Драйвер мини-порта, который вызывает ScsiPortInitialize более одного раза, должен проверка значение, возвращаемое ScsiPortInitialize при каждом вызове, и сохранять наименьшее значение для всех вызовов. Подпрограмма DriverEntry должна возвращать наименьшее значение при возврате управления в систему. Модули записи драйверов мини-порта не могут делать никаких предположений о значениях, возвращаемых ScsiPortInitialize.

Требования

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

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

DriverEntry of SCSI Miniport Driver

HW_INITIALIZATION_DATA (SCSI)

HwScsiFindAdapter