Provided by: opencl-1.2-man-doc_1.0~svn27110-1_all bug

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