Функция WaitForInputIdle


Функция WaitForInputIdle ждет до тех пор, пока заданный процесс не дождется ввода данных пользователем, без задержки ввода, или до тех пор, пока не истечет интервал блокировки по времени.

Синтаксис

DWORD WaitForInputIdle(

HANDLE hProcess,     // дескриптор процесса

DWORD dwMilliseconds // интервал задержки, в миллисекундах

);

Параметры

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

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz