Функция StorPortInitialize (storport.h)

Подпрограмма StorPortInitialize инициализирует параметры драйвера портов и данные расширения. StorPortInitialize также сохраняет сведения об адаптере, предоставленные из подпрограммы DriverEntryдля мини-порта.

Синтаксис

STORPORT_API ULONG StorPortInitialize(
  [in]           PVOID                   Argument1,
  [in]           PVOID                   Argument2,
  [in]           _HW_INITIALIZATION_DATA *HwInitializationData,
  [in, optional] PVOID                   HwContext
);

Параметры

[in] Argument1

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

[in] Argument2

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

[in] HwInitializationData

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

[in, optional] HwContext

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

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

Результат действий инициализации, выполняемых StorPortInitialize. Драйвер мини-порта вернет это значение в качестве возвращаемого значения для своей подпрограммы DriverEntry.

StorPortInitialize возвращает один из следующих кодов состояния:

Код возврата Описание
STATUS_INVALID_PARAMETER Аргумент 1 имеет значение NULL или Аргумент 2 имеет значение NULL, или HwInitializationData имеет значение NULL.
STATUS_SUCCESS Данные расширения драйвера и сведения об адаптере успешно инициализированы.
STATUS_NO_MEMORY Нет доступной памяти для хранения параметра инициализации.
STATUS_REVISION_MISMATCH Версия структуры, на которую указывает HwInitializationData , недопустимая для текущей операционной системы.
STATUS_INSUFFICENT_RESOURCES Не удалось выделить данные расширения объекта драйвера.

Комментарии

Эта подпрограмма должна вызываться из процедуры DriverEntry водителя мини-порта.

Так как драйверы для мини-портов Storport должны поддерживать PnP, драйвер Storport не использует параметр HwContext , передаваемый в StorPortInitialize.

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

Требования

Требование Значение
Целевая платформа Универсальное
Верхняя часть storport.h (включая Storport.h)
Библиотека Storport.lib

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

HW_INITIALIZATION_DATA

HwStorFindAdapter