## C Specification

The VkPipelineMultisampleStateCreateInfo structure is defined as:

// Provided by VK_VERSION_1_0
typedef struct VkPipelineMultisampleStateCreateInfo {
VkStructureType                          sType;
const void*                              pNext;
VkPipelineMultisampleStateCreateFlags    flags;
VkSampleCountFlagBits                    rasterizationSamples;
VkBool32                                 alphaToCoverageEnable;
VkBool32                                 alphaToOneEnable;
} VkPipelineMultisampleStateCreateInfo;

## Members

• sType is the type of this structure.

• pNext is NULL or a pointer to a structure extending this structure.

• flags is reserved for future use.

• rasterizationSamples is a VkSampleCountFlagBits specifying the number of samples used in rasterization.

• sampleShadingEnable can be used to enable Sample Shading.

• minSampleShading specifies a minimum fraction of sample shading if sampleShadingEnable is set to VK_TRUE.

• pSampleMask is an array of VkSampleMask values used in the sample mask test.

• alphaToCoverageEnable controls whether a temporary coverage value is generated based on the alpha component of the fragment’s first color output as specified in the Multisample Coverage section.

• alphaToOneEnable controls whether the alpha component of the fragment’s first color output is replaced with one as described in Multisample Coverage.

## Description

Each bit in the sample mask is associated with a unique sample index as defined for the coverage mask. Each bit b for mask word w in the sample mask corresponds to sample index i, where i = 32 × w + b. pSampleMask has a length equal to rasterizationSamples / 32 ⌉ words.

If pSampleMask is NULL, it is treated as if the mask has all bits set to 1.

Valid Usage
• If the sample rate shading feature is not enabled, sampleShadingEnable must be VK_FALSE

• If the alpha to one feature is not enabled, alphaToOneEnable must be VK_FALSE

• minSampleShading must be in the range [0,1]

• If the VK_NV_framebuffer_mixed_samples extension is enabled, and if the subpass has any color attachments and rasterizationSamples is greater than the number of color samples, then sampleShadingEnable must be VK_FALSE

Valid Usage (Implicit)