CloseIoRing-Funktion (ioringapi.h)

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

Syntax

HRESULT CloseIoRing(
  HIORING ioRing
);

Die Parameter

ioRing

Der zu schließende HIORING-Ziehpunkt .

Rückgabewert

Gibt S_OK bei Erfolg zurück.

Bemerkungen

Durch Aufrufen dieser Funktion wird sichergestellt, dass die für den E/A-Ring zugeordneten Ressourcen freigegeben werden. Der geschlossene Handle ist nach dem Zurückgeben der Funktion nicht mehr gültig. Es ist wichtig zu beachten, dass das Schließen des Handles die Vorgänge in der Warteschlange beendet, aber nicht übermittelt wird. Allerdings werden die Vorgänge, die sich im Flug befinden, nicht storniert.

Es ist möglich, dass Lesevorgänge oder Schreibvorgänge in Speicherpuffer nach dem Zurückgeben von CloseIoRing weiterhin auftreten können. Wenn Sie sicherstellen möchten, dass keine ausstehenden Lese- oder Schreibvorgänge auftreten, müssen Sie warten, bis die Fertigstellungen in der Abschlusswarteschlange für alle übermittelten Vorgänge angezeigt werden. Sie können die zuvor übermittelten Vorgänge abbrechen, bevor Sie auf ihre Fertigstellung 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 auf dem Handle effektiv abzubrechen.

Anforderungen