Функция 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 |
См. также раздел
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе:Отправить и просмотреть отзыв по