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

Статья
02/07/2025

Планирует событие обратного вызова для объекта контекста таймера Storport.

Синтаксис

ULONG StorPortRequestTimer(
  [in]           PVOID        HwDeviceExtension,
  [in]           PVOID        TimerHandle,
  [in]           PHW_TIMER_EX TimerCallback,
  [in, optional] PVOID        CallbackContext,
  [in]           ULONGLONG    TimerValue,
  [in]           ULONGLONG    TolerableDelay
);

Параметры

[in] HwDeviceExtension

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

[in] TimerHandle

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

[in] TimerCallback

Указатель на подпрограмму обратного вызова таймера, предоставляемую минипортом. Ниже приведен прототип, определенный для PHW_TIMER_EX:

typedef
VOID
(*PHW_TIMER_EX) (
  _In_ PVOID  DeviceExtension,
  _In_opt_ PVOID Context
  );

[in, optional] CallbackContext

Указатель на минипорт, предоставленный контекстом обратного вызова таймера.

[in] TimerValue

Значение времени ожидания таймера в микросекундах. Параметр TimerValue значение 0 отменит таймер.

[in] TolerableDelay

Допустимая задержка таймера в микросекундах. Значения менее 32 микросекунд игнорируются и tolerableDelay значение по умолчанию равно 0.

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

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

Возвращаемый код	Описание
STOR_STATUS_INSUFFICIENT_RESOURCES	Недостаточно ресурсов, доступных для отсрочки планирования таймера.
STOR_STATUS_INVALID_PARAMETER	HwDeviceExtension, TimerHandleили TimerCallback имеет значение NULL. Недопустимый объект контекста таймера TimerHandle.
STOR_STATUS_BUSY	Предыдущий запрос таймера активен. TimerValue > 0 и TimerCallback не вызывается.
STOR_STATUS_SUCCESS	Запрос таймера успешно запланирован.

Замечания

Процедура StorPortRequestTimer вызывается в любом IRQL. Однако если подпрограмма вызывается при > DISPATCH_LEVEL IRQL, планирование таймера откладывается до <IRQL = DISPATCH_LEVEL.

Требования

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

См. также

HwStorTimer

StorPortFreeTimer

StorPortInitializeTimer

StorPortNotification

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