Merge "libbinder_ndk: doc common stability error" (36ee8fa5) · Commits · e / os / platform_frameworks_native

libs/binder/ndk/include_platform/android/binder_stability.h

+18 −0

Original line number	Diff line number	Diff line
		@@ -50,6 +50,15 @@ static inline void AIBinder_markCompilationUnitStability(AIBinder* binder) {
		* requirements associated with that higher stability level. For instance, a
		* VINTF stability binder is required to be in the VINTF manifest. This API
		* can be called to use that same interface within the vendor partition.
		*
		* WARNING: you must hold on to a binder instance after this is set, while you
		* are using it. If you get a binder (e.g. `...->asBinder().get()`), you must
		* save this binder and then
		* use it. For instance:
		*
		* auto binder = ...->asBinder();
		* AIBinder_forceDowngradeToVendorStability(binder.get());
		* doSomething(binder);
		*/
		void AIBinder_forceDowngradeToVendorStability(AIBinder* binder);

		@@ -79,6 +88,15 @@ static inline void AIBinder_markCompilationUnitStability(AIBinder* binder) {
		* requirements associated with that higher stability level. For instance, a
		* VINTF stability binder is required to be in the VINTF manifest. This API
		* can be called to use that same interface within the system partition.
		*
		* WARNING: you must hold on to a binder instance after this is set, while you
		* are using it. If you get a binder (e.g. `...->asBinder().get()`), you must
		* save this binder and then
		* use it. For instance:
		*
		* auto binder = ...->asBinder();
		* AIBinder_forceDowngradeToSystemStability(binder.get());
		* doSomething(binder);
		*/
		void AIBinder_forceDowngradeToSystemStability(AIBinder* binder);