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

Статья
02/07/2025

Создает объект контекста таймера Storport.

Синтаксис

ULONG StorPortInitializeTimer(
  [in]  PVOID HwDeviceExtension,
  [out] PVOID *TimerHandle
);

Параметры

[in] HwDeviceExtension

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

[out] TimerHandle

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

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

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

Возвращаемый код	Описание
STOR_STATUS_INVALID_IRQL	Текущая > DISPATCH_LEVEL IRQL.
STOR_STATUS_INVALID_PARAMETER	HwDeviceExtension или TimerHandle имеет значение NULL.
STOR_STATUS_INSUFFICIENT_RESOURCES	Недостаточно ресурсов для инициализации контекста таймера.
STOR_STATUS_SUCCESS	Контекст таймера успешно инициализирован.
STOR_STATUS_UNSUCCESSFUL	Превышено количество поддерживаемых таймеров.

Замечания

Storport предоставляет один таймер мини-драйверу с помощью типа уведомлений RequestTimerCall в StorPortNotification. Если для мини-порта требуется несколько таймеров, дополнительные таймеры создаются с StorPortInitializeTimer.

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

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

До Windows 8 можно создать не более 4 таймеров с помощью StorPortInitializeTimer. Начиная с Windows 8, ограничения таймеров отсутствуют.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно в Windows 8 и более поздних версиях Windows.
целевая платформа	Всеобщий
заголовка	storport.h (include Storport.h)
IRQL	<= DISPATCH_LEVEL

См. также

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