Ratification Status

Ratified

Extension and Version Dependencies

None

Other Extension Metadata

Last Modified Date

2020-04-21

IP Status

No known IP claims.

Description

cl_khr_dx9_media_sharing allows 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.

New Commands

  • clGetDeviceIDsFromDX9MediaAdapterKHR

  • clCreateFromDX9MediaSurfaceKHR

  • clEnqueueAcquireDX9MediaSurfacesKHR

  • clEnqueueReleaseDX9MediaSurfacesKHR

New Types

  • cl_dx9_media_adapter_type_khr

  • cl_dx9_media_adapter_set_khr

New Enums

  • cl_dx9_media_adapter_type_khr

    • CL_ADAPTER_D3D9_KHR

    • CL_ADAPTER_D3D9EX_KHR

    • CL_ADAPTER_DXVA_KHR

  • cl_dx9_media_adapter_set_khr

    • CL_PREFERRED_DEVICES_FOR_DX9_MEDIA_ADAPTER_KHR

    • CL_ALL_DEVICES_FOR_DX9_MEDIA_ADAPTER_KHR

  • cl_context_info

    • CL_CONTEXT_ADAPTER_D3D9_KHR

    • CL_CONTEXT_ADAPTER_D3D9EX_KHR

    • CL_CONTEXT_ADAPTER_DXVA_KHR

  • cl_mem_info

    • CL_MEM_DX9_MEDIA_ADAPTER_TYPE_KHR

    • CL_MEM_DX9_MEDIA_SURFACE_INFO_KHR

  • cl_image_info

    • CL_IMAGE_DX9_MEDIA_PLANE_KHR

  • cl_command_type

    • CL_COMMAND_ACQUIRE_DX9_MEDIA_SURFACES_KHR

    • CL_COMMAND_RELEASE_DX9_MEDIA_SURFACES_KHR

  • New Error Codes

    • CL_INVALID_DX9_MEDIA_ADAPTER_KHR

    • CL_INVALID_DX9_MEDIA_SURFACE_KHR

    • CL_DX9_MEDIA_SURFACE_ALREADY_ACQUIRED_KHR

    • CL_DX9_MEDIA_SURFACE_NOT_ACQUIRED_KHR

Version History

  • Revision 1.0.0, 2020-04-21

    • First assigned version.

See Also

No cross-references are available

Document Notes

For more information, see the OpenCL Specification

This page is a generated document. Fixes and changes should be made to the generator scripts, not directly.

Copyright

Copyright 2014-2025 The Khronos Group Inc.

SPDX-License-Identifier: CC-BY-4.0