CL_KHR_DX9_MEDIA_SHA(3clc)

📦
version 1.0~svn33624 · 3 versions
, in ubuntu jammy, ubuntu noble

💖 CL_KHR_DX9_MEDIA_SHA — the 3clc girlies' guide 💖

okay bestie, so this is cl_khr_dx9_media_sharing, and it's giving "let my OpenCL and my adapter APIs finally be friends" ✨ Specifically: interoperability between OpenCL and selected adapter APIs — and rn that's only DX9, no cap. 🙈

#pragma OPENCL EXTENSION cl_khr_dx9_media_sharing : enable

✨ DESCRIPTION ✨

So the interfaces for this whole extension live in the header file cl_dx9_media_sharing.h. That's where they're provided, periodt. 🎀

If your implementation supports the cl_khr_dx9_media_sharing extension, then these functions get enabled, and yes, we're listing all of them:

The OpenCL functions enabled by the cl_khr_dx9_media_sharing extension let applications use media surfaces as OpenCL memory objects. The way that this works is efficient sharing of data between OpenCL and selected adapter APIs (only DX9 for now, she's vintage 💅).

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. Main character behavior honestly. 🔥

Careful though, bestie: OpenCL memory objects may be created from the adapter media surface if and only if the OpenCL context has been created from that adapter. It's giving strict. No exceptions, fr fr.

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). That's your vibe check ✅ — go look there if you're wondering whether you got it.

As currently proposed, the interfaces for this extension would be provided in cl_dx9_media_sharing.h. Yes we said it twice, yes it matters. 🦋

🌈 SPECIFICATION 🌈

OpenCL Specification[1]

👀 SEE ALSO 👀

🫶 AUTHORS 🫶

The Khronos Group

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

and that's the whole page, bestie — brought to you by The Khronos Group, dated 01/14/2021, filed under CL_KHR_DX9_MEDIA_SHA(3clc). now go share some surfaces, slay 💅✨🎀

📦 where this page comes from