Функция StorPortInitializeTimer (storport.h)
Создает объект контекста таймера Storport.
Синтаксис
ULONG StorPortInitializeTimer(
[in] PVOID HwDeviceExtension,
[out] PVOID *TimerHandle
);
Параметры
[in] HwDeviceExtension
Указатель на расширение аппаратного устройства для адаптера шины узла (HBA).
[out] TimerHandle
Указатель на непрозрачный буфер, содержащий сведения о контексте таймера.
Возвращаемое значение
Подпрограмма StorPortInitializeTimer возвращает один из следующих кодов состояния:
| Код возврата | Описание |
|---|---|
|
Текущая > DISPATCH_LEVEL IRQL. |
|
HwDeviceExtension или TimerHandle имеет значение NULL. |
|
Недостаточно ресурсов для инициализации контекста таймера. |
|
Контекст таймера успешно инициализирован. |
|
Превышено количество поддерживаемых таймеров. |
Комментарии
Storport предоставляет драйверу мини-порта один таймер с помощью типа уведомления RequestTimerCall в StorPortNotification. Если для мини-порта требуется несколько таймеров, с помощью StorPortInitializeTimer создаются дополнительные таймеры.
Рекомендуется, чтобы минипорты вызывали StorPortInitializeTimer в функции HwStorFindAdapter , чтобы обеспечить доступность дополнительных ресурсов таймера.
Минипорты могут использовать эту подпрограмму для установки таймеров объединения для создания периода задержки после первоначального тайм-аута.
До Windows 8 с помощью StorPortInitializeTimer можно создать не более 4 таймеров. Начиная с Windows 8 ограничение максимального таймера отсутствует.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно в Windows 8 и более поздних версиях Windows. |
| Целевая платформа | Универсальное |
| Верхняя часть | storport.h (включая Storport.h) |
| IRQL | <= DISPATCH_LEVEL |