Vulkan.Extensions.VK_KHR_shader_abort

VkPhysicalDeviceShaderAbortFeaturesKHR - Structure describing whether shader abort is supported or not

Members

This structure describes the following feature:

Description

If the PhysicalDeviceShaderAbortFeaturesKHR structure is included in the pNext chain of the PhysicalDeviceFeatures2 structure passed to getPhysicalDeviceFeatures2, it is filled in to indicate whether each corresponding feature is supported. If the application wishes to use a Device with any features described by PhysicalDeviceShaderAbortFeaturesKHR, it must add an instance of the structure, with the desired feature members set to TRUE, to the pNext chain of DeviceCreateInfo when creating the Device.

Structure Chaining

Extends the structures

• DeviceCreateInfo

• PhysicalDeviceFeatures2

See Also

VK_KHR_shader_abort, Bool32, StructureType

VkPhysicalDeviceShaderAbortPropertiesKHR - Structure describing the maximum size of a shader abort message

Members

The PhysicalDeviceShaderAbortPropertiesKHR structure describes the following:

Description

If the PhysicalDeviceShaderAbortPropertiesKHR structure is included in the pNext chain of the PhysicalDeviceProperties2 structure passed to getPhysicalDeviceProperties2, it is filled in with each corresponding implementation-dependent property.

Structure Chaining

Extends the structure

• PhysicalDeviceProperties2

See Also

VK_KHR_shader_abort, StructureType

VkDeviceFaultShaderAbortMessageInfoKHR - Structure specifying message data from OpAbortKHR

Description

This structure can be included in the pNext chain of DeviceFaultDebugInfoKHR to retrieve messages returned by OpAbortKHR instructions.

pMessageData is populated with a series of (size,payload) pairs, each aligned to 8-byte boundaries. The size in each pair is a 64-bit integer indicating the number of bytes in the subsequent payload. The data in payload is laid out in the exact manner specified in the OpAbortKHR instruction by the message type, with no modifications. If multiple messages are present, the next message size will always be at the following 8-byte aligned offset after the payload ends.

Implementations must report the message reported by the first OpAbortKHR instruction executed in an invocation for this device. They may report additional messages if other invocations continued to execute after the abort instruction was executed.

Even though shading languages may provide definitions for printf-style abort commands, no formatting is performed by the Vulkan implementation. Applications should consult documentation for the shader language they are using on how abort messages are packed, so that they can unpack them after they are queried.

Structure Chaining

Extends the structure

• DeviceFaultDebugInfoKHR

See Also

VK_KHR_shader_abort, StructureType