clGetExtensionFunctionAddressForPlatform - Returns the address of the extension function named by
Contents
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.
Description
The function clGetExtensionFunctionAddressForPlatform returns the address of the extension function named
by funcname for a given platform. The pointer returned should be cast to a function pointer type matching
the extension function's definition defined in the appropriate extension specification and header file.
A return value of NULL indicates that the specified function does not exist for the implementation or
platform is not a valid platform. A non-NULL return value for clGetExtensionFunctionAddressForPlatform
does not guarantee that an extension function is actually supported by the platform. The application must
also make a corresponding query using clGetPlatformInfo(3clc) (platform, CL_PLATFORM_EXTENSIONS, ... ) or
clGetDeviceInfo(3clc) (device,CL_DEVICE_EXTENSIONS, ... ) to determine if an extension is supported by
the OpenCL implementation.
clGetExtensionFunctionAddressForPlatform may not be queried for core (non-extension) functions in OpenCL.
For functions that are queryable with clGetExtensionFunctionAddressForPlatform, implementations may
choose to also export those functions statically from the object libraries implementing those functions.
However, portable applications cannot rely on this behavior.
Function pointer typedefs must be declared for all extensions that add API entrypoints. These typedefs
are a required part of the extension interface, to be provided in an appropriate header (such as cl_ext.h
if the extension is an OpenCL extension, or cl_gl_ext.h if the extension is an OpenCL/OpenGL sharing
extension).
Name
clGetExtensionFunctionAddressForPlatform - Returns the address of the extension function named by
funcname for a given platform.
void*clGetExtensionFunctionAddressForPlatform(cl_platform_idplatform,constchar*funcname);Notes
1. OpenCL Specification
page 7, section 9.2 - Getting OpenCL API Extension Function Pointers
The Khronos Group 11/18/2024 CLGETEXTENSIONFUNCTI(3clc)
Parameters
funcname
Name of an extension function.
See Also
EXTENSION(3clc)
Specification
OpenCLSpecification[1]
