The OpenCL Extension Specification Version: 2.1 Document Revision: 17 Khronos OpenCL Working Group Editor: Allen Hux Last Revision Date: November 5, 2015 Page 1 9. OPTIONAL EXTENSIONS ................................................................................................. 6 9.1 Compiler Directives for Optional Extensions ..............................................................................7 9.2 Getting OpenCL API Extension Function Pointers ....................................................................9 9.3 Creating CL context from a GL context or share group ..........................................................11 9.3.1 Overview .................................................................................................................................................. 11 9.3.2 New Procedures and Functions ................................................................................................................ 11 9.3.3 New Tokens .............................................................................................................................................. 11 9.3.4 Additions to Chapter 4 of the OpenCL 2.1 Specification ......................................................................... 12 9.3.5 Additions to section 9.7 of the OpenCL 2.1 Extension Specification ...................................................... 14 9.3.6 Issues ........................................................................................................................................................ 17 9.4 Sharing Memory Objects with OpenGL / OpenGL ES Buffer, Texture and Renderbuffer Objects ........................................................................................................................................................20 9.4.1 Lifetime of Shared Objects ....................................................................................................................... 20 9.4.2 CL Buffer Objects GL Buffer Objects ................................................................................................. 21 9.4.3 CL Image Objects GL Textures ........................................................................................................... 22 9.4.3.1 List of OpenGL and corresponding OpenCL Image Formats .......................................................................... 24 9.4.4 CL Image Objects GL Renderbuffers .................................................................................................. 25 9.4.5 Querying GL object information from a CL memory object .................................................................... 27 9.4.6 Sharing memory objects that map to GL objects between GL and CL contexts ...................................... 29 9.4.6.1 Synchronizing OpenCL and OpenGL Access to Shared Objects .................................................................... 31 9.5 Creating CL event objects from GL sync objects ......................................................................33 9.5.1 Overview .................................................................................................................................................. 33 9.5.2 New Procedures and Functions ................................................................................................................ 33 9.5.3 New Tokens .............................................................................................................................................. 33 9.5.4 Additions to Chapter 5 of the OpenCL 2.1 Specification ......................................................................... 33 9.5.5 Additions to Chapter 9 of the OpenCL 2.1 Specification ......................................................................... 35 9.5.6 Issues ........................................................................................................................................................ 36 9.6 Sharing Memory Objects with Direct3D 10 ...............................................................................38 9.6.1 Overview .................................................................................................................................................. 38 9.6.2 Header File ............................................................................................................................................... 38 9.6.3 New Procedures and Functions ................................................................................................................ 38 9.6.4 New Tokens .............................................................................................................................................. 39 9.6.5 Additions to Chapter 4 of the OpenCL 2.1 Specification ......................................................................... 40 9.6.6 Additions to Chapter 5 of the OpenCL 2.1 Specification ......................................................................... 41 9.6.7 Sharing Memory Objects with Direct3D 10 Resources ............................................................................ 42 9.6.7.1 Querying OpenCL Devices Corresponding to Direct3D 10 Devices .............................................................. 42 9.6.7.2 Lifetime of Shared Objects .............................................................................................................................. 44 9.6.7.3 Sharing Direct3D 10 Buffer Resources as OpenCL Buffer Objects ................................................................ 45 9.6.7.4 Sharing Direct3D 10 Texture and Resources as OpenCL Image Objects ........................................................ 46 9.6.7.5 Querying Direct3D properties of memory objects created from Direct3D 10 resources ................................. 49 9.6.7.6 Sharing memory objects created from Direct3D 10 resources between Direct3D 10 and OpenCL contexts .. 49 9.6.8 Issues ........................................................................................................................................................ 53 9.7 DX9 Media Surface Sharing ........................................................................................................55 9.7.1 Overview .................................................................................................................................................. 55 9.7.2 Header File ............................................................................................................................................... 55 9.7.3 New Procedures and Functions ................................................................................................................ 55 Last Revision Date: November 5, 2015 Page 2 9.7.4 New Tokens .............................................................................................................................................. 56 9.7.5 Additions to Chapter 4 of the OpenCL 2.1 Specification ......................................................................... 57 9.7.6 Additions to Chapter 5 of the OpenCL 2.1 Specification ......................................................................... 58 9.7.7 Sharing Media Surfaces with OpenCL ..................................................................................................... 59 9.7.7.1 Querying OpenCL Devices corresponding to Media Adapters ....................................................................... 59 9.7.7.2 Creating Media Resources as OpenCL Image Objects .................................................................................... 61 9.7.7.3 Querying Media Surface Properties of Memory Objects created from Media Surfaces .................................. 63 9.7.7.4 Sharing Memory Objects created from Media Surfaces between a Media Adapter and OpenCL ................... 63 9.7.7.5 Surface formats for Media Surface Sharing .................................................................................................... 67 9.8 Sharing Memory Objects with Direct3D 11 ...............................................................................69 9.8.1 Overview .................................................................................................................................................. 69 9.8.2 Header File ............................................................................................................................................... 69 9.8.3 New Procedures and Functions ................................................................................................................ 69 9.8.4 New Tokens .............................................................................................................................................. 70 9.8.5 Additions to Chapter 4 of the OpenCL 2.1 Specification ......................................................................... 71 9.8.6 Additions to Chapter 5 of the OpenCL 2.1 Specification ......................................................................... 72 9.8.7 Sharing Memory Objects with Direct3D 11 Resources ............................................................................ 73 9.8.7.1 Querying OpenCL Devices Corresponding to Direct3D 11 Devices .............................................................. 73 9.8.7.2 Lifetime of Shared Objects .............................................................................................................................. 75 9.8.7.3 Sharing Direct3D 11 Buffer Resources