[{"data":1,"prerenderedAt":492},["ShallowReactive",2],{"xLXmp0Ju6J":3},{"title":4,"description":5,"parent":6,"type":7,"xrefs":8,"body":9,"_type":491,"_id":4},"vkGetSemaphoreZirconHandleFUCHSIA","Get a Zircon event handle for a semaphore","VK_FUCHSIA_external_semaphore","protos",[],{"type":10,"children":11,"toc":489},"root",[12,20,303,349,373,382,401,483],{"type":13,"tag":14,"props":15,"children":16},"element","p",{},[17],{"type":18,"value":19},"text","To export a Zircon event handle representing the payload of a semaphore,\ncall:",{"type":13,"tag":21,"props":22,"children":23},"code-group",{},[24,132],{"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 vkGetSemaphoreZirconHandleFUCHSIA(\n    VkDevice device,\n    const VkSemaphoreGetZirconHandleInfoFUCHSIA* pGetZirconHandleInfo,\n    zx_handle_t* pZirconHandle);\n","C","c","",[33],{"type":13,"tag":34,"props":35,"children":36},"code",{"__ignoreMap":31},[37,59,79,108],{"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,89,94,99,104],{"type":13,"tag":38,"props":84,"children":86},{"style":85},"--shiki-default:#CF222E;--shiki-dark:#FF7B72",[87],{"type":18,"value":88},"    const",{"type":13,"tag":38,"props":90,"children":91},{"style":45},[92],{"type":18,"value":93}," VkSemaphoreGetZirconHandleInfoFUCHSIA",{"type":13,"tag":38,"props":95,"children":96},{"style":85},[97],{"type":18,"value":98},"*",{"type":13,"tag":38,"props":100,"children":101},{"style":70},[102],{"type":18,"value":103}," pGetZirconHandleInfo",{"type":13,"tag":38,"props":105,"children":106},{"style":45},[107],{"type":18,"value":78},{"type":13,"tag":38,"props":109,"children":111},{"class":40,"line":110},4,[112,118,122,127],{"type":13,"tag":38,"props":113,"children":115},{"style":114},"--shiki-default:#0550AE;--shiki-dark:#79C0FF",[116],{"type":18,"value":117},"    zx_handle_t",{"type":13,"tag":38,"props":119,"children":120},{"style":85},[121],{"type":18,"value":98},{"type":13,"tag":38,"props":123,"children":124},{"style":70},[125],{"type":18,"value":126}," pZirconHandle",{"type":13,"tag":38,"props":128,"children":129},{"style":45},[130],{"type":18,"value":131},");\n",{"type":13,"tag":25,"props":133,"children":138},{"className":134,"code":135,"filename":136,"language":137,"meta":31,"style":31},"language-rs shiki shiki-themes github-light-default github-dark-default","pub fn get_semaphore_zircon_handle_fuchsia(\n    device: crate :: vk :: vk::Device,\n    p_get_zircon_handle_info: *const vk::SemaphoreGetZirconHandleInfoFUCHSIA,\n    p_zircon_handle: *mut zx_handle_t,\n) -> vk::Result;\n","Rust","rs",[139],{"type":13,"tag":34,"props":140,"children":141},{"__ignoreMap":31},[142,164,215,249,271],{"type":13,"tag":38,"props":143,"children":144},{"class":40,"line":41},[145,150,155,160],{"type":13,"tag":38,"props":146,"children":147},{"style":85},[148],{"type":18,"value":149},"pub",{"type":13,"tag":38,"props":151,"children":152},{"style":85},[153],{"type":18,"value":154}," fn",{"type":13,"tag":38,"props":156,"children":157},{"style":51},[158],{"type":18,"value":159}," get_semaphore_zircon_handle_fuchsia",{"type":13,"tag":38,"props":161,"children":162},{"style":45},[163],{"type":18,"value":58},{"type":13,"tag":38,"props":165,"children":166},{"class":40,"line":61},[167,172,177,182,187,192,197,202,206,211],{"type":13,"tag":38,"props":168,"children":169},{"style":45},[170],{"type":18,"value":171},"    device",{"type":13,"tag":38,"props":173,"children":174},{"style":85},[175],{"type":18,"value":176},":",{"type":13,"tag":38,"props":178,"children":179},{"style":85},[180],{"type":18,"value":181}," crate",{"type":13,"tag":38,"props":183,"children":184},{"style":85},[185],{"type":18,"value":186}," ::",{"type":13,"tag":38,"props":188,"children":189},{"style":45},[190],{"type":18,"value":191}," vk ",{"type":13,"tag":38,"props":193,"children":194},{"style":85},[195],{"type":18,"value":196},"::",{"type":13,"tag":38,"props":198,"children":199},{"style":70},[200],{"type":18,"value":201}," vk",{"type":13,"tag":38,"props":203,"children":204},{"style":85},[205],{"type":18,"value":196},{"type":13,"tag":38,"props":207,"children":208},{"style":70},[209],{"type":18,"value":210},"Device",{"type":13,"tag":38,"props":212,"children":213},{"style":45},[214],{"type":18,"value":78},{"type":13,"tag":38,"props":216,"children":217},{"class":40,"line":81},[218,223,227,232,236,240,245],{"type":13,"tag":38,"props":219,"children":220},{"style":45},[221],{"type":18,"value":222},"    p_get_zircon_handle_info",{"type":13,"tag":38,"props":224,"children":225},{"style":85},[226],{"type":18,"value":176},{"type":13,"tag":38,"props":228,"children":229},{"style":85},[230],{"type":18,"value":231}," *const",{"type":13,"tag":38,"props":233,"children":234},{"style":70},[235],{"type":18,"value":201},{"type":13,"tag":38,"props":237,"children":238},{"style":85},[239],{"type":18,"value":196},{"type":13,"tag":38,"props":241,"children":242},{"style":70},[243],{"type":18,"value":244},"SemaphoreGetZirconHandleInfoFUCHSIA",{"type":13,"tag":38,"props":246,"children":247},{"style":45},[248],{"type":18,"value":78},{"type":13,"tag":38,"props":250,"children":251},{"class":40,"line":110},[252,257,261,266],{"type":13,"tag":38,"props":253,"children":254},{"style":45},[255],{"type":18,"value":256},"    p_zircon_handle",{"type":13,"tag":38,"props":258,"children":259},{"style":85},[260],{"type":18,"value":176},{"type":13,"tag":38,"props":262,"children":263},{"style":85},[264],{"type":18,"value":265}," *mut",{"type":13,"tag":38,"props":267,"children":268},{"style":45},[269],{"type":18,"value":270}," zx_handle_t,\n",{"type":13,"tag":38,"props":272,"children":274},{"class":40,"line":273},5,[275,280,285,289,293,298],{"type":13,"tag":38,"props":276,"children":277},{"style":45},[278],{"type":18,"value":279},") ",{"type":13,"tag":38,"props":281,"children":282},{"style":85},[283],{"type":18,"value":284},"->",{"type":13,"tag":38,"props":286,"children":287},{"style":70},[288],{"type":18,"value":201},{"type":13,"tag":38,"props":290,"children":291},{"style":85},[292],{"type":18,"value":196},{"type":13,"tag":38,"props":294,"children":295},{"style":70},[296],{"type":18,"value":297},"Result",{"type":13,"tag":38,"props":299,"children":300},{"style":45},[301],{"type":18,"value":302},";\n",{"type":13,"tag":304,"props":305,"children":306},"ul",{},[307,318,338],{"type":13,"tag":308,"props":309,"children":310},"li",{},[311,316],{"type":13,"tag":34,"props":312,"children":314},{"className":313},[],[315],{"type":18,"value":73},{"type":18,"value":317}," is the logical device that created the semaphore being\nexported.",{"type":13,"tag":308,"props":319,"children":320},{},[321,327,329,336],{"type":13,"tag":34,"props":322,"children":324},{"className":323},[],[325],{"type":18,"value":326},"pGetZirconHandleInfo",{"type":18,"value":328}," is a pointer to a\n",{"type":13,"tag":330,"props":331,"children":333},"a",{"href":332},"/man/VkSemaphoreGetZirconHandleInfoFUCHSIA",[334],{"type":18,"value":335},"VkSemaphoreGetZirconHandleInfoFUCHSIA",{"type":18,"value":337}," structure containing\nparameters of the export operation.",{"type":13,"tag":308,"props":339,"children":340},{},[341,347],{"type":13,"tag":34,"props":342,"children":344},{"className":343},[],[345],{"type":18,"value":346},"pZirconHandle",{"type":18,"value":348}," will return the Zircon event handle representing the\nsemaphore payload.",{"type":13,"tag":14,"props":350,"children":351},{},[352,354,359,361,366,368,371],{"type":18,"value":353},"Each call to ",{"type":13,"tag":34,"props":355,"children":357},{"className":356},[],[358],{"type":18,"value":4},{"type":18,"value":360}," ",{"type":13,"tag":362,"props":363,"children":365},"normative",{"type":364},"must",[],{"type":18,"value":367}," create a Zircon\nevent handle and transfer ownership of it to the application.\nTo avoid leaking resources, the application ",{"type":13,"tag":362,"props":369,"children":370},{"type":364},[],{"type":18,"value":372}," release ownership of the\nZircon event handle when it is no longer needed.",{"type":13,"tag":374,"props":375,"children":376},"note",{},[377],{"type":13,"tag":14,"props":378,"children":379},{},[380],{"type":18,"value":381},"Ownership can be released in many ways.\nFor example, the application can call zx_handle_close() on the file\ndescriptor, or transfer ownership back to Vulkan by using the file\ndescriptor to import a semaphore payload.",{"type":13,"tag":14,"props":383,"children":384},{},[385,387,391,393,399],{"type":18,"value":386},"Exporting a Zircon event handle from a semaphore ",{"type":13,"tag":362,"props":388,"children":390},{"type":389},"may",[],{"type":18,"value":392}," have side effects\ndepending on the transference of the specified handle type, as described in\n",{"type":13,"tag":330,"props":394,"children":396},{"href":395},"/chapters/synchronization#synchronization-semaphores-importing",[397],{"type":18,"value":398},"Importing Semaphore State",{"type":18,"value":400},".",{"type":13,"tag":402,"props":403,"children":405},"validity-group",{"name":404},"Valid Usage (Implicit)",[406,433,457],{"type":13,"tag":407,"props":408,"children":410},"validity-field",{"name":409},"VUID-vkGetSemaphoreZirconHandleFUCHSIA-device-parameter",[411],{"type":13,"tag":14,"props":412,"children":413},{},[414,419,420,423,425,431],{"type":13,"tag":34,"props":415,"children":417},{"className":416},[],[418],{"type":18,"value":73},{"type":18,"value":360},{"type":13,"tag":362,"props":421,"children":422},{"type":364},[],{"type":18,"value":424}," be a valid ",{"type":13,"tag":330,"props":426,"children":428},{"href":427},"/man/VkDevice",[429],{"type":18,"value":430},"VkDevice",{"type":18,"value":432}," handle",{"type":13,"tag":407,"props":434,"children":436},{"name":435},"VUID-vkGetSemaphoreZirconHandleFUCHSIA-pGetZirconHandleInfo-parameter",[437],{"type":13,"tag":14,"props":438,"children":439},{},[440,445,446,449,451,455],{"type":13,"tag":34,"props":441,"children":443},{"className":442},[],[444],{"type":18,"value":326},{"type":18,"value":360},{"type":13,"tag":362,"props":447,"children":448},{"type":364},[],{"type":18,"value":450}," be a valid pointer to a valid ",{"type":13,"tag":330,"props":452,"children":453},{"href":332},[454],{"type":18,"value":335},{"type":18,"value":456}," structure",{"type":13,"tag":407,"props":458,"children":460},{"name":459},"VUID-vkGetSemaphoreZirconHandleFUCHSIA-pZirconHandle-parameter",[461],{"type":13,"tag":14,"props":462,"children":463},{},[464,469,470,473,475,481],{"type":13,"tag":34,"props":465,"children":467},{"className":466},[],[468],{"type":18,"value":346},{"type":18,"value":360},{"type":13,"tag":362,"props":471,"children":472},{"type":364},[],{"type":18,"value":474}," be a valid pointer to a ",{"type":13,"tag":34,"props":476,"children":478},{"className":477},[],[479],{"type":18,"value":480},"zx_handle_t",{"type":18,"value":482}," value",{"type":13,"tag":484,"props":485,"children":486},"style",{},[487],{"type":18,"value":488},"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":490},[],"markdown",1729612518872]