Функция
WaitForInputIdleФункция
WaitForInputIdle ждет до тех пор, пока заданный процесс не дождется ввода данных пользователем, без задержки ввода, или до тех пор, пока не истечет интервал блокировки по времени.Синтаксис
DWORD WaitForInputIdle(
); |
Параметры
hProcess
[in] Дескриптор процесса. . Если этот процесс - консольная программа или не имеет очереди сообщений,
WaitForInputIdle возвращает значение немедленно.dwMilliseconds
[in] Интервал времени простоя, в миллисекундах. Если
dwMilliseconds имеет значение БЕСКОНЕЧНО (INFINITE), функция не возвращает значение до тех пор, пока процесс бездействует.Возвращаемые значения
Таблица ниже показывает возможные возвращаемые значения:
Значение |
Описание |
0 |
Ожидание было выполнено успешно. |
WAIT_TIMEOUT |
Ожидание было закончено, потому что интервал времени простоя истек. |
WAIT_FAILED |
Произошла ошибка. Чтобы получить дополнительные данные об ошибках, используйте функцию GetLastError. |
Замечания
Функция
WaitForInputIdle дает возможность потоку приостановить свою работу по выполнению кода до тех пор, пока заданный процесс не закончил свою инициализацию и ждет ввод данных от пользователя без задержки ввода. Это может быть полезно для синхронизации родительского процесса и недавно созданного дочернего процесса. Когда родительский процесс создает дочерний процесс, функция CreateProcess возвращает значение, не ожидая, когда дочерний процесс закончить свою инициализацию. Перед попыткой установить связь с дочерним процессом, родительский процесс может использовать WaitForInputIdle, чтобы выявить, когда инициализация “ребенка” была завершена. Например, родительский процесс должен использовать WaitForInputIdle, перед попыткой найти окно, связанное с дочерним процессом.Функция
WaitForInputIdle может быть использована в любое время, а не только в ходе запуска прикладной программы.Смотри также
Краткий обзор Процессы и потоки, Функции, используемые процессами и потоками, CreateProcess
Размещение и совместимость WaitForInputIdle |
|
Windows. NET Server |
Да |
Windows XP |
Да |
Windows 2000 |
Да |
Windows NT |
Да версии 3.1 и выше |
Windows Me |
Да |
Windows 98 |
Да |
Windows 95 |
Да |
Используемая библиотека |
Kernel32.lib |
Заголовочный файл |
|
- объявлено в |
Winbase.h |
- включено в |
Windows.h |
Unicode |
Нет |
Замечания по платформе |
Не имеется |