Поделиться через


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

Создает новый рабочий элемент Storport, который выполняется в системном рабочем потоке.

Синтаксис

ULONG StorPortInitializeWorker(
  [in]  PVOID HwDeviceExtension,
  [out] PVOID *Worker
);

Параметры

[in] HwDeviceExtension

Указатель на расширение аппаратного устройства для адаптера шины узла (HBA).

[out] Worker

Указатель на непрозрачный буфер, содержащий сведения о контексте для рабочего элемента.

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

Подпрограмма StorPortInitializeWorker возвращает один из следующих кодов состояния:

Код возврата Описание
STOR_STATUS_INVALID_IRQL
Текущая > DISPATCH_LEVEL IRQL.
STOR_STATUS_INVALID_PARAMETER
HwDeviceExtension или Worker имеет значение NULL.
STOR_STATUS_INSUFFICIENT_RESOURCES
Недостаточно ресурсов для инициализации контекста рабочего элемента.
STOR_STATUS_SUCCESS
Рабочий элемент успешно инициализирован.

Комментарии

Контекст рабочего элемента, возвращаемый в параметре WorkerstorPortInitializeWorker , используется в будущих вызовах StorPortQueueWorkItem или StorPortFreeWorker.

Если мини-порт использует рабочий элемент во время обработки ввода-вывода, рекомендуется вызывать StorPortInitializeWorker во время функции HwStorFindAdapter мини-порта, чтобы обеспечить доступность ресурсов при необходимости.

Требования

Требование Значение
Минимальная версия клиента Доступно в Windows 8 и более поздних версиях Windows.
Целевая платформа Универсальное
Верхняя часть storport.h (включая Storport.h)
IRQL <= DISPATCH_LEVEL

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

HwStorFindAdapter

StorPortFreeWorker

StorPortQueueWorkItem