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