open_compute_deviceopen_compute_deviceOpenComputeDeviceopen_compute_deviceOpenComputeDeviceOpenComputeDevice (Operator)

Name

open_compute_deviceopen_compute_deviceOpenComputeDeviceopen_compute_deviceOpenComputeDeviceOpenComputeDevice — Open a compute device.

Signature

open_compute_device( : : DeviceIdentifier : DeviceHandle)

Description

open_compute_deviceopen_compute_deviceOpenComputeDeviceopen_compute_deviceOpenComputeDeviceOpenComputeDevice opens the compute device referenced by DeviceIdentifierDeviceIdentifierDeviceIdentifierDeviceIdentifierDeviceIdentifierdeviceIdentifier and returns DeviceHandleDeviceHandleDeviceHandleDeviceHandleDeviceHandledeviceHandle. Enable computation on DeviceHandleDeviceHandleDeviceHandleDeviceHandleDeviceHandledeviceHandle via activate_compute_deviceactivate_compute_deviceActivateComputeDeviceactivate_compute_deviceActivateComputeDeviceActivateComputeDevice.

DeviceHandleDeviceHandleDeviceHandleDeviceHandleDeviceHandledeviceHandle must be obtained by query_available_compute_devicesquery_available_compute_devicesQueryAvailableComputeDevicesquery_available_compute_devicesQueryAvailableComputeDevicesQueryAvailableComputeDevices.

Parallelization

Multithreading type: reentrant (runs in parallel with non-exclusive operators).
Multithreading scope: local (may only be called from the same thread in which the window, model, or tool instance was created).
Processed without parallelization.

This operator returns a handle. Note that the state of an instance of this handle type may be changed by specific operators even though the handle is used as an input parameter by those operators.

Parameters

DeviceIdentifierDeviceIdentifierDeviceIdentifierDeviceIdentifierDeviceIdentifierdeviceIdentifier (input_control) integer → (integer)

Compute device Identifier.

DeviceHandleDeviceHandleDeviceHandleDeviceHandleDeviceHandledeviceHandle (output_control) compute_device → (integer)

Compute device handle.

open_compute_deviceopen_compute_deviceOpenComputeDeviceopen_compute_deviceOpenComputeDeviceOpenComputeDevice returns the value 2 (H_MSG_TRUE) if DeviceIdentifierDeviceIdentifierDeviceIdentifierDeviceIdentifierDeviceIdentifierdeviceIdentifier is valid. Otherwise an exception will be raised.

Possible Predecessors

query_available_compute_devicesquery_available_compute_devicesQueryAvailableComputeDevicesquery_available_compute_devicesQueryAvailableComputeDevicesQueryAvailableComputeDevices

Possible Successors

activate_compute_deviceactivate_compute_deviceActivateComputeDeviceactivate_compute_deviceActivateComputeDeviceActivateComputeDevice, init_compute_deviceinit_compute_deviceInitComputeDeviceinit_compute_deviceInitComputeDeviceInitComputeDevice

Module

Foundation

Operators