Функция PoQueryWatchdogTime (ntifs.h)
Подпрограмма PoQueryWatchdogTime указывает, включен ли диспетчер питания счетчик времени ожидания для любой powerRP, назначенной в данный момент стеку устройств.
Синтаксис
BOOLEAN PoQueryWatchdogTime(
[in] PDEVICE_OBJECT Pdo,
[out] PULONG SecondsRemaining
);
Параметры
[in] Pdo
Указатель на объект физического устройства (PDO). Этот параметр указывает на структуру DEVICE_OBJECT, представляющую физическое устройство.
[out] SecondsRemaining
Указатель на расположение, в которое подпрограмма записывает время( в секундах), которое остается до выполнения следующего тайм-аута питания.
Возвращаемое значение
PoQueryWatchdogTime возвращает значение TRUE, если часы с поддержкой IRP в настоящее время назначены стеку устройств. В противном случае возвращает значение FALSE.
Замечания
Эта подпрограмма позволяет драйверам режима ядра отслеживать счетчики времени ожидания отслеживания, которые диспетчер питания включил для отслеживания выданных параметров irPs питания. Если в настоящее время включен один или несколько счетчиков времени ожидания наблюдателя, подпрограмма возвращает TRUE и предоставляет время, остающееся до следующего ожидания.
Например, драйвер, который испытывает задержки при завершении работы устройства, может вызвать эту подпрограмму, чтобы определить, сколько времени остается, прежде чем драйвер должен реагировать на питание IRP, чтобы предотвратить управляемое завершение работы (проверка ошибок) операционной системы.
Диспетчер питания задает счетчик времени ожидания наблюдателя, когда он выдает power IRP в стеке устройств. Период ожидания для этого счетчика обычно составляет несколько минут. Если устройство в стеке не отвечает и приводит к остановке IRP в течение периода ожидания, диспетчер питания обрабатывает это условие как неустранимую ошибку и инициирует управляемое завершение работы операционной системы.
Если в настоящее время включено несколько тайм-аут часы питания, подпрограмма устанавливает *SecondsRemaining время следующего ожидания.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows 7 |
| целевая платформа | Всеобщий |
| заголовка | ntifs.h (включая Wdm.h, Ntddk.h, Ntifs.h) |
| библиотеки | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |