public Class VkShaderCreateInfoEXT

Valid Usage

• If codeType is SHADER_CODE_TYPE_SPIRV_EXT, codeSize must be a multiple of 4
• If codeType is SHADER_CODE_TYPE_SPIRV_EXT, pCode must point to valid SPIR-V code, formatted and packed as described by the Khronos SPIR-V Specification
• If codeType is SHADER_CODE_TYPE_SPIRV_EXT, pCode must adhere to the validation rules described by the Validation Rules within a Module section of the SPIR-V Environment appendix
• If codeType is SHADER_CODE_TYPE_SPIRV_EXT, pCode must declare the Shader capability for SPIR-V code
• If codeType is SHADER_CODE_TYPE_SPIRV_EXT, pCode must not declare any capability that is not supported by the API, as described by the Capabilities section of the SPIR-V Environment appendix
• If codeType is SHADER_CODE_TYPE_SPIRV_EXT, and pCode declares any of the capabilities listed in the SPIR-V Environment appendix, one of the corresponding requirements must be satisfied
• If codeType is SHADER_CODE_TYPE_SPIRV_EXT, pCode must not declare any SPIR-V extension that is not supported by the API, as described by the Extension section of the SPIR-V Environment appendix
• If codeType is SHADER_CODE_TYPE_SPIRV_EXT, and pCode declares any of the SPIR-V extensions listed in the SPIR-V Environment appendix, one of the corresponding requirements must be satisfied
• If stage is not SHADER_STAGE_TASK_BIT_EXT, SHADER_STAGE_MESH_BIT_EXT, SHADER_STAGE_VERTEX_BIT, SHADER_STAGE_TESSELLATION_CONTROL_BIT, SHADER_STAGE_TESSELLATION_EVALUATION_BIT, SHADER_STAGE_GEOMETRY_BIT, or SHADER_STAGE_FRAGMENT_BIT, flags must not include SHADER_CREATE_LINK_STAGE_BIT_EXT
• If stage is not SHADER_STAGE_FRAGMENT_BIT, flags must not include SHADER_CREATE_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_EXT
• If the attachmentFragmentShadingRate feature is not enabled, flags must not include SHADER_CREATE_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_EXT
• If stage is not SHADER_STAGE_FRAGMENT_BIT, flags must not include SHADER_CREATE_FRAGMENT_DENSITY_MAP_ATTACHMENT_BIT_EXT
• If the fragmentDensityMap feature is not enabled, flags must not include SHADER_CREATE_FRAGMENT_DENSITY_MAP_ATTACHMENT_BIT_EXT
• If flags includes SHADER_CREATE_REQUIRE_FULL_SUBGROUPS_BIT_EXT, stage must be one of SHADER_STAGE_MESH_BIT_EXT, SHADER_STAGE_TASK_BIT_EXT, or SHADER_STAGE_COMPUTE_BIT
• If stage is not SHADER_STAGE_COMPUTE_BIT, flags must not include SHADER_CREATE_DISPATCH_BASE_BIT_EXT
• If stage is not SHADER_STAGE_MESH_BIT_EXT, flags must not include SHADER_CREATE_NO_TASK_SHADER_BIT_EXT
• If flags includes both SHADER_CREATE_ALLOW_VARYING_SUBGROUP_SIZE_BIT_EXT and SHADER_CREATE_REQUIRE_FULL_SUBGROUPS_BIT_EXT, the local workgroup size in the X dimension of the shader must be a multiple of maxSubgroupSize
• If flags includes SHADER_CREATE_REQUIRE_FULL_SUBGROUPS_BIT_EXT but not SHADER_CREATE_ALLOW_VARYING_SUBGROUP_SIZE_BIT_EXT and no VkShaderRequiredSubgroupSizeCreateInfoEXT structure is included in the pNext chain, the local workgroup size in the X dimension of the shader must be a multiple of subgroupSize
• stage must not be SHADER_STAGE_ALL_GRAPHICS or SHADER_STAGE_ALL
• If the tessellationShader feature is not enabled, stage must not be SHADER_STAGE_TESSELLATION_CONTROL_BIT or SHADER_STAGE_TESSELLATION_EVALUATION_BIT
• If the geometryShader feature is not enabled, stage must not be SHADER_STAGE_GEOMETRY_BIT
• If the taskShader feature is not enabled, stage must not be SHADER_STAGE_TASK_BIT_EXT
• If the meshShader feature is not enabled, stage must not be SHADER_STAGE_MESH_BIT_EXT
• stage must not be SHADER_STAGE_SUBPASS_SHADING_BIT_HUAWEI
• stage must not be SHADER_STAGE_CLUSTER_CULLING_BIT_HUAWEI
• If stage is SHADER_STAGE_VERTEX_BIT, nextStage must not include any bits other than SHADER_STAGE_TESSELLATION_CONTROL_BIT, SHADER_STAGE_GEOMETRY_BIT, and SHADER_STAGE_FRAGMENT_BIT
• If the tessellationShader feature is not enabled, nextStage must not include SHADER_STAGE_TESSELLATION_CONTROL_BIT or SHADER_STAGE_TESSELLATION_EVALUATION_BIT
• If the geometryShader feature is not enabled, nextStage must not include SHADER_STAGE_GEOMETRY_BIT
• If stage is SHADER_STAGE_TESSELLATION_CONTROL_BIT, nextStage must not include any bits other than SHADER_STAGE_TESSELLATION_EVALUATION_BIT
• If stage is SHADER_STAGE_TESSELLATION_EVALUATION_BIT, nextStage must not include any bits other than SHADER_STAGE_GEOMETRY_BIT and SHADER_STAGE_FRAGMENT_BIT
• If stage is SHADER_STAGE_GEOMETRY_BIT, nextStage must not include any bits other than SHADER_STAGE_FRAGMENT_BIT
• If stage is SHADER_STAGE_FRAGMENT_BIT or SHADER_STAGE_COMPUTE_BIT, nextStage must be 0
• If stage is SHADER_STAGE_TASK_BIT_EXT, nextStage must not include any bits other than SHADER_STAGE_MESH_BIT_EXT
• If stage is SHADER_STAGE_MESH_BIT_EXT, nextStage must not include any bits other than SHADER_STAGE_FRAGMENT_BIT
• If codeType is SHADER_CODE_TYPE_SPIRV_EXT, pName must be the name of an OpEntryPoint in pCode with an execution model that matches stage
• If codeType is SHADER_CODE_TYPE_BINARY_EXT, pCode must be aligned to 16 bytes
• If codeType is SHADER_CODE_TYPE_SPIRV_EXT, pCode must be aligned to 4 bytes
• If codeType is SHADER_CODE_TYPE_SPIRV_EXT, and the identified entry point includes any variable in its interface that is declared with the ClipDistance BuiltIn decoration, that variable must not have an array size greater than VkPhysicalDeviceLimits::maxClipDistances
• If codeType is SHADER_CODE_TYPE_SPIRV_EXT, and the identified entry point includes any variable in its interface that is declared with the CullDistance BuiltIn decoration, that variable must not have an array size greater than VkPhysicalDeviceLimits::maxCullDistances
• If codeType is SHADER_CODE_TYPE_SPIRV_EXT, and the identified entry point includes any variables in its interface that are declared with the ClipDistance or CullDistance BuiltIn decoration, those variables must not have array sizes which sum to more than VkPhysicalDeviceLimits::maxCombinedClipAndCullDistances
• If codeType is SHADER_CODE_TYPE_SPIRV_EXT, and the identified entry point includes any variable in its interface that is declared with the SampleMask BuiltIn decoration, that variable must not have an array size greater than VkPhysicalDeviceLimits::maxSampleMaskWords
• If codeType is SHADER_CODE_TYPE_SPIRV_EXT, and stage is SHADER_STAGE_VERTEX_BIT, the identified entry point must not include any input variable in its interface that is decorated with CullDistance
• If codeType is SHADER_CODE_TYPE_SPIRV_EXT, and stage is SHADER_STAGE_TESSELLATION_CONTROL_BIT or SHADER_STAGE_TESSELLATION_EVALUATION_BIT, and the identified entry point has an OpExecutionMode instruction specifying a patch size with OutputVertices, the patch size must be greater than 0 and less than or equal to VkPhysicalDeviceLimits::maxTessellationPatchSize
• If codeType is SHADER_CODE_TYPE_SPIRV_EXT, and stage is SHADER_STAGE_GEOMETRY_BIT, the identified entry point must have an OpExecutionMode instruction specifying a maximum output vertex count that is greater than 0 and less than or equal to VkPhysicalDeviceLimits::maxGeometryOutputVertices
• If codeType is SHADER_CODE_TYPE_SPIRV_EXT, and stage is SHADER_STAGE_GEOMETRY_BIT, the identified entry point must have an OpExecutionMode instruction specifying an invocation count that is greater than 0 and less than or equal to VkPhysicalDeviceLimits::maxGeometryShaderInvocations
• If codeType is SHADER_CODE_TYPE_SPIRV_EXT, and stage is a pre-rasterization shader stage, and the identified entry point writes to Layer for any primitive, it must write the same value to Layer for all vertices of a given primitive
• If codeType is SHADER_CODE_TYPE_SPIRV_EXT, and stage is a pre-rasterization shader stage, and the identified entry point writes to ViewportIndex for any primitive, it must write the same value to ViewportIndex for all vertices of a given primitive
• If codeType is SHADER_CODE_TYPE_SPIRV_EXT, and stage is SHADER_STAGE_FRAGMENT_BIT, the identified entry point must not include any output variables in its interface decorated with CullDistance
• If codeType is SHADER_CODE_TYPE_SPIRV_EXT, and stage is SHADER_STAGE_FRAGMENT_BIT, and the identified entry point writes to FragDepth in any execution path, all execution paths that are not exclusive to helper invocations must either discard the fragment, or write or initialize the value of FragDepth
• If codeType is SHADER_CODE_TYPE_SPIRV_EXT, the shader code in pCode must be valid as described by the Khronos SPIR-V Specification after applying the specializations provided in pSpecializationInfo, if any, and then converting all specialization constants into fixed constants
• If codeType is SHADER_CODE_TYPE_SPIRV_EXT, and stage is SHADER_STAGE_TESSELLATION_EVALUATION_BIT, pCode must contain an OpExecutionMode instruction specifying the type of subdivision
• If codeType is SHADER_CODE_TYPE_SPIRV_EXT, and stage is SHADER_STAGE_TESSELLATION_EVALUATION_BIT, pCode must contain an OpExecutionMode instruction specifying the orientation of triangles generated by the tessellator
• If codeType is SHADER_CODE_TYPE_SPIRV_EXT, and stage is SHADER_STAGE_TESSELLATION_EVALUATION_BIT, pCode must contain an OpExecutionMode instruction specifying the spacing of segments on the edges of tessellated primitives
• If codeType is SHADER_CODE_TYPE_SPIRV_EXT, and stage is SHADER_STAGE_TESSELLATION_EVALUATION_BIT, pCode must contain an OpExecutionMode instruction specifying the output patch size

Valid Usage (Implicit)

• sType must be STRUCTURE_TYPE_SHADER_CREATE_INFO_EXT
• pNext must be NULL or a pointer to a valid instance of VkPipelineShaderStageRequiredSubgroupSizeCreateInfo
• The sType value of each struct in the pNext chain must be unique
• flags must be a valid combination of VkShaderCreateFlagBitsEXT values
• stage must be a valid VkShaderStageFlagBits value
• nextStage must be a valid combination of VkShaderStageFlagBits values
• codeType must be a valid VkShaderCodeTypeEXT value
• pCode must be a valid pointer to an array of codeSize bytes
• If pName is not NULL, pName must be a null-terminated UTF-8 string
• If setLayoutCount is not 0, and pSetLayouts is not NULL, pSetLayouts must be a valid pointer to an array of setLayoutCount valid VkDescriptorSetLayout handles
• If pushConstantRangeCount is not 0, and pPushConstantRanges is not NULL, pPushConstantRanges must be a valid pointer to an array of pushConstantRangeCount valid VkPushConstantRange structures
• If pSpecializationInfo is not NULL, pSpecializationInfo must be a valid pointer to a valid VkSpecializationInfo structure
• codeSize must be greater than 0

See Also

VkPushConstantRange, VkSpecializationInfo, CreateShadersEXT

Layout

struct VkShaderCreateInfoEXT {
    VkStructureType sType;
    void const * pNext;
    VkShaderCreateFlagsEXT flags;
    VkShaderStageFlagBits stage;
    VkShaderStageFlags nextStage;
    VkShaderCodeTypeEXT codeType;
    size_t codeSize;
    void const * pCode;
    char const * pName;
    uint32_t setLayoutCount;
    VkDescriptorSetLayout const * pSetLayouts;
    uint32_t pushConstantRangeCount;
    VkPushConstantRange const * pPushConstantRanges;
    VkSpecializationInfo const * pSpecializationInfo;
}