NAME

       cl_khr_dx9_media_sharing - Provide interoperability between OpenCL and selecgted adapter APIs (only DX9
       at this time).

       #pragma OPENCL EXTENSION cl_khr_dx9_media_sharing :
       enable

DESCRIPTION

       The interfaces for this extension are provided in the header file cl_dx9_media_sharing.h.

       If the cl_khr_dx9_media_sharing extension is supported, then the following functions are enabled:

       •   clGetDeviceIDsFromDX9MediaAdapterKHR(3clc).RE

           •   clCreateFromDX9MediaSurfaceKHR(3clc).RE

               •   clEnqueueAcquireDX9MediaSurfacesKHR(3clc).RE

                   •   clEnqueueReleaseDX9MediaSurfacesKHR(3clc).RE

                       The OpenCL functions enabled by the cl_khr_dx9_media_sharing extension allow applications
                       to use media surfaces as OpenCL memory objects. This allows efficient sharing of data
                       between OpenCL and selected adapter APIs (only DX9 for now). If this extension is
                       supported, an OpenCL image object can be created from a media surface and the OpenCL API
                       can be used to execute kernels that read and/or write memory objects that are media
                       surfaces. Note that OpenCL memory objects may be created from the adapter media surface
                       if and only if the OpenCL context has been created from that adapter.

                       If this extension is supported by an implementation, the string
                       "cl_khr_dx9_media_sharing" will be present in the CL_PLATFORM_EXTENSIONS or
                       CL_DEVICE_EXTENSIONS string described in the table of allowed values for param_name for
                       clGetDeviceInfo(3clc)

                       As currently proposed the interfaces for this extension would be provided in
                       cl_dx9_media_sharing.h.

SPECIFICATION

       OpenCL Specification[1]

SEE ALSO

       EXTENSION(3clc), clGetDeviceIDsFromDX9MediaAdapterKHR(3clc), clCreateFromDX9MediaSurfaceKHR(3clc),
       clEnqueueAcquireDX9MediaSurfacesKHR(3clc), clEnqueueReleaseDX9MediaSurfacesKHR(3clc)

AUTHORS

       The Khronos Group

COPYRIGHT

       Copyright © 2007-2011 The Khronos Group Inc.
       Permission is hereby granted, free of charge, to any person obtaining a copy of this software and/or
       associated documentation files (the "Materials"), to deal in the Materials without restriction, including
       without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
       copies of the Materials, and to permit persons to whom the Materials are furnished to do so, subject to
       the condition that this copyright notice and permission notice shall be included in all copies or
       substantial portions of the Materials.

NOTES

        1. OpenCL Specification
           page 83, section 9.10 - DX9 Media Surface Sharing

The Khronos Group                                  02/03/2019                         CL_KHR_DX9_MEDIA_SHA(3clc)