GetUmsCompletionListEvent-Funktion (winbase.h)

  • Artikel

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)

Weitere Informationen

CreateUmsCompletionList

DequeueUmsCompletionListItems

Wait-Funktionen