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

Статья
08/07/2023

Создает объект контекста таймера 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 с помощью StorPortInitializeTimer можно создать не более 4 таймеров. Начиная с Windows 8 ограничение максимального таймера отсутствует.

Требования

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

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

Share via