Method RegisterHandCallbacks

Include/XnCppWrapper.h:6171–6192

* @brief Registers event handlers for the 'Hand Create', 'Hand Update' and 'Hand Destroy' events. * Pass NULL for any event you don't want your application to receive. * * @param [in] CreateCB [Optional] Callback function to be invoked when the 'Hand Create' event is raised. * @param [in] UpdateCB [Optional] Callback function to be invoked when the 'Hand Update' event is raised.

		 * For full details and usage of the parameters, see @ref reg_to_events.
		 */
		inline XnStatus RegisterHandCallbacks(HandCreate CreateCB, HandUpdate UpdateCB, HandDestroy DestroyCB, void* pCookie, XnCallbackHandle& hCallback)
		{
			XnStatus nRetVal = XN_STATUS_OK;

			HandCookie* pHandCookie;
			XN_VALIDATE_ALLOC(pHandCookie, HandCookie);
			pHandCookie->createHandler = CreateCB;
			pHandCookie->updateHandler = UpdateCB;
			pHandCookie->destroyHandler = DestroyCB;
			pHandCookie->pUserCookie = pCookie;

			nRetVal = xnRegisterHandCallbacks(GetHandle(), HandCreateCB, HandUpdateCB, HandDestroyCB, pHandCookie, &pHandCookie->hCallback);
			if (nRetVal != XN_STATUS_OK)
			{
				xnOSFree(pHandCookie);
				return (nRetVal);
			}

			hCallback = pHandCookie;

			return (XN_STATUS_OK);
		}

		/**
		 * @brief Unregisters event handlers for the 'Hand Create', 'Hand Update' and 'Hand Destroy' events.