| Safe Haskell | None |
|---|---|
| Language | Haskell2010 |
Graphics.Vulkan.Extensions.VK_EXT_debug_report
- newtype VkDebugReportObjectTypeEXT = VkDebugReportObjectTypeEXT Int32
- pattern VK_DEBUG_REPORT_OBJECT_TYPE_UNKNOWN_EXT :: VkDebugReportObjectTypeEXT
- pattern VK_DEBUG_REPORT_OBJECT_TYPE_INSTANCE_EXT :: VkDebugReportObjectTypeEXT
- pattern VK_DEBUG_REPORT_OBJECT_TYPE_PHYSICAL_DEVICE_EXT :: VkDebugReportObjectTypeEXT
- pattern VK_DEBUG_REPORT_OBJECT_TYPE_DEVICE_EXT :: VkDebugReportObjectTypeEXT
- pattern VK_DEBUG_REPORT_OBJECT_TYPE_QUEUE_EXT :: VkDebugReportObjectTypeEXT
- pattern VK_DEBUG_REPORT_OBJECT_TYPE_SEMAPHORE_EXT :: VkDebugReportObjectTypeEXT
- pattern VK_DEBUG_REPORT_OBJECT_TYPE_COMMAND_BUFFER_EXT :: VkDebugReportObjectTypeEXT
- pattern VK_DEBUG_REPORT_OBJECT_TYPE_FENCE_EXT :: VkDebugReportObjectTypeEXT
- pattern VK_DEBUG_REPORT_OBJECT_TYPE_DEVICE_MEMORY_EXT :: VkDebugReportObjectTypeEXT
- pattern VK_DEBUG_REPORT_OBJECT_TYPE_BUFFER_EXT :: VkDebugReportObjectTypeEXT
- pattern VK_DEBUG_REPORT_OBJECT_TYPE_IMAGE_EXT :: VkDebugReportObjectTypeEXT
- pattern VK_DEBUG_REPORT_OBJECT_TYPE_EVENT_EXT :: VkDebugReportObjectTypeEXT
- pattern VK_DEBUG_REPORT_OBJECT_TYPE_QUERY_POOL_EXT :: VkDebugReportObjectTypeEXT
- pattern VK_DEBUG_REPORT_OBJECT_TYPE_BUFFER_VIEW_EXT :: VkDebugReportObjectTypeEXT
- pattern VK_DEBUG_REPORT_OBJECT_TYPE_IMAGE_VIEW_EXT :: VkDebugReportObjectTypeEXT
- pattern VK_DEBUG_REPORT_OBJECT_TYPE_SHADER_MODULE_EXT :: VkDebugReportObjectTypeEXT
- pattern VK_DEBUG_REPORT_OBJECT_TYPE_PIPELINE_CACHE_EXT :: VkDebugReportObjectTypeEXT
- pattern VK_DEBUG_REPORT_OBJECT_TYPE_PIPELINE_LAYOUT_EXT :: VkDebugReportObjectTypeEXT
- pattern VK_DEBUG_REPORT_OBJECT_TYPE_RENDER_PASS_EXT :: VkDebugReportObjectTypeEXT
- pattern VK_DEBUG_REPORT_OBJECT_TYPE_PIPELINE_EXT :: VkDebugReportObjectTypeEXT
- pattern VK_DEBUG_REPORT_OBJECT_TYPE_DESCRIPTOR_SET_LAYOUT_EXT :: VkDebugReportObjectTypeEXT
- pattern VK_DEBUG_REPORT_OBJECT_TYPE_SAMPLER_EXT :: VkDebugReportObjectTypeEXT
- pattern VK_DEBUG_REPORT_OBJECT_TYPE_DESCRIPTOR_POOL_EXT :: VkDebugReportObjectTypeEXT
- pattern VK_DEBUG_REPORT_OBJECT_TYPE_DESCRIPTOR_SET_EXT :: VkDebugReportObjectTypeEXT
- pattern VK_DEBUG_REPORT_OBJECT_TYPE_FRAMEBUFFER_EXT :: VkDebugReportObjectTypeEXT
- pattern VK_DEBUG_REPORT_OBJECT_TYPE_COMMAND_POOL_EXT :: VkDebugReportObjectTypeEXT
- pattern VK_DEBUG_REPORT_OBJECT_TYPE_SURFACE_KHR_EXT :: VkDebugReportObjectTypeEXT
- pattern VK_DEBUG_REPORT_OBJECT_TYPE_SWAPCHAIN_KHR_EXT :: VkDebugReportObjectTypeEXT
- pattern VK_DEBUG_REPORT_OBJECT_TYPE_DEBUG_REPORT_CALLBACK_EXT_EXT :: VkDebugReportObjectTypeEXT
- pattern VK_DEBUG_REPORT_OBJECT_TYPE_DISPLAY_KHR_EXT :: VkDebugReportObjectTypeEXT
- pattern VK_DEBUG_REPORT_OBJECT_TYPE_DISPLAY_MODE_KHR_EXT :: VkDebugReportObjectTypeEXT
- pattern VK_DEBUG_REPORT_OBJECT_TYPE_OBJECT_TABLE_NVX_EXT :: VkDebugReportObjectTypeEXT
- pattern VK_DEBUG_REPORT_OBJECT_TYPE_INDIRECT_COMMANDS_LAYOUT_NVX_EXT :: VkDebugReportObjectTypeEXT
- pattern VK_DEBUG_REPORT_OBJECT_TYPE_VALIDATION_CACHE_EXT_EXT :: VkDebugReportObjectTypeEXT
- newtype VkDebugReportFlagBitsEXT = VkDebugReportFlagBitsEXT VkFlags
- pattern VK_DEBUG_REPORT_INFORMATION_BIT_EXT :: VkDebugReportFlagBitsEXT
- pattern VK_DEBUG_REPORT_WARNING_BIT_EXT :: VkDebugReportFlagBitsEXT
- pattern VK_DEBUG_REPORT_PERFORMANCE_WARNING_BIT_EXT :: VkDebugReportFlagBitsEXT
- pattern VK_DEBUG_REPORT_ERROR_BIT_EXT :: VkDebugReportFlagBitsEXT
- pattern VK_DEBUG_REPORT_DEBUG_BIT_EXT :: VkDebugReportFlagBitsEXT
- pattern VK_ERROR_VALIDATION_FAILED_EXT :: VkResult
- pattern VK_STRUCTURE_TYPE_DEBUG_REPORT_CALLBACK_CREATE_INFO_EXT :: VkStructureType
- pattern VK_OBJECT_TYPE_DEBUG_REPORT_CALLBACK_EXT :: VkObjectType
- pattern VK_DEBUG_REPORT_OBJECT_TYPE_SAMPLER_YCBCR_CONVERSION_EXT :: VkDebugReportObjectTypeEXT
- pattern VK_DEBUG_REPORT_OBJECT_TYPE_DESCRIPTOR_UPDATE_TEMPLATE_EXT :: VkDebugReportObjectTypeEXT
- pattern VK_EXT_DEBUG_REPORT_SPEC_VERSION :: Integral a => a
- pattern VK_EXT_DEBUG_REPORT_EXTENSION_NAME :: (Eq a, IsString a) => a
- pattern VK_STRUCTURE_TYPE_DEBUG_REPORT_CREATE_INFO_EXT :: VkStructureType
- pattern VK_DEBUG_REPORT_OBJECT_TYPE_DEBUG_REPORT_EXT :: VkDebugReportObjectTypeEXT
- type PFN_vkDebugReportCallbackEXT = Ptr (("flags" ::: VkDebugReportFlagsEXT) -> ("objectType" ::: VkDebugReportObjectTypeEXT) -> ("object" ::: Word64) -> ("location" ::: CSize) -> ("messageCode" ::: Int32) -> ("pLayerPrefix" ::: Ptr CChar) -> ("pMessage" ::: Ptr CChar) -> ("pUserData" ::: Ptr ()) -> IO VkBool32)
- type VkDebugReportCallbackEXT = Ptr VkDebugReportCallbackEXT_T
- vkCreateDebugReportCallbackEXT :: ("instance" ::: VkInstance) -> ("pCreateInfo" ::: Ptr VkDebugReportCallbackCreateInfoEXT) -> ("pAllocator" ::: Ptr VkAllocationCallbacks) -> ("pCallback" ::: Ptr VkDebugReportCallbackEXT) -> IO VkResult
- vkDestroyDebugReportCallbackEXT :: ("instance" ::: VkInstance) -> ("callback" ::: VkDebugReportCallbackEXT) -> ("pAllocator" ::: Ptr VkAllocationCallbacks) -> IO ()
- vkDebugReportMessageEXT :: ("instance" ::: VkInstance) -> ("flags" ::: VkDebugReportFlagsEXT) -> ("objectType" ::: VkDebugReportObjectTypeEXT) -> ("object" ::: Word64) -> ("location" ::: CSize) -> ("messageCode" ::: Int32) -> ("pLayerPrefix" ::: Ptr CChar) -> ("pMessage" ::: Ptr CChar) -> IO ()
- data VkDebugReportCallbackCreateInfoEXT = VkDebugReportCallbackCreateInfoEXT {}
- type VkDebugReportFlagsEXT = VkDebugReportFlagBitsEXT
Documentation
newtype VkDebugReportObjectTypeEXT Source #
VkDebugReportObjectTypeEXT - Specify the type of an object handle
Description
+------------------------------------------+---------------------------+ | 'VkDebugReportObjectTypeEXT' | Vulkan Handle Type | +==========================================+===========================+ | @VK_DEBUG_REPORT_OBJECT_TYPE_UNKNOWN_EXT | Unknown\/Undefined Handle | | @ | | +------------------------------------------+---------------------------+ | @VK_DEBUG_REPORT_OBJECT_TYPE_INSTANCE_EX | 'Graphics.Vulkan.Core10.D | | T@ | eviceInitialization.VkIns | | | tance' | +------------------------------------------+---------------------------+ | @VK_DEBUG_REPORT_OBJECT_TYPE_PHYSICAL_DE | 'Graphics.Vulkan.Core10.D | | VICE_EXT@ | eviceInitialization.VkPhy | | | sicalDevice' | +------------------------------------------+---------------------------+ | @VK_DEBUG_REPORT_OBJECT_TYPE_DEVICE_EXT@ | 'Graphics.Vulkan.Core10.D | | | eviceInitialization.VkDev | | | ice' | +------------------------------------------+---------------------------+ | @VK_DEBUG_REPORT_OBJECT_TYPE_QUEUE_EXT@ | 'Graphics.Vulkan.Core10.Q | | | ueue.VkQueue' | +------------------------------------------+---------------------------+ | @VK_DEBUG_REPORT_OBJECT_TYPE_SEMAPHORE_E | 'Graphics.Vulkan.Core10.Q | | XT@ | ueue.VkSemaphore' | +------------------------------------------+---------------------------+ | @VK_DEBUG_REPORT_OBJECT_TYPE_COMMAND_BUF | 'Graphics.Vulkan.Core10.Q | | FER_EXT@ | ueue.VkCommandBuffer' | +------------------------------------------+---------------------------+ | @VK_DEBUG_REPORT_OBJECT_TYPE_FENCE_EXT@ | 'Graphics.Vulkan.Core10.Q | | | ueue.VkFence' | +------------------------------------------+---------------------------+ | @VK_DEBUG_REPORT_OBJECT_TYPE_DEVICE_MEMO | 'Graphics.Vulkan.Core10.M | | RY_EXT@ | emory.VkDeviceMemory' | +------------------------------------------+---------------------------+ | @VK_DEBUG_REPORT_OBJECT_TYPE_BUFFER_EXT@ | 'Graphics.Vulkan.Core10.M | | | emoryManagement.VkBuffer' | +------------------------------------------+---------------------------+ | @VK_DEBUG_REPORT_OBJECT_TYPE_IMAGE_EXT@ | 'Graphics.Vulkan.Core10.M | | | emoryManagement.VkImage' | +------------------------------------------+---------------------------+ | @VK_DEBUG_REPORT_OBJECT_TYPE_EVENT_EXT@ | 'Graphics.Vulkan.Core10.E | | | vent.VkEvent' | +------------------------------------------+---------------------------+ | @VK_DEBUG_REPORT_OBJECT_TYPE_QUERY_POOL_ | 'Graphics.Vulkan.Core10.Q | | EXT@ | uery.VkQueryPool' | +------------------------------------------+---------------------------+ | @VK_DEBUG_REPORT_OBJECT_TYPE_BUFFER_VIEW | 'Graphics.Vulkan.Core10.B | | _EXT@ | ufferView.VkBufferView' | +------------------------------------------+---------------------------+ | @VK_DEBUG_REPORT_OBJECT_TYPE_IMAGE_VIEW_ | 'Graphics.Vulkan.Core10.I | | EXT@ | mageView.VkImageView' | +------------------------------------------+---------------------------+ | @VK_DEBUG_REPORT_OBJECT_TYPE_SHADER_MODU | 'Graphics.Vulkan.Core10.S | | LE_EXT@ | hader.VkShaderModule' | +------------------------------------------+---------------------------+ | @VK_DEBUG_REPORT_OBJECT_TYPE_PIPELINE_CA | 'Graphics.Vulkan.Core10.P | | CHE_EXT@ | ipelineCache.VkPipelineCa | | | che' | +------------------------------------------+---------------------------+ | @VK_DEBUG_REPORT_OBJECT_TYPE_PIPELINE_LA | 'Graphics.Vulkan.Core10.P | | YOUT_EXT@ | ipeline.VkPipelineLayout' | +------------------------------------------+---------------------------+ | @VK_DEBUG_REPORT_OBJECT_TYPE_RENDER_PASS | 'Graphics.Vulkan.Core10.P | | _EXT@ | ipeline.VkRenderPass' | +------------------------------------------+---------------------------+ | @VK_DEBUG_REPORT_OBJECT_TYPE_PIPELINE_EX | 'Graphics.Vulkan.Core10.P | | T@ | ipeline.VkPipeline' | +------------------------------------------+---------------------------+ | @VK_DEBUG_REPORT_OBJECT_TYPE_DESCRIPTOR_ | 'Graphics.Vulkan.Core10.P | | SET_LAYOUT_EXT@ | ipelineLayout.VkDescripto | | | rSetLayout' | +------------------------------------------+---------------------------+ | @VK_DEBUG_REPORT_OBJECT_TYPE_SAMPLER_EXT | 'Graphics.Vulkan.Core10.S | | @ | ampler.VkSampler' | +------------------------------------------+---------------------------+ | @VK_DEBUG_REPORT_OBJECT_TYPE_DESCRIPTOR_ | 'Graphics.Vulkan.Core10.D | | POOL_EXT@ | escriptorSet.VkDescriptor | | | Pool' | +------------------------------------------+---------------------------+ | @VK_DEBUG_REPORT_OBJECT_TYPE_DESCRIPTOR_ | 'Graphics.Vulkan.Core10.D | | SET_EXT@ | escriptorSet.VkDescriptor | | | Set' | +------------------------------------------+---------------------------+ | @VK_DEBUG_REPORT_OBJECT_TYPE_FRAMEBUFFER | 'Graphics.Vulkan.Core10.P | | _EXT@ | ass.VkFramebuffer' | +------------------------------------------+---------------------------+ | @VK_DEBUG_REPORT_OBJECT_TYPE_COMMAND_POO | 'Graphics.Vulkan.Core10.C | | L_EXT@ | ommandPool.VkCommandPool' | +------------------------------------------+---------------------------+ | @VK_DEBUG_REPORT_OBJECT_TYPE_SURFACE_KHR | 'Graphics.Vulkan.Extensio | | _EXT@ | ns.VK_KHR_surface.VkSurfa | | | ceKHR' | +------------------------------------------+---------------------------+ | @VK_DEBUG_REPORT_OBJECT_TYPE_SWAPCHAIN_K | 'Graphics.Vulkan.Extensio | | HR_EXT@ | ns.VK_KHR_swapchain.VkSwa | | | pchainKHR' | +------------------------------------------+---------------------------+ | @VK_DEBUG_REPORT_OBJECT_TYPE_DEBUG_REPOR | 'VkDebugReportCallbackEXT | | T_CALLBACK_EXT_EXT@ | ' | +------------------------------------------+---------------------------+ | @VK_DEBUG_REPORT_OBJECT_TYPE_DISPLAY_KHR | 'Graphics.Vulkan.Extensio | | _EXT@ | ns.VK_KHR_display.VkDispl | | | ayKHR' | +------------------------------------------+---------------------------+ | @VK_DEBUG_REPORT_OBJECT_TYPE_DISPLAY_MOD | 'Graphics.Vulkan.Extensio | | E_KHR_EXT@ | ns.VK_KHR_display.VkDispl | | | ayModeKHR' | +------------------------------------------+---------------------------+ | @VK_DEBUG_REPORT_OBJECT_TYPE_OBJECT_TABL | 'Graphics.Vulkan.Extensio | | E_NVX_EXT@ | ns.VK_NVX_device_generate | | | d_commands.VkObjectTableN | | | VX' | +------------------------------------------+---------------------------+ | @VK_DEBUG_REPORT_OBJECT_TYPE_INDIRECT_CO | 'Graphics.Vulkan.Extensio | | MMANDS_LAYOUT_NVX_EXT@ | ns.VK_NVX_device_generate | | | d_commands.VkIndirectComm | | | andsLayoutNVX' | +------------------------------------------+---------------------------+ | @VK_DEBUG_REPORT_OBJECT_TYPE_DESCRIPTOR_ | 'Graphics.Vulkan.Core11.P | | UPDATE_TEMPLATE_KHR_EXT@ | romoted_from_VK_KHR_descr | | | iptor_update_template.VkD | | | escriptorUpdateTemplate' | +------------------------------------------+---------------------------+ VkDebugReportObjectTypeEXT and Vulkan Handle Relationship
Note
The primary expected use of VK_ERROR_VALIDATION_FAILED_EXT is for
validation layer testing. It is not expected that an application would
see this error code during normal use of the validation layers.
See Also
VkDebugMarkerObjectNameInfoEXT,
VkDebugMarkerObjectTagInfoEXT,
vkDebugReportMessageEXT
Constructors
| VkDebugReportObjectTypeEXT Int32 |
pattern VK_DEBUG_REPORT_OBJECT_TYPE_DESCRIPTOR_SET_LAYOUT_EXT :: VkDebugReportObjectTypeEXT Source #
pattern VK_DEBUG_REPORT_OBJECT_TYPE_DEBUG_REPORT_CALLBACK_EXT_EXT :: VkDebugReportObjectTypeEXT Source #
pattern VK_DEBUG_REPORT_OBJECT_TYPE_INDIRECT_COMMANDS_LAYOUT_NVX_EXT :: VkDebugReportObjectTypeEXT Source #
newtype VkDebugReportFlagBitsEXT Source #
VkDebugReportFlagBitsEXT - Bitmask specifying events which cause a debug report callback
See Also
Constructors
| VkDebugReportFlagBitsEXT VkFlags |
pattern VK_DEBUG_REPORT_INFORMATION_BIT_EXT :: VkDebugReportFlagBitsEXT Source #
VK_DEBUG_REPORT_INFORMATION_BIT_EXT specifies an informational message
such as resource details that may be handy when debugging an
application.
pattern VK_DEBUG_REPORT_WARNING_BIT_EXT :: VkDebugReportFlagBitsEXT Source #
VK_DEBUG_REPORT_WARNING_BIT_EXT specifies use of Vulkan that may
expose an app bug. Such cases may not be immediately harmful, such as a
fragment shader outputting to a location with no attachment. Other cases
may point to behavior that is almost certainly bad when unintended
such as using an image whose memory has not been filled. In general if
you see a warning but you know that the behavior is intended/desired,
then simply ignore the warning.
pattern VK_DEBUG_REPORT_PERFORMANCE_WARNING_BIT_EXT :: VkDebugReportFlagBitsEXT Source #
VK_DEBUG_REPORT_PERFORMANCE_WARNING_BIT_EXT specifies a potentially
non-optimal use of Vulkan, e.g. using
vkCmdClearColorImage when
setting VkAttachmentDescription::loadOp
to VK_ATTACHMENT_LOAD_OP_CLEAR would have worked.
pattern VK_DEBUG_REPORT_ERROR_BIT_EXT :: VkDebugReportFlagBitsEXT Source #
VK_DEBUG_REPORT_ERROR_BIT_EXT specifies that an error that may cause
undefined results, including an application crash.
pattern VK_DEBUG_REPORT_DEBUG_BIT_EXT :: VkDebugReportFlagBitsEXT Source #
VK_DEBUG_REPORT_DEBUG_BIT_EXT specifies diagnostic information from
the implementation and layers.
pattern VK_ERROR_VALIDATION_FAILED_EXT :: VkResult Source #
pattern VK_DEBUG_REPORT_OBJECT_TYPE_SAMPLER_YCBCR_CONVERSION_EXT :: VkDebugReportObjectTypeEXT Source #
pattern VK_DEBUG_REPORT_OBJECT_TYPE_DESCRIPTOR_UPDATE_TEMPLATE_EXT :: VkDebugReportObjectTypeEXT Source #
pattern VK_EXT_DEBUG_REPORT_SPEC_VERSION :: Integral a => a Source #
pattern VK_EXT_DEBUG_REPORT_EXTENSION_NAME :: (Eq a, IsString a) => a Source #
type PFN_vkDebugReportCallbackEXT = Ptr (("flags" ::: VkDebugReportFlagsEXT) -> ("objectType" ::: VkDebugReportObjectTypeEXT) -> ("object" ::: Word64) -> ("location" ::: CSize) -> ("messageCode" ::: Int32) -> ("pLayerPrefix" ::: Ptr CChar) -> ("pMessage" ::: Ptr CChar) -> ("pUserData" ::: Ptr ()) -> IO VkBool32) Source #
PFN_vkDebugReportCallbackEXT - Application-defined debug report callback function
Parameters
flagsspecifies theVkDebugReportFlagBitsEXTthat triggered this callback.
objectTypeis aVkDebugReportObjectTypeEXTvalue specifying the type of object being used or created at the time the event was triggered.objectis the object where the issue was detected. IfobjectTypeisVK_DEBUG_REPORT_OBJECT_TYPE_UNKNOWN_EXT,objectis undefined.locationis a component (layer, driver, loader) defined value that specifies the location of the trigger. This is an optional value.messageCodeis a layer-defined value indicating what test triggered this callback.pLayerPrefixis a null-terminated string that is an abbreviation of the name of the component making the callback.pLayerPrefixis only valid for the duration of the callback.pMessageis a null-terminated string detailing the trigger conditions.pMessageis only valid for the duration of the callback.pUserDatais the user data given when theVkDebugReportCallbackEXTwas created.
Description
The callback must not call vkDestroyDebugReportCallbackEXT.
The callback returns a VkBool32, which is interpreted in a
layer-specified manner. The application should always return
VK_FALSE. The VK_TRUE value is reserved for use in layer
development.
object must be a Vulkan object or VK_NULL_HANDLE. If objectType
is not VK_DEBUG_REPORT_OBJECT_TYPE_UNKNOWN_EXT and object is not
VK_NULL_HANDLE, object must be a Vulkan object of the
corresponding type associated with objectType as defined in
{html_spec_relative}#debug-report-object-types.
See Also
type VkDebugReportCallbackEXT = Ptr VkDebugReportCallbackEXT_T Source #
VkDebugReportCallbackEXT - Opaque handle to a debug report callback object
Description
See Also
vkCreateDebugReportCallbackEXT, vkDestroyDebugReportCallbackEXT
vkCreateDebugReportCallbackEXT :: ("instance" ::: VkInstance) -> ("pCreateInfo" ::: Ptr VkDebugReportCallbackCreateInfoEXT) -> ("pAllocator" ::: Ptr VkAllocationCallbacks) -> ("pCallback" ::: Ptr VkDebugReportCallbackEXT) -> IO VkResult Source #
vkCreateDebugReportCallbackEXT - Create a debug report callback object
Parameters
instancethe instance the callback will be logged on.
pCreateInfopoints to aVkDebugReportCallbackCreateInfoEXTstructure which defines the conditions under which this callback will be called.pAllocatorcontrols host memory allocation as described in the Memory Allocation chapter.pCallbackis a pointer to record theVkDebugReportCallbackEXTobject created.
Description
Valid Usage (Implicit)
instancemust be a validVkInstancehandle
pCreateInfomust be a valid pointer to a validVkDebugReportCallbackCreateInfoEXTstructure- If
pAllocatoris notNULL,pAllocatormust be a valid pointer to a validVkAllocationCallbacksstructure pCallbackmust be a valid pointer to aVkDebugReportCallbackEXThandle
Return Codes
- Success
- -
VK_SUCCESS
- Failure
- -
VK_ERROR_OUT_OF_HOST_MEMORY
See Also
VkAllocationCallbacks,
VkDebugReportCallbackCreateInfoEXT, VkDebugReportCallbackEXT,
VkInstance
vkDestroyDebugReportCallbackEXT :: ("instance" ::: VkInstance) -> ("callback" ::: VkDebugReportCallbackEXT) -> ("pAllocator" ::: Ptr VkAllocationCallbacks) -> IO () Source #
vkDestroyDebugReportCallbackEXT - Destroy a debug report callback object
Parameters
instancethe instance where the callback was created.
callbacktheVkDebugReportCallbackEXTobject to destroy.callbackis an externally synchronized object and must not be used on more than one thread at a time. This means thatvkDestroyDebugReportCallbackEXTmust not be called when a callback is active.pAllocatorcontrols host memory allocation as described in the Memory Allocation chapter.
Description
Valid Usage
- If
VkAllocationCallbackswere provided whencallbackwas created, a compatible set of callbacks must be provided here
- If no
VkAllocationCallbackswere provided whencallbackwas created,pAllocatormust beNULL
Valid Usage (Implicit)
instancemust be a validVkInstancehandle
callbackmust be a validVkDebugReportCallbackEXThandle- If
pAllocatoris notNULL,pAllocatormust be a valid pointer to a validVkAllocationCallbacksstructure callbackmust have been created, allocated, or retrieved frominstance
Host Synchronization
- Host access to
callbackmust be externally synchronized
See Also
vkDebugReportMessageEXT :: ("instance" ::: VkInstance) -> ("flags" ::: VkDebugReportFlagsEXT) -> ("objectType" ::: VkDebugReportObjectTypeEXT) -> ("object" ::: Word64) -> ("location" ::: CSize) -> ("messageCode" ::: Int32) -> ("pLayerPrefix" ::: Ptr CChar) -> ("pMessage" ::: Ptr CChar) -> IO () Source #
vkDebugReportMessageEXT - Inject a message into a debug stream
Parameters
instanceis the debug stream’sVkInstance.
flagsspecifies theVkDebugReportFlagBitsEXTclassification of this event/message.objectTypeis aVkDebugReportObjectTypeEXTspecifying the type of object being used or created at the time the event was triggered.objectthis is the object where the issue was detected.objectcan beVK_NULL_HANDLEif there is no object associated with the event.locationis an application defined value.messageCodeis an application defined value.pLayerPrefixis the abbreviation of the component making this event/message.pMessageis a null-terminated string detailing the trigger conditions.
Description
The call will propagate through the layers and generate callback(s) as
indicated by the message’s flags. The parameters are passed on to the
callback in addition to the pUserData value that was defined at the
time the callback was registered.
Valid Usage
objectmust be a Vulkan object orVK_NULL_HANDLE
- If
objectTypeis notVK_DEBUG_REPORT_OBJECT_TYPE_UNKNOWN_EXTandobjectis notVK_NULL_HANDLE,objectmust be a Vulkan object of the corresponding type associated withobjectTypeas defined in {html_spec_relative}#debug-report-object-types.
Valid Usage (Implicit)
instancemust be a validVkInstancehandle
flagsmust be a valid combination ofVkDebugReportFlagBitsEXTvaluesflagsmust not be0objectTypemust be a validVkDebugReportObjectTypeEXTvaluepLayerPrefixmust be a null-terminated UTF-8 stringpMessagemust be a null-terminated UTF-8 string
See Also
VkDebugReportFlagsEXT, VkDebugReportObjectTypeEXT,
VkInstance
data VkDebugReportCallbackCreateInfoEXT Source #
VkDebugReportCallbackCreateInfoEXT - Structure specifying parameters of a newly created debug report callback
Description
For each VkDebugReportCallbackEXT that is created the
VkDebugReportCallbackCreateInfoEXT::flags determine when that
VkDebugReportCallbackCreateInfoEXT::pfnCallback is called. When an
event happens, the implementation will do a bitwise AND of the event’s
VkDebugReportFlagBitsEXT flags to each VkDebugReportCallbackEXT
object’s flags. For each non-zero result the corresponding callback will
be called. The callback will come directly from the component that
detected the event, unless some other layer intercepts the calls for its
own purposes (filter them in a different way, log to a system error log,
etc.).
An application may receive multiple callbacks if multiple
VkDebugReportCallbackEXT objects were created. A callback will always
be executed in the same thread as the originating Vulkan call.
A callback may be called from multiple threads simultaneously (if the application is making Vulkan calls from multiple threads).
Valid Usage
pfnCallbackmust be a validPFN_vkDebugReportCallbackEXT
Valid Usage (Implicit)
sTypemust beVK_STRUCTURE_TYPE_DEBUG_REPORT_CALLBACK_CREATE_INFO_EXT
flagsmust be a valid combination ofVkDebugReportFlagBitsEXTvalues
See Also
PFN_vkDebugReportCallbackEXT, VkDebugReportFlagsEXT,
VkStructureType,
vkCreateDebugReportCallbackEXT
Constructors
| VkDebugReportCallbackCreateInfoEXT | |
Fields
| |
type VkDebugReportFlagsEXT = VkDebugReportFlagBitsEXT Source #
VkDebugReportFlagsEXT - Bitmask of VkDebugReportFlagBitsEXT
Description
VkDebugReportFlagsEXT is a bitmask type for setting a mask of zero or
more VkDebugReportFlagBitsEXT.
See Also
VkDebugReportCallbackCreateInfoEXT, VkDebugReportFlagBitsEXT,
vkDebugReportMessageEXT