There is a new Intel® Iris™ and HD Graphics Driver update posted for Haswell and Broadwell and it contains cl_intel_simultaneous_sharing OpenCL extension. Below please find documentation for that extension.
Name String
cl_intel_simultaneous_sharing
Version
Version 7, October 14, 2014
Extension Type
OpenCL platform extension
Dependencies
OpenCL 1.2. This extension is written against revision 19 of the
OpenCL 1.2 Specification and revision 19 of the OpenCL 1.2 Extension
Specification.
Overview
Currently OpenCL 1.2 Extension Spec forbids to specify interoperability
with multiple graphics APIs at clCreateContext or clCreateContextFromType
time and defines that CL_INVALID_OPERATION should be returned in such
cases as noted e.g. in chapters dedicated to sharing memory objects with
Direct3D 10 and Direct3D 11.
The goal of this extension is to relax the restrictions and allow to
specify simultaneously these combinations of interoperabilities that are
supported by a given OpenCL device.
New Tokens
Accepted as a property being queried in the <param_name> parameter
of clGetDeviceInfo:
CL_DEVICE_SIMULTANEOUS_INTEROPS_INTEL 0x4104 CL_DEVICE_NUM_SIMULTANEOUS_INTEROPS_INTEL 0x4105
Additions to chapter 4 of the OpenCL 1.2 Specification
4.2 Querying Devices
Extend table 4.3 to include the following entry:
--------------------------------------------------------------------------
cl_device_info Return Type Description
-------------- ----------- -----------
CL_DEVICE_NUM_SIMULTANEOUS cl_uint Number of supported combinations
_INTEROPS_INTEL of graphics API interoperabilities
that can be enabled simultaneously
within the same context.
The minimum value is 1.
CL_DEVICE_SIMULTANEOUS cl_uint[] List of <n> combinations of context
_INTEROPS_INTEL property names describing graphic APIs
that the device can interoperate with
simultaneously by specifying the
combination in the <properties>
parameter of clCreateContext and
clCreateContextFromType.
Each combination is a set of 2
or more property names and is
terminated with zero.
<n> is the value returned by the
query for
CL_DEVICE_NUM_SIMULTANEOUS_INTEROPS_INTEL.
--------------------------------------------------------------------------
4.4 Contexts
Add to the list of errors for clCreateContext:
“CL_INVALID_OPERATION if a combination of interoperabilities with multiple graphics
APIs is specified which is not on the list of valid combinations returned by
the query for CL_DEVICE_SIMULTANEOUS_INTEROPS_INTEL.”
Add to the list of errors for clCreateContextFromType the same new errors
described above for clCreateContext.
Additions to section 9.6.4 of the OpenCL 1.2 Extension Specification
Replace the section about CL_CONTEXT_INTEROP_USER_SYNC property support with:
“OpenCL / OpenGL sharing does not support the CL_CONTEXT_INTEROP_USER_SYNC property
defined in table 4.5. Specifying this property when creating a context with OpenCL /
OpenGL sharing will return an appropriate error or be ignored for OpenGL sharing if
sharing with another graphics API supporting the CL_CONTEXT_INTEROP_USER_SYNC
property is also specified.”
Replace the description of CL_INVALID_PROPERTY error code with:
“errcode_ret returns CL_INVALID_PROPERTY if an attribute name other than those
specified in table 4.5 or if CL_CONTEXT_INTEROP_USER_SYNC is specified in properties
and there is no graphics API interoperability specified that supports it.”
Additions to section 9.9.5 of the OpenCL 1.2 Extension Specification
Remove the following description of CL_INVALID_PROPERTY error code:
“CL_INVALID_OPERATION if Direct3D 10 interoperability is specified by setting
CL_INVALID_D3D10_DEVICE_KHR to a non-NULL value, and interoperability with another
graphics API is also specified.”
Additions to section 9.11.5 of the OpenCL 1.2 Extension Specification
Remove the following description of CL_INVALID_PROPERTY error code:
“CL_INVALID_OPERATION if Direct3D 11 interoperability is specified by setting
CL_INVALID_D3D11_DEVICE_KHR to a non-NULL value, and interoperability with another
graphics API is also specified.”
Additions to cl_intel_dx9_media_sharing extension specification:
Remove the following description of CL_INVALID_PROPERTY error code:
“CL_INVALID_OPERATION if DirectX 9 interoperability is specified by setting
CL_CONTEXT_D3D9_DEVICE_INTEL, CL_CONTEXT_D3D9EX_DEVICE_INTEL, or
CL_CONTEXT_DXVA_DEVICE_INTEL to a non-NULL value, and interoperability with any
other graphics API is also specified.”
Example Usage
cl_uint SimInteropsNum;
cl_uint* SimInterops;
size_t SimInteropsSize;
clGetDeviceInfo( deviceID,
CL_DEVICE_NUM_SIMULTANEOUS_INTEROPS_INTEL,
sizeof( SimInteropsNum ),
&SimInteropsNum,
NULL );
clGetDeviceInfo( deviceID,
CL_DEVICE_SIMULTANEOUS_INTEROPS_INTEL,
0,
NULL,
&SimInteropsSize );
SimInterops = new cl_uint[ SimInteropsSize / sizeof( cl_uint ) ];
clGetDeviceInfo( deviceID,
CL_DEVICE_SIMULTANEOUS_INTEROPS_INTEL,
SimInteropsSize,
SimInterops,
NULL );
bool SimInteropsCheck[] = { false, false, false };
bool GLD3D11SimInteropSupported = false;
cl_uint property = 0;
for( int i = 0; i < SimInteropsNum; i++ )
{
SimInteropsCheck[0] = false;
SimInteropsCheck[1] = false;
SimInteropsCheck[2] = false;
do
{
property = *SimInterops++;
if( property == CL_GL_CONTEXT_KHR )
SimInteropsCheck[0] = true;
if( property == CL_WGL_HDC_KHR )
SimInteropsCheck[1] = true;
if( property == CL_CONTEXT_D3D11_DEVICE_KHR )
SimInteropsCheck[2] = true;
}
while( property != 0 );
if( SimInteropsCheck[0] && SimInteropsCheck[1] && SimInteropsCheck[2] ){
GLD3D11SimInteropSupported = true;
printf("This device supports GL and D3D11 simultaneous sharing.\n");
break;
}
}
if( !GLD3D11SimInteropSupported ){
printf("This device doesn't support GL and D3D11 simultaneous sharing.\n");
}