Class AMDShaderInfo
While this extension provides a mechanism for extracting this information, the details regarding the contents or format of this information are not specified by this extension and may be provided by the vendor externally.
Furthermore, all information types are optionally supported, and users should not assume every implementation supports querying every type of information.
Examples
This example extracts the register usage of a fragment shader within a particular graphics pipeline:
extern VkDevice device;
extern VkPipeline gfxPipeline;
PFN_vkGetShaderInfoAMD pfnGetShaderInfoAMD = (PFN_vkGetShaderInfoAMD)vkGetDeviceProcAddr(
device, "vkGetShaderInfoAMD");
VkShaderStatisticsInfoAMD statistics = {};
size_t dataSize = sizeof(statistics);
if (pfnGetShaderInfoAMD(device,
gfxPipeline,
VK_SHADER_STAGE_FRAGMENT_BIT,
VK_SHADER_INFO_TYPE_STATISTICS_AMD,
&dataSize,
&statistics) == VK_SUCCESS)
{
printf("VGPR usage: %d\n", statistics.resourceUsage.numUsedVgprs);
printf("SGPR usage: %d\n", statistics.resourceUsage.numUsedSgprs);
}
The following example continues the previous example by subsequently attempting to query and print shader disassembly about the fragment shader:
// Query disassembly size (if available)
if (pfnGetShaderInfoAMD(device,
gfxPipeline,
VK_SHADER_STAGE_FRAGMENT_BIT,
VK_SHADER_INFO_TYPE_DISASSEMBLY_AMD,
&dataSize,
nullptr) == VK_SUCCESS)
{
printf("Fragment shader disassembly:\n");
void* disassembly = malloc(dataSize);
// Query disassembly and print
if (pfnGetShaderInfoAMD(device,
gfxPipeline,
VK_SHADER_STAGE_FRAGMENT_BIT,
VK_SHADER_INFO_TYPE_DISASSEMBLY_AMD,
&dataSize,
disassembly) == VK_SUCCESS)
{
printf((char*)disassembly);
}
free(disassembly);
}
VK_AMD_shader_info
- Name String
VK_AMD_shader_info
- Extension Type
- Device extension
- Registered Extension Number
- 43
- Revision
- 1
- Special Use
- Contact
- Jaakko Konttinen jaakkoamd
Other Extension Metadata
- Last Modified Date
- 2017-10-09
- IP Status
- No known IP claims.
- Contributors
- Jaakko Konttinen, AMD
-
Field Summary
Modifier and TypeFieldDescriptionstatic final String
The extension name.static final int
The extension specification version.static final int
VkShaderInfoTypeAMD - Enum specifying which type of shader information to querystatic final int
VkShaderInfoTypeAMD - Enum specifying which type of shader information to querystatic final int
VkShaderInfoTypeAMD - Enum specifying which type of shader information to query -
Method Summary
Modifier and TypeMethodDescriptionstatic int
nvkGetShaderInfoAMD
(VkDevice device, long pipeline, int shaderStage, int infoType, long pInfoSize, long pInfo) Unsafe version of:GetShaderInfoAMD
static int
vkGetShaderInfoAMD
(VkDevice device, long pipeline, int shaderStage, int infoType, PointerBuffer pInfoSize, ByteBuffer pInfo) Get information about a shader in a pipeline.
-
Field Details
-
VK_AMD_SHADER_INFO_SPEC_VERSION
public static final int VK_AMD_SHADER_INFO_SPEC_VERSIONThe extension specification version.- See Also:
-
VK_AMD_SHADER_INFO_EXTENSION_NAME
The extension name.- See Also:
-
VK_SHADER_INFO_TYPE_STATISTICS_AMD
public static final int VK_SHADER_INFO_TYPE_STATISTICS_AMDVkShaderInfoTypeAMD - Enum specifying which type of shader information to queryDescription
SHADER_INFO_TYPE_STATISTICS_AMD
specifies that device resources used by a shader will be queried.SHADER_INFO_TYPE_BINARY_AMD
specifies that implementation-specific information will be queried.SHADER_INFO_TYPE_DISASSEMBLY_AMD
specifies that human-readable disassembly of a shader.
See Also
- See Also:
-
VK_SHADER_INFO_TYPE_BINARY_AMD
public static final int VK_SHADER_INFO_TYPE_BINARY_AMDVkShaderInfoTypeAMD - Enum specifying which type of shader information to queryDescription
SHADER_INFO_TYPE_STATISTICS_AMD
specifies that device resources used by a shader will be queried.SHADER_INFO_TYPE_BINARY_AMD
specifies that implementation-specific information will be queried.SHADER_INFO_TYPE_DISASSEMBLY_AMD
specifies that human-readable disassembly of a shader.
See Also
- See Also:
-
VK_SHADER_INFO_TYPE_DISASSEMBLY_AMD
public static final int VK_SHADER_INFO_TYPE_DISASSEMBLY_AMDVkShaderInfoTypeAMD - Enum specifying which type of shader information to queryDescription
SHADER_INFO_TYPE_STATISTICS_AMD
specifies that device resources used by a shader will be queried.SHADER_INFO_TYPE_BINARY_AMD
specifies that implementation-specific information will be queried.SHADER_INFO_TYPE_DISASSEMBLY_AMD
specifies that human-readable disassembly of a shader.
See Also
- See Also:
-
-
Method Details
-
nvkGetShaderInfoAMD
public static int nvkGetShaderInfoAMD(VkDevice device, long pipeline, int shaderStage, int infoType, long pInfoSize, long pInfo) Unsafe version of:GetShaderInfoAMD
- Parameters:
pInfoSize
- a pointer to a value related to the amount of data the query returns, as described below.
-
vkGetShaderInfoAMD
public static int vkGetShaderInfoAMD(VkDevice device, long pipeline, int shaderStage, int infoType, PointerBuffer pInfoSize, @Nullable ByteBuffer pInfo) Get information about a shader in a pipeline.C Specification
Information about a particular shader that has been compiled as part of a pipeline object can be extracted by calling:
VkResult vkGetShaderInfoAMD( VkDevice device, VkPipeline pipeline, VkShaderStageFlagBits shaderStage, VkShaderInfoTypeAMD infoType, size_t* pInfoSize, void* pInfo);
Description
If
pInfo
isNULL
, then the maximum size of the information that can be retrieved about the shader, in bytes, is returned inpInfoSize
. Otherwise,pInfoSize
must point to a variable set by the user to the size of the buffer, in bytes, pointed to bypInfo
, and on return the variable is overwritten with the amount of data actually written topInfo
. IfpInfoSize
is less than the maximum size that can be retrieved by the pipeline cache, then at mostpInfoSize
bytes will be written topInfo
, andINCOMPLETE
will be returned, instead ofSUCCESS
, to indicate that not all required of the pipeline cache was returned.Not all information is available for every shader and implementations may not support all kinds of information for any shader. When a certain type of information is unavailable, the function returns
ERROR_FEATURE_NOT_PRESENT
.If information is successfully and fully queried, the function will return
SUCCESS
.For
infoType
SHADER_INFO_TYPE_STATISTICS_AMD
, aVkShaderStatisticsInfoAMD
structure will be written to the buffer pointed to bypInfo
. This structure will be populated with statistics regarding the physical device resources used by that shader along with other miscellaneous information and is described in further detail below.For
infoType
SHADER_INFO_TYPE_DISASSEMBLY_AMD
,pInfo
is a pointer to a UTF-8 null-terminated string containing human-readable disassembly. The exact formatting and contents of the disassembly string are vendor-specific.The formatting and contents of all other types of information, including
infoType
SHADER_INFO_TYPE_BINARY_AMD
, are left to the vendor and are not further specified by this extension.Valid Usage (Implicit)
device
must be a validVkDevice
handlepipeline
must be a validVkPipeline
handleshaderStage
must be a validVkShaderStageFlagBits
valueinfoType
must be a validVkShaderInfoTypeAMD
valuepInfoSize
must be a valid pointer to asize_t
value- If the value referenced by
pInfoSize
is not 0, andpInfo
is notNULL
,pInfo
must be a valid pointer to an array ofpInfoSize
bytes pipeline
must have been created, allocated, or retrieved fromdevice
Return Codes
- On success, this command returns
- On failure, this command returns
- Parameters:
device
- the device that createdpipeline
.pipeline
- the target of the query.shaderStage
- aVkShaderStageFlagBits
specifying the particular shader within the pipeline about which information is being queried.infoType
- describes what kind of information is being queried.pInfoSize
- a pointer to a value related to the amount of data the query returns, as described below.pInfo
- eitherNULL
or a pointer to a buffer.
-