Функция 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 miniports.

[in] HwInitializationData

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

[in, optional] HwContext

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

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

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

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

Возвращаемый код	Описание
STATUS_INVALID_PARAMETER	Аргумент1 имеет значение NULL или Argument2 имеет значение 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