close_io_deviceT_close_io_deviceCloseIoDeviceCloseIoDevice (Operator)
Name
close_io_deviceT_close_io_deviceCloseIoDeviceCloseIoDevice
— Close the specified I/O device.
Signature
Description
The operator close_io_deviceclose_io_deviceCloseIoDeviceCloseIoDeviceCloseIoDevice
closes the I/O device specified
by IODeviceHandleIODeviceHandleIODeviceHandleIODeviceHandleIODeviceHandle
. In particular, all associated channels
are closed (i.e., close_io_channelclose_io_channelCloseIoChannelCloseIoChannelCloseIoChannel
is called implicitly on
all channels that had been opened for this device) and allocated
memory for data buffers is released.
Execution Information
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Parameters
IODeviceHandleIODeviceHandleIODeviceHandleIODeviceHandleIODeviceHandle
(input_control) io_device →
HIODevice, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of the opened I/O device.
Result
If the parameters are valid, the operator
close_io_deviceclose_io_deviceCloseIoDeviceCloseIoDeviceCloseIoDevice
returns the value 2 (H_MSG_TRUE). If necessary an
exception is raised. In this case, an extended error information may be
set and can be queried with the operator get_extended_error_infoget_extended_error_infoGetExtendedErrorInfoGetExtendedErrorInfoGetExtendedErrorInfo
.
Possible Predecessors
open_io_deviceopen_io_deviceOpenIoDeviceOpenIoDeviceOpenIoDevice
Module
Foundation