[{"data":1,"prerenderedAt":509},["ShallowReactive",2],{"AGmbFKCKA3":3},{"title":4,"description":5,"parent":6,"type":7,"xrefs":8,"body":9,"_type":508,"_id":4},"vkAcquireFullScreenExclusiveModeEXT","Acquire full-screen exclusive mode for a swapchain","VK_EXT_full_screen_exclusive","protos",[],{"type":10,"children":11,"toc":506},"root",[12,20,243,275,361,397,423,500],{"type":13,"tag":14,"props":15,"children":16},"element","p",{},[17],{"type":18,"value":19},"text","To acquire exclusive full-screen access for a swapchain, call:",{"type":13,"tag":21,"props":22,"children":23},"code-group",{},[24,98],{"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 vkAcquireFullScreenExclusiveModeEXT(\n    VkDevice device,\n    VkSwapchainKHR swapchain);\n","C","c","",[33],{"type":13,"tag":34,"props":35,"children":36},"code",{"__ignoreMap":31},[37,59,79],{"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},"    VkDevice ",{"type":13,"tag":38,"props":69,"children":71},{"style":70},"--shiki-default:#953800;--shiki-dark:#FFA657",[72],{"type":18,"value":73},"device",{"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},"    VkSwapchainKHR ",{"type":13,"tag":38,"props":89,"children":90},{"style":70},[91],{"type":18,"value":92},"swapchain",{"type":13,"tag":38,"props":94,"children":95},{"style":45},[96],{"type":18,"value":97},");\n",{"type":13,"tag":25,"props":99,"children":104},{"className":100,"code":101,"filename":102,"language":103,"meta":31,"style":31},"language-rs shiki shiki-themes github-light-default github-dark-default","pub fn acquire_full_screen_exclusive_mode_ext(\n    device: crate :: vk :: vk::Device,\n    swapchain: vk::SwapchainKHR,\n) -> vk::Result;\n","Rust","rs",[105],{"type":13,"tag":34,"props":106,"children":107},{"__ignoreMap":31},[108,131,182,211],{"type":13,"tag":38,"props":109,"children":110},{"class":40,"line":41},[111,117,122,127],{"type":13,"tag":38,"props":112,"children":114},{"style":113},"--shiki-default:#CF222E;--shiki-dark:#FF7B72",[115],{"type":18,"value":116},"pub",{"type":13,"tag":38,"props":118,"children":119},{"style":113},[120],{"type":18,"value":121}," fn",{"type":13,"tag":38,"props":123,"children":124},{"style":51},[125],{"type":18,"value":126}," acquire_full_screen_exclusive_mode_ext",{"type":13,"tag":38,"props":128,"children":129},{"style":45},[130],{"type":18,"value":58},{"type":13,"tag":38,"props":132,"children":133},{"class":40,"line":61},[134,139,144,149,154,159,164,169,173,178],{"type":13,"tag":38,"props":135,"children":136},{"style":45},[137],{"type":18,"value":138},"    device",{"type":13,"tag":38,"props":140,"children":141},{"style":113},[142],{"type":18,"value":143},":",{"type":13,"tag":38,"props":145,"children":146},{"style":113},[147],{"type":18,"value":148}," crate",{"type":13,"tag":38,"props":150,"children":151},{"style":113},[152],{"type":18,"value":153}," ::",{"type":13,"tag":38,"props":155,"children":156},{"style":45},[157],{"type":18,"value":158}," vk ",{"type":13,"tag":38,"props":160,"children":161},{"style":113},[162],{"type":18,"value":163},"::",{"type":13,"tag":38,"props":165,"children":166},{"style":70},[167],{"type":18,"value":168}," vk",{"type":13,"tag":38,"props":170,"children":171},{"style":113},[172],{"type":18,"value":163},{"type":13,"tag":38,"props":174,"children":175},{"style":70},[176],{"type":18,"value":177},"Device",{"type":13,"tag":38,"props":179,"children":180},{"style":45},[181],{"type":18,"value":78},{"type":13,"tag":38,"props":183,"children":184},{"class":40,"line":81},[185,190,194,198,202,207],{"type":13,"tag":38,"props":186,"children":187},{"style":45},[188],{"type":18,"value":189},"    swapchain",{"type":13,"tag":38,"props":191,"children":192},{"style":113},[193],{"type":18,"value":143},{"type":13,"tag":38,"props":195,"children":196},{"style":70},[197],{"type":18,"value":168},{"type":13,"tag":38,"props":199,"children":200},{"style":113},[201],{"type":18,"value":163},{"type":13,"tag":38,"props":203,"children":204},{"style":70},[205],{"type":18,"value":206},"SwapchainKHR",{"type":13,"tag":38,"props":208,"children":209},{"style":45},[210],{"type":18,"value":78},{"type":13,"tag":38,"props":212,"children":214},{"class":40,"line":213},4,[215,220,225,229,233,238],{"type":13,"tag":38,"props":216,"children":217},{"style":45},[218],{"type":18,"value":219},") ",{"type":13,"tag":38,"props":221,"children":222},{"style":113},[223],{"type":18,"value":224},"->",{"type":13,"tag":38,"props":226,"children":227},{"style":70},[228],{"type":18,"value":168},{"type":13,"tag":38,"props":230,"children":231},{"style":113},[232],{"type":18,"value":163},{"type":13,"tag":38,"props":234,"children":235},{"style":70},[236],{"type":18,"value":237},"Result",{"type":13,"tag":38,"props":239,"children":240},{"style":45},[241],{"type":18,"value":242},";\n",{"type":13,"tag":244,"props":245,"children":246},"ul",{},[247,265],{"type":13,"tag":248,"props":249,"children":250},"li",{},[251,256,258,263],{"type":13,"tag":34,"props":252,"children":254},{"className":253},[],[255],{"type":18,"value":73},{"type":18,"value":257}," is the device associated with ",{"type":13,"tag":34,"props":259,"children":261},{"className":260},[],[262],{"type":18,"value":92},{"type":18,"value":264},".",{"type":13,"tag":248,"props":266,"children":267},{},[268,273],{"type":13,"tag":34,"props":269,"children":271},{"className":270},[],[272],{"type":18,"value":92},{"type":18,"value":274}," is the swapchain to acquire exclusive full-screen access\nfor.",{"type":13,"tag":276,"props":277,"children":279},"validity-group",{"name":278},"Valid Usage",[280,302,343],{"type":13,"tag":281,"props":282,"children":284},"validity-field",{"name":283},"VUID-vkAcquireFullScreenExclusiveModeEXT-swapchain-02674",[285],{"type":13,"tag":14,"props":286,"children":287},{},[288,293,295,300],{"type":13,"tag":34,"props":289,"children":291},{"className":290},[],[292],{"type":18,"value":92},{"type":18,"value":294}," ",{"type":13,"tag":296,"props":297,"children":299},"normative",{"type":298},"must",[],{"type":18,"value":301}," not be in the retired state",{"type":13,"tag":281,"props":303,"children":305},{"name":304},"VUID-vkAcquireFullScreenExclusiveModeEXT-swapchain-02675",[306],{"type":13,"tag":14,"props":307,"children":308},{},[309,314,315,318,320,327,329,335,337],{"type":13,"tag":34,"props":310,"children":312},{"className":311},[],[313],{"type":18,"value":92},{"type":18,"value":294},{"type":13,"tag":296,"props":316,"children":317},{"type":298},[],{"type":18,"value":319}," be a swapchain created with a\n",{"type":13,"tag":321,"props":322,"children":324},"a",{"href":323},"/man/VkSurfaceFullScreenExclusiveInfoEXT",[325],{"type":18,"value":326},"VkSurfaceFullScreenExclusiveInfoEXT",{"type":18,"value":328}," structure, with\n",{"type":13,"tag":34,"props":330,"children":332},{"className":331},[],[333],{"type":18,"value":334},"fullScreenExclusive",{"type":18,"value":336}," set to\n",{"type":13,"tag":34,"props":338,"children":340},{"className":339},[],[341],{"type":18,"value":342},"VK_FULL_SCREEN_EXCLUSIVE_APPLICATION_CONTROLLED_EXT",{"type":13,"tag":281,"props":344,"children":346},{"name":345},"VUID-vkAcquireFullScreenExclusiveModeEXT-swapchain-02676",[347],{"type":13,"tag":14,"props":348,"children":349},{},[350,355,356,359],{"type":13,"tag":34,"props":351,"children":353},{"className":352},[],[354],{"type":18,"value":92},{"type":18,"value":294},{"type":13,"tag":296,"props":357,"children":358},{"type":298},[],{"type":18,"value":360}," not currently have exclusive full-screen access",{"type":13,"tag":14,"props":362,"children":363},{},[364,366,372,374,379,381,387,389,395],{"type":18,"value":365},"A return value of ",{"type":13,"tag":34,"props":367,"children":369},{"className":368},[],[370],{"type":18,"value":371},"VK_SUCCESS",{"type":18,"value":373}," indicates that the ",{"type":13,"tag":34,"props":375,"children":377},{"className":376},[],[378],{"type":18,"value":92},{"type":18,"value":380},"\nsuccessfully acquired exclusive full-screen access.\nThe swapchain will retain this exclusivity until either the application\nreleases exclusive full-screen access with\n",{"type":13,"tag":321,"props":382,"children":384},{"href":383},"/man/vkReleaseFullScreenExclusiveModeEXT",[385],{"type":18,"value":386},"vkReleaseFullScreenExclusiveModeEXT",{"type":18,"value":388},", destroys the swapchain, or if any\nof the swapchain commands return\n",{"type":13,"tag":34,"props":390,"children":392},{"className":391},[],[393],{"type":18,"value":394},"VK_ERROR_FULL_SCREEN_EXCLUSIVE_MODE_LOST_EXT",{"type":18,"value":396}," indicating that the mode\nwas lost because of platform-specific changes.",{"type":13,"tag":14,"props":398,"children":399},{},[400,402,408,410,414,416,421],{"type":18,"value":401},"If the swapchain was unable to acquire exclusive full-screen access to the\ndisplay then ",{"type":13,"tag":34,"props":403,"children":405},{"className":404},[],[406],{"type":18,"value":407},"VK_ERROR_INITIALIZATION_FAILED",{"type":18,"value":409}," is returned.\nAn application ",{"type":13,"tag":296,"props":411,"children":413},{"type":412},"can",[],{"type":18,"value":415}," attempt to acquire exclusive full-screen access again\nfor the same swapchain even if this command fails, or if\n",{"type":13,"tag":34,"props":417,"children":419},{"className":418},[],[420],{"type":18,"value":394},{"type":18,"value":422}," has been returned by a\nswapchain command.",{"type":13,"tag":276,"props":424,"children":426},{"name":425},"Valid Usage (Implicit)",[427,453,477],{"type":13,"tag":281,"props":428,"children":430},{"name":429},"VUID-vkAcquireFullScreenExclusiveModeEXT-device-parameter",[431],{"type":13,"tag":14,"props":432,"children":433},{},[434,439,440,443,445,451],{"type":13,"tag":34,"props":435,"children":437},{"className":436},[],[438],{"type":18,"value":73},{"type":18,"value":294},{"type":13,"tag":296,"props":441,"children":442},{"type":298},[],{"type":18,"value":444}," be a valid ",{"type":13,"tag":321,"props":446,"children":448},{"href":447},"/man/VkDevice",[449],{"type":18,"value":450},"VkDevice",{"type":18,"value":452}," handle",{"type":13,"tag":281,"props":454,"children":456},{"name":455},"VUID-vkAcquireFullScreenExclusiveModeEXT-swapchain-parameter",[457],{"type":13,"tag":14,"props":458,"children":459},{},[460,465,466,469,470,476],{"type":13,"tag":34,"props":461,"children":463},{"className":462},[],[464],{"type":18,"value":92},{"type":18,"value":294},{"type":13,"tag":296,"props":467,"children":468},{"type":298},[],{"type":18,"value":444},{"type":13,"tag":321,"props":471,"children":473},{"href":472},"/man/VkSwapchainKHR",[474],{"type":18,"value":475},"VkSwapchainKHR",{"type":18,"value":452},{"type":13,"tag":281,"props":478,"children":480},{"name":479},"VUID-vkAcquireFullScreenExclusiveModeEXT-swapchain-parent",[481],{"type":13,"tag":14,"props":482,"children":483},{},[484,489,490,493,495],{"type":13,"tag":34,"props":485,"children":487},{"className":486},[],[488],{"type":18,"value":92},{"type":18,"value":294},{"type":13,"tag":296,"props":491,"children":492},{"type":298},[],{"type":18,"value":494}," have been created, allocated, or retrieved from ",{"type":13,"tag":34,"props":496,"children":498},{"className":497},[],[499],{"type":18,"value":73},{"type":13,"tag":501,"props":502,"children":503},"style",{},[504],{"type":18,"value":505},"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":507},[],"markdown",1725732596459]