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

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

Синтаксис

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 драйвера miniport. Для хранения состояния между вызовами 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 (include Storport.h)
Библиотека Storport.lib

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

HW_INITIALIZATION_DATA

HwStorFindAdapter