Função DequeueUmsCompletionListItems (winbase.h)

Recupera threads de trabalho ums (agendamento de modo de usuário) da lista de conclusão de UMS especificada.

Sintaxe

BOOL DequeueUmsCompletionListItems(
  [in]  PUMS_COMPLETION_LIST UmsCompletionList,
  [in]  DWORD                WaitTimeOut,
  [out] PUMS_CONTEXT         *UmsThreadList
);

Parâmetros

[in] UmsCompletionList

Um ponteiro para a lista de conclusão da qual recuperar threads de trabalho.

[in] WaitTimeOut

O intervalo de tempo limite para a operação de recuperação, em milissegundos. A função retornará se o intervalo decorrer, mesmo que nenhum thread de trabalho esteja na fila para a lista de conclusão.

Se o parâmetro WaitTimeOut for zero, a lista de conclusão será verificada quanto aos threads de trabalho disponíveis sem esperar que os threads de trabalho fiquem disponíveis. Se o parâmetro WaitTimeOut for INFINITE, o intervalo de tempo limite da função nunca será decorrido. No entanto, isso não é recomendado porque faz com que a função seja bloqueada até que um ou mais threads de trabalho fiquem disponíveis.

[out] UmsThreadList

Um ponteiro para uma variável UMS_CONTEXT. Na saída, esse parâmetro recebe um ponteiro para o primeiro contexto de thread UMS em uma lista de contextos de thread UMS.

Se nenhum thread de trabalho estiver disponível antes do tempo limite especificado pelo parâmetro WaitTimeOut , esse parâmetro será definido como NULL.

Retornar valor

Se a função for bem-sucedida, ela retornará um valor diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError. Os valores de erro possíveis incluem o seguinte.

Comentários

O sistema enfileira um thread de trabalho umS para uma lista de conclusão quando o thread de trabalho é criado ou quando um thread de trabalho bloqueado anteriormente é desbloqueado. A função DequeueUmsCompletionListItems recupera um ponteiro para uma lista de todos os contextos de thread na lista de conclusão especificada. A função GetNextUmsListItem pode ser usada para colocar os contextos de thread UMS fora da lista na própria fila de threads pronta do agendador. O agendador é responsável por selecionar threads a serem executados com base nas prioridades escolhidas pelo aplicativo.

Não execute threads UMS diretamente da lista fornecida por DequeueUmsCompletionListItems ou execute um thread transferido da lista para a fila de threads pronta antes que a lista esteja completamente vazia. Isso pode causar um comportamento imprevisível no aplicativo.

Se mais de um chamador tentar recuperar threads de uma lista de conclusão compartilhada, somente o primeiro chamador recuperará os threads. Para chamadores subsequentes, a função DequeueUmsCompletionListItems retorna êxito, mas o parâmetro UmsThreadList é definido como NULL.

Requisitos

Confira também

GetNextUmsListItem