close_io_deviceT_close_io_deviceCloseIoDeviceCloseIoDevice (Operator)

Name

close_io_deviceT_close_io_deviceCloseIoDeviceCloseIoDevice — Schließen des angegebenen I/O-Gerätes.

Signatur

close_io_device( : : IODeviceHandle : )

Beschreibung

Der Operator close_io_deviceclose_io_deviceCloseIoDeviceCloseIoDeviceCloseIoDevice schließt die Instanz zu dem durch IODeviceHandleIODeviceHandleIODeviceHandleIODeviceHandleIODeviceHandle spezifizierten I/O-Gerät. Dabei werden alle am Gerät geöffneten Kanäle geschlossen (d.h., close_io_channelclose_io_channelCloseIoChannelCloseIoChannelCloseIoChannel wird implizit für alle geöffneten Kanäle des Gerätes aufgerufen) und etwaiger Speicherplatz für Daten freigegeben.

Ausführungsinformationen

Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Wird ohne Parallelisierung verarbeitet.

Dieser Operator modifiziert den Zustand des folgenden Eingabeparameters:

IODeviceHandleIODeviceHandleIODeviceHandleIODeviceHandleIODeviceHandle

Während der Ausführung dieses Operators muss der Zugriff auf den Wert dieses Parameters synchronisiert werden, wenn er über mehrere Threads hinweg verwendet wird.

Parameter

IODeviceHandleIODeviceHandleIODeviceHandleIODeviceHandleIODeviceHandle (input_control, Zustand wird modifiziert) io_device → (handle)

Referenz zum geöffneten I/O-Gerät.

Ergebnis

Für gültige Handles liefert der Operator close_io_deviceclose_io_deviceCloseIoDeviceCloseIoDeviceCloseIoDevice den Wert 2 (H_MSG_TRUE). Andernfalls wird eine Fehlerbehandlung durchgeführt. In diesem Fall kann vom Interface eine zusätzliche Fehlerinformation gesetzt werden, die mit get_extended_error_infoget_extended_error_infoGetExtendedErrorInfoGetExtendedErrorInfoGetExtendedErrorInfo abgefragt werden kann.

Vorgänger

open_io_deviceopen_io_deviceOpenIoDeviceOpenIoDeviceOpenIoDevice

Modul

Foundation

Operatoren