steam-frame/lbgos--rift-s-linux
1
0 Fork 0
mirror of https://github.com/lbgos/rift-s-linux.git synced 2026-10-29 04:02:05 +01:00
Code Issues Packages Projects Releases 7 Wiki Activity

a/vk: Improve documentation for vulkan error handlers

Browse Source
This commit is contained in:
Rylie Pavlik committed 2023-11-17 11:19:37 -06:00
1 parent 5cea2bea2f
commit bafdd8ddbc
1 file changed
+17 -1
Download Patch File Download Diff File Expand all files Collapse all files
src/xrt/auxiliary/vk/vk_helpers.h
+17 -1
View File
@@ -458,10 +458,15 @@ struct vk_buffer
* @p FUNC_STR string has failed, then returns @p RET. The implicit argument
* @p vk will be used for the @ref vk_print_result call.
*
* Use this macro when your function returns a `VkResult`.
*
* @param RET The @p VkResult to check.
* @param FUNC_STR String literal with the function name, used for logging.
*
* @ingroup aux_vk
*
* @see VK_CHK_WITH_RET
* @see VK_CHK_WITH_GOTO
*/
#define VK_CHK_AND_RET(RET, FUNC_STR) \
do { \
@@ -474,14 +479,19 @@ struct vk_buffer
/*!
* This define will error if @p RET is not @p VK_SUCCESS, printing out that the
* @p FUNC_STR string has failed, then returns false. The implicit argument
* @p FUNC_STR string has failed, then returns @p TO_RET. The implicit argument
* @p vk will be used for the @ref vk_print_result call.
*
* Use this macro when your function doesn't return a `VkResult`.
*
* @param RET The @p VkResult to check.
* @param FUNC_STR String literal with the function name, used for logging.
* @param TO_RET Value to return, upon error
*
* @ingroup aux_vk
*
* @see VK_CHK_AND_RET
* @see VK_CHK_WITH_GOTO
*/
#define VK_CHK_WITH_RET(RET, FUNC_STR, TO_RET) \
do { \
@@ -497,11 +507,17 @@ struct vk_buffer
* @p FUNC_STR string has failed, then goto @p GOTO. The implicit argument @p vk
* will be used for the @ref vk_print_result call.
*
* Use this macro when your function needs to `goto` some cleanup code and
* return from there.
*
* @param RET The @p VkResult to check.
* @param FUNC_STR String literal with the function name, used for logging.
* @param GOTO Label to jump to, upon error
*
* @ingroup aux_vk
*
* @see VK_CHK_AND_RET
* @see VK_CHK_WITH_RET
*/
#define VK_CHK_WITH_GOTO(RET, FUNC_STR, GOTO) \
do { \