Функция
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 |
Нет |
|
Замечания по платформе |
Не имеется |