GetUmsCompletionListEvent-Funktion (winbase.h)

Ruft ein Handle für das Ereignis ab, das der angegebenen UmS-Vervollständigungsliste (User Mode Scheduling) zugeordnet ist.

Syntax

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

Parameter

[in] UmsCompletionList

Ein Zeiger auf eine UMS-Vervollständigungsliste. Die CreateUmsCompletionList-Funktion stellt diesen Zeiger bereit.

[in, out] UmsCompletionEvent

Ein Zeiger auf eine HANDLE-Variable. Bei der Ausgabe wird der Parameter UmsCompletionEvent auf ein Handle für das Ereignis festgelegt, das der angegebenen Vervollständigungsliste zugeordnet ist.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird ein Wert ungleich null zurückgegeben.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Das System signalisiert ein UMS-Vervollständigungslistenereignis, wenn das System Elemente in eine leere Vervollständigungsliste in die Warteschlange stellt. Ein Vervollständigungslistenereignishandle kann mit jeder Wartefunktion verwendet werden, die ein Handle für ein Ereignis verwendet. Wenn das Ereignis signalisiert wird, ruft eine Anwendung in der Regel DequeueUmsCompletionListItems auf, um den Inhalt der Vervollständigungsliste abzurufen.

Das Ereignishandle bleibt gültig, bis seine Vervollständigungsliste gelöscht wird. Verwenden Sie das Ereignishandle nicht, um auf eine Vervollständigungsliste zu warten, die gelöscht wurde oder gerade gelöscht wird.

Wenn das Handle nicht mehr benötigt wird, verwenden Sie die CloseHandle-Funktion , um das Handle zu schließen.

Anforderungen

Weitere Informationen

CreateUmsCompletionList

DequeueUmsCompletionListItems

Wait-Funktionen