Функция GetUmsCompletionListEvent (winbase.h)

Извлекает дескриптор события, связанного с указанным списком завершения планирования пользовательского режима (UMS).

Синтаксис

BOOL GetUmsCompletionListEvent(
  [in]      PUMS_COMPLETION_LIST UmsCompletionList,
  [in, out] PHANDLE              UmsCompletionEvent
);

Параметры

[in] UmsCompletionList

Указатель на список завершения UMS. Этот указатель предоставляет функция CreateUmsCompletionList .

[in, out] UmsCompletionEvent

Указатель на переменную HANDLE. В выходных данных параметру UmsCompletionEvent присваивается дескриптор события, связанного с указанным списком завершения.

Возвращаемое значение

Если функция выполняется успешно, она возвращает ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Комментарии

Система сигнализирует о событии списка завершения UMS, когда система помещает элементы в очередь в пустой список завершения. Дескриптор события списка завершения можно использовать с любой функцией ожидания , которая принимает дескриптор события. При сигнале события приложение обычно вызывает DequeueUmsCompletionListItems для получения содержимого списка завершения.

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

Если дескриптор больше не нужен, используйте функцию CloseHandle , чтобы закрыть дескриптор.

Требования

См. также раздел

CreateUmsCompletionList

DequeueUmsCompletionListItems

Функции ожидания