Package org.lwjgl.vulkan

Class VkDebugUtilsMessengerCallbackDataEXT

java.lang.Object
org.lwjgl.system.Pointer.Default
org.lwjgl.system.Struct<VkDebugUtilsMessengerCallbackDataEXT>
org.lwjgl.vulkan.VkDebugUtilsMessengerCallbackDataEXT
All Implemented Interfaces:
AutoCloseable, org.lwjgl.system.NativeResource, org.lwjgl.system.Pointer
public class VkDebugUtilsMessengerCallbackDataEXT extends org.lwjgl.system.Struct<VkDebugUtilsMessengerCallbackDataEXT> implements org.lwjgl.system.NativeResource
Structure specifying parameters returned to the callback.
Description
Note

This structure should only be considered valid during the lifetime of the triggered callback.

Since adding queue and command buffer labels behaves like pushing and popping onto a stack, the order of both pQueueLabels and pCmdBufLabels is based on the order the labels were defined. The result is that the first label in either pQueueLabels or pCmdBufLabels will be the first defined (and therefore the oldest) while the last label in each list will be the most recent.

Note

pQueueLabels will only be non-NULL if one of the objects in pObjects can be related directly to a defined VkQueue which has had one or more labels associated with it.

Likewise, pCmdBufLabels will only be non-NULL if one of the objects in pObjects can be related directly to a defined VkCommandBuffer which has had one or more labels associated with it. Additionally, while command buffer labels allow for beginning and ending across different command buffers, the debug messaging framework cannot guarantee that labels in pCmdBufLables will contain those defined outside of the associated command buffer. This is partially due to the fact that the association of one command buffer with another may not have been defined at the time the debug message is triggered.

Valid Usage (Implicit)
  • sType must be STRUCTURE_TYPE_DEBUG_UTILS_MESSENGER_CALLBACK_DATA_EXT
  • pNext must be NULL or a pointer to a valid instance of VkDeviceAddressBindingCallbackDataEXT
  • The sType value of each struct in the pNext chain must be unique
  • flags must be 0
  • If pMessageIdName is not NULL, pMessageIdName must be a null-terminated UTF-8 string
  • If pMessage is not NULL, pMessage must be a null-terminated UTF-8 string
  • If queueLabelCount is not 0, pQueueLabels must be a valid pointer to an array of queueLabelCount valid VkDebugUtilsLabelEXT structures
  • If cmdBufLabelCount is not 0, pCmdBufLabels must be a valid pointer to an array of cmdBufLabelCount valid VkDebugUtilsLabelEXT structures
  • If objectCount is not 0, pObjects must be a valid pointer to an array of objectCount valid VkDebugUtilsObjectNameInfoEXT structures
See Also

VkDebugUtilsMessengerCallbackEXT, VkDebugUtilsLabelEXT, VkDebugUtilsObjectNameInfoEXT, SubmitDebugUtilsMessageEXT

Layout


 struct VkDebugUtilsMessengerCallbackDataEXT {
     VkStructureType sType();
     void const * pNext();
     VkDebugUtilsMessengerCallbackDataFlagsEXT flags();
     char const * pMessageIdName();
     int32_t messageIdNumber();
     char const * pMessage();
     uint32_t queueLabelCount();
     VkDebugUtilsLabelEXT const * pQueueLabels();
     uint32_t cmdBufLabelCount();
     VkDebugUtilsLabelEXT const * pCmdBufLabels();
     uint32_t objectCount();
     VkDebugUtilsObjectNameInfoEXT const * pObjects();
 }