GetUmsCompletionListEvent-Funktion (winbase.h)
Ruft ein Handle für das Ereignis ab, das der angegebenen UmS-Vervollständigungsliste (User Mode Scheduling) zugeordnet ist.
Warnung
Ab Windows 11 wird die Planung im Benutzermodus nicht unterstützt. Alle Aufrufe schlagen mit dem Fehler ERROR_NOT_SUPPORTEDfehl.
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
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 7 (nur 64-Bit) [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | winbase.h (Windows.h einschließen) |
| Bibliothek | Kernel32.lib |
| DLL | Kernel32.dll |
| APIs | api-ms-win-core-ums-l1-1-0 (eingeführt in Windows 7) |