Skip to content

get_compute_device_infoGetComputeDeviceInfoGetComputeDeviceInfoget_compute_device_infoget_compute_device_info🔗

Short description🔗

get_compute_device_infoGetComputeDeviceInfoGetComputeDeviceInfoget_compute_device_infoget_compute_device_info — Get information on a compute device.

Signature🔗

get_compute_device_info( integer DeviceIdentifier, string InfoName, out string Info )void GetComputeDeviceInfo( const HTuple& DeviceIdentifier, const HTuple& InfoName, HTuple* Info )static void HOperatorSet.GetComputeDeviceInfo( HTuple deviceIdentifier, HTuple infoName, out HTuple info )def get_compute_device_info( device_identifier: int, info_name: str ) -> Sequence[Union[str, int, float]]

def get_compute_device_info_s( device_identifier: int, info_name: str ) -> Union[str, int, float]Herror get_compute_device_info( const Hlong DeviceIdentifier, const char* InfoName, char* Info )

Herror T_get_compute_device_info( const Htuple DeviceIdentifier, const Htuple InfoName, Htuple* Info )

static HTuple HComputeDevice::GetComputeDeviceInfo( Hlong DeviceIdentifier, const HString& InfoName )

static HTuple HComputeDevice::GetComputeDeviceInfo( Hlong DeviceIdentifier, const char* InfoName )

static HTuple HComputeDevice::GetComputeDeviceInfo( Hlong DeviceIdentifier, const wchar_t* InfoName ) (Windows only)

static HTuple HComputeDevice.GetComputeDeviceInfo( int deviceIdentifier, string infoName )

Description🔗

The operator get_compute_device_infoGetComputeDeviceInfo returns information on a compute device. In contrast to get_compute_device_paramGetComputeDeviceParam, only static information is queried, so that the device does not have to be opened (see open_compute_deviceOpenComputeDevice) and activated (see activate_compute_deviceActivateComputeDevice).

The following information can be queried:

  • ‘vendor’ Vendor of the compute device.

  • ‘name’ Name of the compute device.

  • ‘platform_version’ Version of the compute device platform. E.g., OpenCL version in the case of OpenCL devices.

  • ‘driver_version’ Version of the device driver.

  • ‘extensions’ Supported OpenCL extensions.

  • ‘image_support’ 'true'"true" if the device supports image objects.

  • ‘image2d_max_width’ Maximum width of OpenCL image objects.

  • ‘image2d_max_height’ Maximum height of OpenCL image objects.

  • ‘max_mem_alloc_size’ Maximum size (in bytes) of an OpenCL memory block.

Execution information🔗

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🔗

DeviceIdentifierdeviceIdentifierdevice_identifier (input_control) integer → (integer)HTuple (Hlong)HTuple (int / long)intHtuple (Hlong)

Compute device handle.

InfoNameinfoNameinfo_name (input_control) string → (string)HTuple (HString)HTuple (string)strHtuple (char*)

Name of Information to query.

Default: 'name'"name"
List of values: 'driver_version', 'extensions', 'image2d_max_height', 'image2d_max_width', 'image_support', 'max_mem_alloc_size', 'name', 'platform_version', 'vendor'"driver_version", "extensions", "image2d_max_height", "image2d_max_width", "image_support", "max_mem_alloc_size", "name", "platform_version", "vendor"

Infoinfoinfo (output_control) string(-array) → (string / integer / real)HTuple (HString / Hlong / double)HTuple (string / int / long / double)Sequence[Union[str, int, float]]Htuple (char* / Hlong / double)

Returned information.

Result🔗

The operator get_compute_device_infoGetComputeDeviceInfo returns the value 2 (H_MSG_TRUE) if the parameters are correct. Otherwise an exception will be raised.

Combinations with other operators🔗

Combinations

Possible predecessors

query_available_compute_devicesQueryAvailableComputeDevices

Possible successors

activate_compute_deviceActivateComputeDevice

Module🔗

Foundation