Ожидание и API

Примечание.

Поведение, описанное на этой странице для пользователя APC, применяется к обычным API в режиме пользователя, а также к специальным api-интерфейсам пользовательского режима.

Потоки, ожидающие объекта диспетчера от имени вызывающего объекта в пользовательском режиме, должны быть подготовлены к прерыванию этого ожидания, либо пользователем APC, либо завершением потока. Когда поток вызывает KeWaitForSingleObject, KeWaitForMultipleObjects, KeWaitForMutexObject или KeDelayExecutionThread, операционная система может поместить поток в состояние ожидания. Как правило, поток остается в состоянии ожидания, пока операционная система не сможет завершить операцию, которую вызывает вызывающий объект. Однако если вызывающий объект указывает WaitMode = UserMode , операционная система может прервать ожидание. В этом случае подпрограмма завершает работу со значением NTSTATUS STATUS_USER_APC.

Любой драйвер, вызывающий одну из предыдущих четырех подпрограмм с WaitMode = UserMode , должен быть готов к получению возвращаемого значения STATUS_USER_APC. Драйвер должен завершить текущую операцию с STATUS_USER_APC и вернуть управление в пользовательский режим.

Точные ситуации, в которых операционная система прерывает ожидание, зависит от значения параметра оповещения подпрограммы. Если оповещается = true, ожидание является оповещаемым. В противном случае ожидание не оповещается. Операционная система прерывает оповещение только для доставки пользовательского APC. Операционная система прерывает оба типа ожиданий завершения потока.

В следующей таблице описывается связь между различными параметрами параметров, ожиданиями и доставкой APC пользователем.

Параметры	Подождите прервано?	Доставлен пользователь APC?
Оповещение = TRUE WaitMode UserMode =	Да	Да
Оповещение = TRUE WaitMode KernelMode =	Да	Нет
Оповещение = FALSE WaitMode UserMode =	Да, для завершения потока. Нет, для пользовательских API.	No
Оповещение FALSE WaitMode = KernelMode =	No	No

Вы можете отключить API ядра для потока. При отключении API ядра для потока также отключены обе службы доставки APC пользователя и завершения потока для этого потока. Дополнительные сведения об отключении API см. в разделе "Отключение API".

Оповещения, редко используемый механизм, внутренний в операционной системе, также может прерывать оповещения о состоянии ожидания. Оповещение может прервать ожидание, если оповещаемое = значение TRUE, независимо от значения параметра WaitMode. Подпрограмма ожидания возвращает значение STATUS_ALERTED.

Обратите внимание, что API ядра выполняются предварительно и не вызывают возврата KeWaitForXxx или KeDelayExecutionThread . Система прерывает и возобновляет внутреннее ожидание. Драйверы обычно не влияют на этот процесс, но драйвер может пропустить сигнал объекта диспетчера для временного состояния, например вызов KePulseEvent.