[{"data":1,"prerenderedAt":829},["ShallowReactive",2],{"CJovMstyQe":3},{"title":4,"description":5,"parent":6,"type":7,"xrefs":8,"body":9,"_type":828,"_id":4},"vkGetPhysicalDeviceSurfacePresentModesKHR","Query supported presentation modes","VK_KHR_surface","protos",[],{"type":10,"children":11,"toc":826},"root",[12,20,324,396,487,555,640,820],{"type":13,"tag":14,"props":15,"children":16},"element","p",{},[17],{"type":18,"value":19},"text","To query the supported presentation modes for a surface, call:",{"type":13,"tag":21,"props":22,"children":23},"code-group",{},[24,140],{"type":13,"tag":25,"props":26,"children":32},"pre",{"className":27,"code":28,"filename":29,"language":30,"meta":31,"style":31},"language-c shiki shiki-themes github-light-default github-dark-default","VkResult vkGetPhysicalDeviceSurfacePresentModesKHR(\n    VkPhysicalDevice physicalDevice,\n    VkSurfaceKHR surface,\n    uint32_t* pPresentModeCount,\n    VkPresentModeKHR* pPresentModes);\n","C","c","",[33],{"type":13,"tag":34,"props":35,"children":36},"code",{"__ignoreMap":31},[37,59,79,97,116],{"type":13,"tag":38,"props":39,"children":42},"span",{"class":40,"line":41},"line",1,[43,49,54],{"type":13,"tag":38,"props":44,"children":46},{"style":45},"--shiki-default:#1F2328;--shiki-dark:#E6EDF3",[47],{"type":18,"value":48},"VkResult ",{"type":13,"tag":38,"props":50,"children":52},{"style":51},"--shiki-default:#8250DF;--shiki-dark:#D2A8FF",[53],{"type":18,"value":4},{"type":13,"tag":38,"props":55,"children":56},{"style":45},[57],{"type":18,"value":58},"(\n",{"type":13,"tag":38,"props":60,"children":62},{"class":40,"line":61},2,[63,68,74],{"type":13,"tag":38,"props":64,"children":65},{"style":45},[66],{"type":18,"value":67},"    VkPhysicalDevice ",{"type":13,"tag":38,"props":69,"children":71},{"style":70},"--shiki-default:#953800;--shiki-dark:#FFA657",[72],{"type":18,"value":73},"physicalDevice",{"type":13,"tag":38,"props":75,"children":76},{"style":45},[77],{"type":18,"value":78},",\n",{"type":13,"tag":38,"props":80,"children":82},{"class":40,"line":81},3,[83,88,93],{"type":13,"tag":38,"props":84,"children":85},{"style":45},[86],{"type":18,"value":87},"    VkSurfaceKHR ",{"type":13,"tag":38,"props":89,"children":90},{"style":70},[91],{"type":18,"value":92},"surface",{"type":13,"tag":38,"props":94,"children":95},{"style":45},[96],{"type":18,"value":78},{"type":13,"tag":38,"props":98,"children":100},{"class":40,"line":99},4,[101,107,112],{"type":13,"tag":38,"props":102,"children":104},{"style":103},"--shiki-default:#CF222E;--shiki-dark:#FF7B72",[105],{"type":18,"value":106},"    uint32_t*",{"type":13,"tag":38,"props":108,"children":109},{"style":70},[110],{"type":18,"value":111}," pPresentModeCount",{"type":13,"tag":38,"props":113,"children":114},{"style":45},[115],{"type":18,"value":78},{"type":13,"tag":38,"props":117,"children":119},{"class":40,"line":118},5,[120,125,130,135],{"type":13,"tag":38,"props":121,"children":122},{"style":45},[123],{"type":18,"value":124},"    VkPresentModeKHR",{"type":13,"tag":38,"props":126,"children":127},{"style":103},[128],{"type":18,"value":129},"*",{"type":13,"tag":38,"props":131,"children":132},{"style":70},[133],{"type":18,"value":134}," pPresentModes",{"type":13,"tag":38,"props":136,"children":137},{"style":45},[138],{"type":18,"value":139},");\n",{"type":13,"tag":25,"props":141,"children":146},{"className":142,"code":143,"filename":144,"language":145,"meta":31,"style":31},"language-rs shiki shiki-themes github-light-default github-dark-default","pub fn get_physical_device_surface_present_modes_khr(\n    physical_device: vk::PhysicalDevice,\n    surface: vk::SurfaceKHR,\n    p_present_mode_count: *mut u32,\n    p_present_modes: *mut vk::PresentModeKHR,\n) -> vk::Result;\n","Rust","rs",[147],{"type":13,"tag":34,"props":148,"children":149},{"__ignoreMap":31},[150,172,204,233,259,292],{"type":13,"tag":38,"props":151,"children":152},{"class":40,"line":41},[153,158,163,168],{"type":13,"tag":38,"props":154,"children":155},{"style":103},[156],{"type":18,"value":157},"pub",{"type":13,"tag":38,"props":159,"children":160},{"style":103},[161],{"type":18,"value":162}," fn",{"type":13,"tag":38,"props":164,"children":165},{"style":51},[166],{"type":18,"value":167}," get_physical_device_surface_present_modes_khr",{"type":13,"tag":38,"props":169,"children":170},{"style":45},[171],{"type":18,"value":58},{"type":13,"tag":38,"props":173,"children":174},{"class":40,"line":61},[175,180,185,190,195,200],{"type":13,"tag":38,"props":176,"children":177},{"style":45},[178],{"type":18,"value":179},"    physical_device",{"type":13,"tag":38,"props":181,"children":182},{"style":103},[183],{"type":18,"value":184},":",{"type":13,"tag":38,"props":186,"children":187},{"style":70},[188],{"type":18,"value":189}," vk",{"type":13,"tag":38,"props":191,"children":192},{"style":103},[193],{"type":18,"value":194},"::",{"type":13,"tag":38,"props":196,"children":197},{"style":70},[198],{"type":18,"value":199},"PhysicalDevice",{"type":13,"tag":38,"props":201,"children":202},{"style":45},[203],{"type":18,"value":78},{"type":13,"tag":38,"props":205,"children":206},{"class":40,"line":81},[207,212,216,220,224,229],{"type":13,"tag":38,"props":208,"children":209},{"style":45},[210],{"type":18,"value":211},"    surface",{"type":13,"tag":38,"props":213,"children":214},{"style":103},[215],{"type":18,"value":184},{"type":13,"tag":38,"props":217,"children":218},{"style":70},[219],{"type":18,"value":189},{"type":13,"tag":38,"props":221,"children":222},{"style":103},[223],{"type":18,"value":194},{"type":13,"tag":38,"props":225,"children":226},{"style":70},[227],{"type":18,"value":228},"SurfaceKHR",{"type":13,"tag":38,"props":230,"children":231},{"style":45},[232],{"type":18,"value":78},{"type":13,"tag":38,"props":234,"children":235},{"class":40,"line":99},[236,241,245,250,255],{"type":13,"tag":38,"props":237,"children":238},{"style":45},[239],{"type":18,"value":240},"    p_present_mode_count",{"type":13,"tag":38,"props":242,"children":243},{"style":103},[244],{"type":18,"value":184},{"type":13,"tag":38,"props":246,"children":247},{"style":103},[248],{"type":18,"value":249}," *mut",{"type":13,"tag":38,"props":251,"children":252},{"style":70},[253],{"type":18,"value":254}," u32",{"type":13,"tag":38,"props":256,"children":257},{"style":45},[258],{"type":18,"value":78},{"type":13,"tag":38,"props":260,"children":261},{"class":40,"line":118},[262,267,271,275,279,283,288],{"type":13,"tag":38,"props":263,"children":264},{"style":45},[265],{"type":18,"value":266},"    p_present_modes",{"type":13,"tag":38,"props":268,"children":269},{"style":103},[270],{"type":18,"value":184},{"type":13,"tag":38,"props":272,"children":273},{"style":103},[274],{"type":18,"value":249},{"type":13,"tag":38,"props":276,"children":277},{"style":70},[278],{"type":18,"value":189},{"type":13,"tag":38,"props":280,"children":281},{"style":103},[282],{"type":18,"value":194},{"type":13,"tag":38,"props":284,"children":285},{"style":70},[286],{"type":18,"value":287},"PresentModeKHR",{"type":13,"tag":38,"props":289,"children":290},{"style":45},[291],{"type":18,"value":78},{"type":13,"tag":38,"props":293,"children":295},{"class":40,"line":294},6,[296,301,306,310,314,319],{"type":13,"tag":38,"props":297,"children":298},{"style":45},[299],{"type":18,"value":300},") ",{"type":13,"tag":38,"props":302,"children":303},{"style":103},[304],{"type":18,"value":305},"->",{"type":13,"tag":38,"props":307,"children":308},{"style":70},[309],{"type":18,"value":189},{"type":13,"tag":38,"props":311,"children":312},{"style":103},[313],{"type":18,"value":194},{"type":13,"tag":38,"props":315,"children":316},{"style":70},[317],{"type":18,"value":318},"Result",{"type":13,"tag":38,"props":320,"children":321},{"style":45},[322],{"type":18,"value":323},";\n",{"type":13,"tag":325,"props":326,"children":327},"ul",{},[328,348,358,369],{"type":13,"tag":329,"props":330,"children":331},"li",{},[332,337,339,346],{"type":13,"tag":34,"props":333,"children":335},{"className":334},[],[336],{"type":18,"value":73},{"type":18,"value":338}," is the physical device that will be associated with\nthe swapchain to be created, as described for\n",{"type":13,"tag":340,"props":341,"children":343},"a",{"href":342},"/man/vkCreateSwapchainKHR",[344],{"type":18,"value":345},"vkCreateSwapchainKHR",{"type":18,"value":347},".",{"type":13,"tag":329,"props":349,"children":350},{},[351,356],{"type":13,"tag":34,"props":352,"children":354},{"className":353},[],[355],{"type":18,"value":92},{"type":18,"value":357}," is the surface that will be associated with the swapchain.",{"type":13,"tag":329,"props":359,"children":360},{},[361,367],{"type":13,"tag":34,"props":362,"children":364},{"className":363},[],[365],{"type":18,"value":366},"pPresentModeCount",{"type":18,"value":368}," is a pointer to an integer related to the number\nof presentation modes available or queried, as described below.",{"type":13,"tag":329,"props":370,"children":371},{},[372,378,380,386,388,394],{"type":13,"tag":34,"props":373,"children":375},{"className":374},[],[376],{"type":18,"value":377},"pPresentModes",{"type":18,"value":379}," is either ",{"type":13,"tag":34,"props":381,"children":383},{"className":382},[],[384],{"type":18,"value":385},"NULL",{"type":18,"value":387}," or a pointer to an array of\n",{"type":13,"tag":340,"props":389,"children":391},{"href":390},"/man/VkPresentModeKHR",[392],{"type":18,"value":393},"VkPresentModeKHR",{"type":18,"value":395}," values, indicating the supported presentation\nmodes.",{"type":13,"tag":14,"props":397,"children":398},{},[399,401,406,408,413,415,420,422,427,429,434,436,441,443,448,450,455,457,462,464,469,471,477,479,485],{"type":18,"value":400},"If ",{"type":13,"tag":34,"props":402,"children":404},{"className":403},[],[405],{"type":18,"value":377},{"type":18,"value":407}," is ",{"type":13,"tag":34,"props":409,"children":411},{"className":410},[],[412],{"type":18,"value":385},{"type":18,"value":414},", then the number of presentation modes\nsupported for the given ",{"type":13,"tag":34,"props":416,"children":418},{"className":417},[],[419],{"type":18,"value":92},{"type":18,"value":421}," is returned in\n",{"type":13,"tag":34,"props":423,"children":425},{"className":424},[],[426],{"type":18,"value":366},{"type":18,"value":428},".\nOtherwise, ",{"type":13,"tag":34,"props":430,"children":432},{"className":431},[],[433],{"type":18,"value":366},{"type":18,"value":435}," ",{"type":13,"tag":437,"props":438,"children":440},"normative",{"type":439},"must",[],{"type":18,"value":442}," point to a variable set by the\napplication to the number of elements in the ",{"type":13,"tag":34,"props":444,"children":446},{"className":445},[],[447],{"type":18,"value":377},{"type":18,"value":449}," array, and\non return the variable is overwritten with the number of values actually\nwritten to ",{"type":13,"tag":34,"props":451,"children":453},{"className":452},[],[454],{"type":18,"value":377},{"type":18,"value":456},".\nIf the value of ",{"type":13,"tag":34,"props":458,"children":460},{"className":459},[],[461],{"type":18,"value":366},{"type":18,"value":463}," is less than the number of\npresentation modes supported, at most ",{"type":13,"tag":34,"props":465,"children":467},{"className":466},[],[468],{"type":18,"value":366},{"type":18,"value":470}," values will be\nwritten, and ",{"type":13,"tag":34,"props":472,"children":474},{"className":473},[],[475],{"type":18,"value":476},"VK_INCOMPLETE",{"type":18,"value":478}," will be returned instead of\n",{"type":13,"tag":34,"props":480,"children":482},{"className":481},[],[483],{"type":18,"value":484},"VK_SUCCESS",{"type":18,"value":486},", to indicate that not all the available modes were\nreturned.",{"type":13,"tag":14,"props":488,"children":489},{},[490,492,498,500,505,506,512,514,519,521,527,528,534,536,542,544,547,549,554],{"type":18,"value":491},"If the ",{"type":13,"tag":340,"props":493,"children":495},{"href":494},"/extensions/VK_GOOGLE_surfaceless_query",[496],{"type":18,"value":497},"VK_GOOGLE_surfaceless_query",{"type":18,"value":499}," extension is enabled and\n",{"type":13,"tag":34,"props":501,"children":503},{"className":502},[],[504],{"type":18,"value":92},{"type":18,"value":407},{"type":13,"tag":340,"props":507,"children":509},{"href":508},"/man/VK_NULL_HANDLE",[510],{"type":18,"value":511},"VK_NULL_HANDLE",{"type":18,"value":513},", the values returned in\n",{"type":13,"tag":34,"props":515,"children":517},{"className":516},[],[518],{"type":18,"value":377},{"type":18,"value":520}," will only indicate support for\n",{"type":13,"tag":34,"props":522,"children":524},{"className":523},[],[525],{"type":18,"value":526},"VK_PRESENT_MODE_FIFO_KHR",{"type":18,"value":78},{"type":13,"tag":34,"props":529,"children":531},{"className":530},[],[532],{"type":18,"value":533},"VK_PRESENT_MODE_SHARED_DEMAND_REFRESH_KHR",{"type":18,"value":535},", and\n",{"type":13,"tag":34,"props":537,"children":539},{"className":538},[],[540],{"type":18,"value":541},"VK_PRESENT_MODE_SHARED_CONTINUOUS_REFRESH_KHR",{"type":18,"value":543},".\nTo query support for any other present mode, a valid handle ",{"type":13,"tag":437,"props":545,"children":546},{"type":439},[],{"type":18,"value":548}," be\nprovided in ",{"type":13,"tag":34,"props":550,"children":552},{"className":551},[],[553],{"type":18,"value":92},{"type":18,"value":347},{"type":13,"tag":556,"props":557,"children":559},"validity-group",{"name":558},"Valid Usage",[560,594],{"type":13,"tag":561,"props":562,"children":564},"validity-field",{"name":563},"VUID-vkGetPhysicalDeviceSurfacePresentModesKHR-surface-06524",[565],{"type":13,"tag":14,"props":566,"children":567},{},[568,569,573,575,580,581,584,586,592],{"type":18,"value":491},{"type":13,"tag":340,"props":570,"children":571},{"href":494},[572],{"type":18,"value":497},{"type":18,"value":574}," extension is not enabled,\n",{"type":13,"tag":34,"props":576,"children":578},{"className":577},[],[579],{"type":18,"value":92},{"type":18,"value":435},{"type":13,"tag":437,"props":582,"children":583},{"type":439},[],{"type":18,"value":585}," be a valid ",{"type":13,"tag":340,"props":587,"children":589},{"href":588},"/man/VkSurfaceKHR",[590],{"type":18,"value":591},"VkSurfaceKHR",{"type":18,"value":593}," handle",{"type":13,"tag":561,"props":595,"children":597},{"name":596},"VUID-vkGetPhysicalDeviceSurfacePresentModesKHR-surface-06525",[598],{"type":13,"tag":14,"props":599,"children":600},{},[601,602,607,609,613,614,619,620,623,625,630,632,638],{"type":18,"value":400},{"type":13,"tag":34,"props":603,"children":605},{"className":604},[],[606],{"type":18,"value":92},{"type":18,"value":608}," is not ",{"type":13,"tag":340,"props":610,"children":611},{"href":508},[612],{"type":18,"value":511},{"type":18,"value":78},{"type":13,"tag":34,"props":615,"children":617},{"className":616},[],[618],{"type":18,"value":92},{"type":18,"value":435},{"type":13,"tag":437,"props":621,"children":622},{"type":439},[],{"type":18,"value":624}," be supported by ",{"type":13,"tag":34,"props":626,"children":628},{"className":627},[],[629],{"type":18,"value":73},{"type":18,"value":631},", as reported by\n",{"type":13,"tag":340,"props":633,"children":635},{"href":634},"/man/vkGetPhysicalDeviceSurfaceSupportKHR",[636],{"type":18,"value":637},"vkGetPhysicalDeviceSurfaceSupportKHR",{"type":18,"value":639}," or an equivalent\nplatform-specific mechanism",{"type":13,"tag":556,"props":641,"children":643},{"name":642},"Valid Usage (Implicit)",[644,668,703,729,787],{"type":13,"tag":561,"props":645,"children":647},{"name":646},"VUID-vkGetPhysicalDeviceSurfacePresentModesKHR-physicalDevice-parameter",[648],{"type":13,"tag":14,"props":649,"children":650},{},[651,656,657,660,661,667],{"type":13,"tag":34,"props":652,"children":654},{"className":653},[],[655],{"type":18,"value":73},{"type":18,"value":435},{"type":13,"tag":437,"props":658,"children":659},{"type":439},[],{"type":18,"value":585},{"type":13,"tag":340,"props":662,"children":664},{"href":663},"/man/VkPhysicalDevice",[665],{"type":18,"value":666},"VkPhysicalDevice",{"type":18,"value":593},{"type":13,"tag":561,"props":669,"children":671},{"name":670},"VUID-vkGetPhysicalDeviceSurfacePresentModesKHR-surface-parameter",[672],{"type":13,"tag":14,"props":673,"children":674},{},[675,676,681,682,686,688,693,694,697,698,702],{"type":18,"value":400},{"type":13,"tag":34,"props":677,"children":679},{"className":678},[],[680],{"type":18,"value":92},{"type":18,"value":608},{"type":13,"tag":340,"props":683,"children":684},{"href":508},[685],{"type":18,"value":511},{"type":18,"value":687},", ",{"type":13,"tag":34,"props":689,"children":691},{"className":690},[],[692],{"type":18,"value":92},{"type":18,"value":435},{"type":13,"tag":437,"props":695,"children":696},{"type":439},[],{"type":18,"value":585},{"type":13,"tag":340,"props":699,"children":700},{"href":588},[701],{"type":18,"value":591},{"type":18,"value":593},{"type":13,"tag":561,"props":704,"children":706},{"name":705},"VUID-vkGetPhysicalDeviceSurfacePresentModesKHR-pPresentModeCount-parameter",[707],{"type":13,"tag":14,"props":708,"children":709},{},[710,715,716,719,721,727],{"type":13,"tag":34,"props":711,"children":713},{"className":712},[],[714],{"type":18,"value":366},{"type":18,"value":435},{"type":13,"tag":437,"props":717,"children":718},{"type":439},[],{"type":18,"value":720}," be a valid pointer to a ",{"type":13,"tag":34,"props":722,"children":724},{"className":723},[],[725],{"type":18,"value":726},"uint32_t",{"type":18,"value":728}," value",{"type":13,"tag":561,"props":730,"children":732},{"name":731},"VUID-vkGetPhysicalDeviceSurfacePresentModesKHR-pPresentModes-parameter",[733],{"type":13,"tag":14,"props":734,"children":735},{},[736,738,743,744,750,752,757,758,763,764,769,770,773,775,780,781,785],{"type":18,"value":737},"If the value referenced by ",{"type":13,"tag":34,"props":739,"children":741},{"className":740},[],[742],{"type":18,"value":366},{"type":18,"value":608},{"type":13,"tag":34,"props":745,"children":747},{"className":746},[],[748],{"type":18,"value":749},"0",{"type":18,"value":751},", and ",{"type":13,"tag":34,"props":753,"children":755},{"className":754},[],[756],{"type":18,"value":377},{"type":18,"value":608},{"type":13,"tag":34,"props":759,"children":761},{"className":760},[],[762],{"type":18,"value":385},{"type":18,"value":687},{"type":13,"tag":34,"props":765,"children":767},{"className":766},[],[768],{"type":18,"value":377},{"type":18,"value":435},{"type":13,"tag":437,"props":771,"children":772},{"type":439},[],{"type":18,"value":774}," be a valid pointer to an array of ",{"type":13,"tag":34,"props":776,"children":778},{"className":777},[],[779],{"type":18,"value":366},{"type":18,"value":435},{"type":13,"tag":340,"props":782,"children":783},{"href":390},[784],{"type":18,"value":393},{"type":18,"value":786}," values",{"type":13,"tag":561,"props":788,"children":790},{"name":789},"VUID-vkGetPhysicalDeviceSurfacePresentModesKHR-commonparent",[791],{"type":13,"tag":14,"props":792,"children":793},{},[794,796,801,802,807,809,812,814],{"type":18,"value":795},"Both of ",{"type":13,"tag":34,"props":797,"children":799},{"className":798},[],[800],{"type":18,"value":73},{"type":18,"value":751},{"type":13,"tag":34,"props":803,"children":805},{"className":804},[],[806],{"type":18,"value":92},{"type":18,"value":808}," that are valid handles of non-ignored parameters ",{"type":13,"tag":437,"props":810,"children":811},{"type":439},[],{"type":18,"value":813}," have been created, allocated, or retrieved from the same ",{"type":13,"tag":340,"props":815,"children":817},{"href":816},"/man/VkInstance",[818],{"type":18,"value":819},"VkInstance",{"type":13,"tag":821,"props":822,"children":823},"style",{},[824],{"type":18,"value":825},"html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":31,"searchDepth":61,"depth":61,"links":827},[],"markdown",1725732620648]