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


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

Создает объект контекста таймера 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

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

HwStorFindAdapter

StorPortFreeTimer

StorPortNotification

StorPortRequestTimer