CloseIoRing-Funktion (ioringapi.h)

Schließt ein HIORING-Handle , das zuvor mit einem Aufruf von CreateIoRing geöffnet wurde.

Syntax

HRESULT CloseIoRing(
  HIORING ioRing
);

Parameter

ioRing

Das zu schließende HIORING-Handle .

Rückgabewert

Gibt bei Erfolg S_OK zurück.

Bemerkungen

Durch aufrufen dieser Funktion wird sichergestellt, dass ressourcen, die dem E/A-Ring zugeordnet sind, freigegeben werden. Das geschlossene Handle ist nach der Rückgabe der Funktion nicht mehr gültig. Beachten Sie, dass durch das Schließen des Handles die Vorgänge in der Warteschlange, aber nicht übermittelt werden, abgebrochen werden. Die Vorgänge, die sich im Flug befinden, werden jedoch nicht annulliert.

Es ist möglich, dass Lesevorgänge aus oder Schreibvorgänge in Speicherpuffer nach der Rückgabe von CloseIoRing weiterhin auftreten. Wenn Sie sicherstellen möchten, dass keine ausstehenden Lese- oder Schreibvorgänge auftreten, müssen Sie warten, bis die Vervollständigungen für alle übermittelten Vorgänge in der Vervollständigungswarteschlange angezeigt werden. Sie können die zuvor übermittelten Vorgänge abbrechen, bevor Sie auf deren Abschluss warten. Alternativ zum Übermitteln mehrerer Abbruchanforderungen können Sie CancelIoEx mit dem Dateihandle und NULL für den überlappenden Zeiger aufrufen, um alle ausstehenden Vorgänge für das Handle effektiv abzubrechen.

Anforderungen

Unterstützte Mindestversion (Client)	Windows Build 22000
Unterstützte Mindestversion (Server)	Windows Build 22000
Kopfzeile	ioringapi.h