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.

Parameters

DeviceIdentifierDeviceIdentifierDeviceIdentifierDeviceIdentifierDeviceIdentifierdeviceIdentifier (input_control) integer → (integer)

Compute device Identifier.

DeviceHandleDeviceHandleDeviceHandleDeviceHandleDeviceHandledeviceHandle (output_control) compute_device → (integer)

Compute device handle.

Result

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