OpenCL™规范 5.13.5.2. NT手柄类型

5.13.5.2. NT Handle Types

5.13.5.2. NT手柄类型

The cl_khr_external_semaphore_win32 extension extends cl_external_semaphore_handle_type_khr to support the following new types of handles, and adds as a property that may be specified when creating a semaphore from an external handle:

​cl_khr_xternal_semaphore_win32扩展扩展了cl_xternal_semaphore_handle_type_khr，以支持以下新类型的句柄，并添加了一个在从外部句柄创建信号量时可以指定的属性：

• CL_SEMAPHORE_HANDLE_OPAQUE_WIN32_KHR specifies an NT handle that has only limited valid usage outside of OpenCL and other compatible APIs. It must be compatible with the functions DuplicateHandle, CloseHandle, CompareObjectHandles, GetHandleInformation, and SetHandleInformation. It owns a reference to the underlying synchronization primitive represented by its semaphore object.

• CL_SEMAPHORE_HANDLE_OPAQUE_WIN32_KHR指定了一个NT句柄，该句柄在OpenCL和其他兼容API之外只有有限的有效使用。它必须与函数DuplicateHandle、CloseHandle、CompareObjectHandles、GetHandleInformation和SetHandleInformation兼容。它拥有对其信号量对象所表示的底层同步原语的引用。

• CL_SEMAPHORE_HANDLE_OPAQUE_WIN32_KMT_KHR specifies a global share handle that has only limited valid usage outside of OpenCL and other compatible APIs. It is not compatible with any native APIs. It does not own a reference to the underlying synchronization primitive represented by its semaphore object, and will therefore become invalid when all semaphore objects associated with it are destroyed.

• CL_SEMAPHORE_HANDLE_OPAQUE_WIN32_KMT_KHR指定了一个全局共享句柄，该句柄在OpenCL和其他兼容API之外只有有限的有效使用。它与任何原生API都不兼容。它不拥有对其信号量对象所表示的底层同步原语的引用，因此当与其关联的所有信号量对象都被销毁时，它将变得无效。

• CL_SEMAPHORE_HANDLE_OPAQUE_WIN32_NAME_KHR specifies an NT handle name that has only limited valid usage outside of OpenCL and other compatible APIs. NT handle name is a null-terminated UTF-16 string naming the payload to import. It must be compatible with the functions DuplicateHandle, CloseHandle, CompareObjectHandles, GetHandleInformation, and SetHandleInformation. It owns a reference to the underlying synchronization primitive represented by its semaphore object.

• CL_SEMAPHORE_HANDLE_OPAQUE_WIN32_NAME_KHR指定了一个NT句柄名称，该名称在OpenCL和其他兼容API之外只有有限的有效使用。NT句柄名是一个以空结尾的UTF-16字符串，用于命名要导入的有效载荷。它必须与函数DuplicateHandle、CloseHandle、CompareObjectHandles、GetHandleInformation和SetHandleInformation兼容。它拥有对其信号量对象所表示的底层同步原语的引用。