[{"data":1,"prerenderedAt":783},["ShallowReactive",2],{"$fR7K82BZQpwZ6ruNHymOWEpIsO6gmaH8Z413G-IpzntI":3},{"title":4,"description":5,"parent":6,"type":7,"xrefs":8,"body":9,"_type":782,"_id":4},"vkGetDeviceFaultReportsKHR","Reports fault information for the specified device","VK_KHR_device_fault","protos",[],{"type":10,"children":11,"toc":780},"root",[12,20,316,400,440,467,514,593,605,610,632,774],{"type":13,"tag":14,"props":15,"children":16},"element","p",{},[17],{"type":18,"value":19},"text","To retrieve diagnostic information about faults 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 vkGetDeviceFaultReportsKHR(\n    VkDevice device,\n    uint64_t timeout,\n    uint32_t* pFaultCounts,\n    VkDeviceFaultInfoKHR* pFaultInfo);\n","C","c","",[33],{"type":13,"tag":34,"props":35,"children":36},"code",{"__ignoreMap":31},[37,59,79,98,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},"    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],{"type":13,"tag":38,"props":84,"children":86},{"style":85},"--shiki-default:#CF222E;--shiki-dark:#FF7B72",[87],{"type":18,"value":88},"    uint64_t",{"type":13,"tag":38,"props":90,"children":91},{"style":70},[92],{"type":18,"value":93}," timeout",{"type":13,"tag":38,"props":95,"children":96},{"style":45},[97],{"type":18,"value":78},{"type":13,"tag":38,"props":99,"children":101},{"class":40,"line":100},4,[102,107,112],{"type":13,"tag":38,"props":103,"children":104},{"style":85},[105],{"type":18,"value":106},"    uint32_t*",{"type":13,"tag":38,"props":108,"children":109},{"style":70},[110],{"type":18,"value":111}," pFaultCounts",{"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},"    VkDeviceFaultInfoKHR",{"type":13,"tag":38,"props":126,"children":127},{"style":85},[128],{"type":18,"value":129},"*",{"type":13,"tag":38,"props":131,"children":132},{"style":70},[133],{"type":18,"value":134}," pFaultInfo",{"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_device_fault_reports_khr(\n    device: vk::Device,\n    timeout: u64,\n    p_fault_counts: *mut u32,\n    p_fault_info: *mut vk::DeviceFaultInfoKHR,\n) -> vk::Result;\n","Rust","rs",[147],{"type":13,"tag":34,"props":148,"children":149},{"__ignoreMap":31},[150,172,204,225,251,284],{"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":85},[156],{"type":18,"value":157},"pub",{"type":13,"tag":38,"props":159,"children":160},{"style":85},[161],{"type":18,"value":162}," fn",{"type":13,"tag":38,"props":164,"children":165},{"style":51},[166],{"type":18,"value":167}," get_device_fault_reports_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},"    device",{"type":13,"tag":38,"props":181,"children":182},{"style":85},[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":85},[193],{"type":18,"value":194},"::",{"type":13,"tag":38,"props":196,"children":197},{"style":70},[198],{"type":18,"value":199},"Device",{"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,221],{"type":13,"tag":38,"props":208,"children":209},{"style":45},[210],{"type":18,"value":211},"    timeout",{"type":13,"tag":38,"props":213,"children":214},{"style":85},[215],{"type":18,"value":184},{"type":13,"tag":38,"props":217,"children":218},{"style":70},[219],{"type":18,"value":220}," u64",{"type":13,"tag":38,"props":222,"children":223},{"style":45},[224],{"type":18,"value":78},{"type":13,"tag":38,"props":226,"children":227},{"class":40,"line":100},[228,233,237,242,247],{"type":13,"tag":38,"props":229,"children":230},{"style":45},[231],{"type":18,"value":232},"    p_fault_counts",{"type":13,"tag":38,"props":234,"children":235},{"style":85},[236],{"type":18,"value":184},{"type":13,"tag":38,"props":238,"children":239},{"style":85},[240],{"type":18,"value":241}," *mut",{"type":13,"tag":38,"props":243,"children":244},{"style":70},[245],{"type":18,"value":246}," u32",{"type":13,"tag":38,"props":248,"children":249},{"style":45},[250],{"type":18,"value":78},{"type":13,"tag":38,"props":252,"children":253},{"class":40,"line":118},[254,259,263,267,271,275,280],{"type":13,"tag":38,"props":255,"children":256},{"style":45},[257],{"type":18,"value":258},"    p_fault_info",{"type":13,"tag":38,"props":260,"children":261},{"style":85},[262],{"type":18,"value":184},{"type":13,"tag":38,"props":264,"children":265},{"style":85},[266],{"type":18,"value":241},{"type":13,"tag":38,"props":268,"children":269},{"style":70},[270],{"type":18,"value":189},{"type":13,"tag":38,"props":272,"children":273},{"style":85},[274],{"type":18,"value":194},{"type":13,"tag":38,"props":276,"children":277},{"style":70},[278],{"type":18,"value":279},"DeviceFaultInfoKHR",{"type":13,"tag":38,"props":281,"children":282},{"style":45},[283],{"type":18,"value":78},{"type":13,"tag":38,"props":285,"children":287},{"class":40,"line":286},6,[288,293,298,302,306,311],{"type":13,"tag":38,"props":289,"children":290},{"style":45},[291],{"type":18,"value":292},") ",{"type":13,"tag":38,"props":294,"children":295},{"style":85},[296],{"type":18,"value":297},"->",{"type":13,"tag":38,"props":299,"children":300},{"style":70},[301],{"type":18,"value":189},{"type":13,"tag":38,"props":303,"children":304},{"style":85},[305],{"type":18,"value":194},{"type":13,"tag":38,"props":307,"children":308},{"style":70},[309],{"type":18,"value":310},"Result",{"type":13,"tag":38,"props":312,"children":313},{"style":45},[314],{"type":18,"value":315},";\n",{"type":13,"tag":317,"props":318,"children":319},"ul",{},[320,331,361,372],{"type":13,"tag":321,"props":322,"children":323},"li",{},[324,329],{"type":13,"tag":34,"props":325,"children":327},{"className":326},[],[328],{"type":18,"value":73},{"type":18,"value":330}," is the logical device from which to query the diagnostic\nfault information.",{"type":13,"tag":321,"props":332,"children":333},{},[334,340,342,347,349,354,356,359],{"type":13,"tag":34,"props":335,"children":337},{"className":336},[],[338],{"type":18,"value":339},"timeout",{"type":18,"value":341}," is the timeout period in units of nanoseconds.\n",{"type":13,"tag":34,"props":343,"children":345},{"className":344},[],[346],{"type":18,"value":339},{"type":18,"value":348}," is adjusted to the closest value allowed by the\nimplementation-dependent timeout accuracy, which ",{"type":13,"tag":350,"props":351,"children":353},"normative",{"type":352},"may",[],{"type":18,"value":355}," be substantially\nlonger than one nanosecond, and ",{"type":13,"tag":350,"props":357,"children":358},{"type":352},[],{"type":18,"value":360}," be longer than the requested\nperiod.",{"type":13,"tag":321,"props":362,"children":363},{},[364,370],{"type":13,"tag":34,"props":365,"children":367},{"className":366},[],[368],{"type":18,"value":369},"pFaultCount",{"type":18,"value":371}," is a pointer to an integer related to the number of\nfault reports available or queried, as described below.",{"type":13,"tag":321,"props":373,"children":374},{},[375,381,383,389,391,398],{"type":13,"tag":34,"props":376,"children":378},{"className":377},[],[379],{"type":18,"value":380},"pFaultInfo",{"type":18,"value":382}," is ",{"type":13,"tag":34,"props":384,"children":386},{"className":385},[],[387],{"type":18,"value":388},"NULL",{"type":18,"value":390}," or a pointer to an array of\n",{"type":13,"tag":392,"props":393,"children":395},"a",{"href":394},"/man/VkDeviceFaultInfoKHR",[396],{"type":18,"value":397},"VkDeviceFaultInfoKHR",{"type":18,"value":399}," structures in which fault information is\nreturned.",{"type":13,"tag":14,"props":401,"children":402},{},[403,405,410,412,417,419,424,426,431,433,438],{"type":18,"value":404},"If at least one fault report is available when\n",{"type":13,"tag":34,"props":406,"children":408},{"className":407},[],[409],{"type":18,"value":4},{"type":18,"value":411}," is called, then\n",{"type":13,"tag":34,"props":413,"children":415},{"className":414},[],[416],{"type":18,"value":4},{"type":18,"value":418}," returns immediately.\nIf no faults have occurred at the time ",{"type":13,"tag":34,"props":420,"children":422},{"className":421},[],[423],{"type":18,"value":4},{"type":18,"value":425}," is\ncalled, then ",{"type":13,"tag":34,"props":427,"children":429},{"className":428},[],[430],{"type":18,"value":4},{"type":18,"value":432}," will block and wait until a\nfault occurs and a report becomes available or until the ",{"type":13,"tag":34,"props":434,"children":436},{"className":435},[],[437],{"type":18,"value":339},{"type":18,"value":439}," has\nexpired, whichever is sooner.",{"type":13,"tag":14,"props":441,"children":442},{},[443,445,450,452,457,459,465],{"type":18,"value":444},"If ",{"type":13,"tag":34,"props":446,"children":448},{"className":447},[],[449],{"type":18,"value":339},{"type":18,"value":451}," is zero, then ",{"type":13,"tag":34,"props":453,"children":455},{"className":454},[],[456],{"type":18,"value":4},{"type":18,"value":458}," does not\nwait, but simply returns the current fault count and reports.\n",{"type":13,"tag":34,"props":460,"children":462},{"className":461},[],[463],{"type":18,"value":464},"VK_TIMEOUT",{"type":18,"value":466}," will be returned in this case if no faults have occurred,\neven though no actual wait was performed.",{"type":13,"tag":14,"props":468,"children":469},{},[470,472,477,479,484,486,492,494,499,500,505,507,512],{"type":18,"value":471},"If a fault has occurred before the ",{"type":13,"tag":34,"props":473,"children":475},{"className":474},[],[476],{"type":18,"value":339},{"type":18,"value":478}," has expired,\n",{"type":13,"tag":34,"props":480,"children":482},{"className":481},[],[483],{"type":18,"value":4},{"type":18,"value":485}," returns ",{"type":13,"tag":34,"props":487,"children":489},{"className":488},[],[490],{"type":18,"value":491},"VK_SUCCESS",{"type":18,"value":493},".\nOtherwise, ",{"type":13,"tag":34,"props":495,"children":497},{"className":496},[],[498],{"type":18,"value":4},{"type":18,"value":485},{"type":13,"tag":34,"props":501,"children":503},{"className":502},[],[504],{"type":18,"value":464},{"type":18,"value":506}," after\nthe ",{"type":13,"tag":34,"props":508,"children":510},{"className":509},[],[511],{"type":18,"value":339},{"type":18,"value":513}," has expired.",{"type":13,"tag":14,"props":515,"children":516},{},[517,518,523,524,529,531,536,537,542,544,548,550,555,557,562,564,569,571,576,578,584,586,591],{"type":18,"value":444},{"type":13,"tag":34,"props":519,"children":521},{"className":520},[],[522],{"type":18,"value":380},{"type":18,"value":382},{"type":13,"tag":34,"props":525,"children":527},{"className":526},[],[528],{"type":18,"value":388},{"type":18,"value":530},", then the number of fault reports available is\nreturned in ",{"type":13,"tag":34,"props":532,"children":534},{"className":533},[],[535],{"type":18,"value":369},{"type":18,"value":493},{"type":13,"tag":34,"props":538,"children":540},{"className":539},[],[541],{"type":18,"value":369},{"type":18,"value":543}," ",{"type":13,"tag":350,"props":545,"children":547},{"type":546},"must",[],{"type":18,"value":549}," point to a variable set by the\napplication to the number of elements in the ",{"type":13,"tag":34,"props":551,"children":553},{"className":552},[],[554],{"type":18,"value":380},{"type":18,"value":556}," array, and on\nreturn the variable is overwritten with the number of handles actually\nwritten to ",{"type":13,"tag":34,"props":558,"children":560},{"className":559},[],[561],{"type":18,"value":380},{"type":18,"value":563},".\nIf ",{"type":13,"tag":34,"props":565,"children":567},{"className":566},[],[568],{"type":18,"value":369},{"type":18,"value":570}," is less than the number of fault reports available, at\nmost ",{"type":13,"tag":34,"props":572,"children":574},{"className":573},[],[575],{"type":18,"value":369},{"type":18,"value":577}," structures will be written, and ",{"type":13,"tag":34,"props":579,"children":581},{"className":580},[],[582],{"type":18,"value":583},"VK_INCOMPLETE",{"type":18,"value":585},"\nwill be returned instead of ",{"type":13,"tag":34,"props":587,"children":589},{"className":588},[],[590],{"type":18,"value":491},{"type":18,"value":592},", to indicate that not all the\navailable fault reports were returned.",{"type":13,"tag":14,"props":594,"children":595},{},[596,598,603],{"type":18,"value":597},"If more than one fault report is available, they will be returned in order\nof occurrence via ",{"type":13,"tag":34,"props":599,"children":601},{"className":600},[],[602],{"type":18,"value":380},{"type":18,"value":604},".",{"type":13,"tag":14,"props":606,"children":607},{},[608],{"type":18,"value":609},"Each individual fault report is returned exactly once.",{"type":13,"tag":14,"props":611,"children":612},{},[613,618,620,623,625,630],{"type":13,"tag":34,"props":614,"children":616},{"className":615},[],[617],{"type":18,"value":4},{"type":18,"value":619},"() ",{"type":13,"tag":350,"props":621,"children":622},{"type":352},[],{"type":18,"value":624}," be invoked in parallel on different\nthreads, in which case each invocation for a given ",{"type":13,"tag":34,"props":626,"children":628},{"className":627},[],[629],{"type":18,"value":73},{"type":18,"value":631}," will return\na unique set of reports.\nNo fault report being returned to more than one invocation.",{"type":13,"tag":633,"props":634,"children":636},"validity-group",{"name":635},"Valid Usage (Implicit)",[637,664,691,736],{"type":13,"tag":638,"props":639,"children":641},"validity-field",{"name":640},"VUID-vkGetDeviceFaultReportsKHR-device-parameter",[642],{"type":13,"tag":14,"props":643,"children":644},{},[645,650,651,654,656,662],{"type":13,"tag":34,"props":646,"children":648},{"className":647},[],[649],{"type":18,"value":73},{"type":18,"value":543},{"type":13,"tag":350,"props":652,"children":653},{"type":546},[],{"type":18,"value":655}," be a valid ",{"type":13,"tag":392,"props":657,"children":659},{"href":658},"/man/VkDevice",[660],{"type":18,"value":661},"VkDevice",{"type":18,"value":663}," handle",{"type":13,"tag":638,"props":665,"children":667},{"name":666},"VUID-vkGetDeviceFaultReportsKHR-pFaultCounts-parameter",[668],{"type":13,"tag":14,"props":669,"children":670},{},[671,677,678,681,683,689],{"type":13,"tag":34,"props":672,"children":674},{"className":673},[],[675],{"type":18,"value":676},"pFaultCounts",{"type":18,"value":543},{"type":13,"tag":350,"props":679,"children":680},{"type":546},[],{"type":18,"value":682}," be a valid pointer to a ",{"type":13,"tag":34,"props":684,"children":686},{"className":685},[],[687],{"type":18,"value":688},"uint32_t",{"type":18,"value":690}," value",{"type":13,"tag":638,"props":692,"children":694},{"name":693},"VUID-vkGetDeviceFaultReportsKHR-pFaultInfo-parameter",[695],{"type":13,"tag":14,"props":696,"children":697},{},[698,699,704,706,711,713,718,719,722,724,729,730,734],{"type":18,"value":444},{"type":13,"tag":34,"props":700,"children":702},{"className":701},[],[703],{"type":18,"value":380},{"type":18,"value":705}," is not ",{"type":13,"tag":34,"props":707,"children":709},{"className":708},[],[710],{"type":18,"value":388},{"type":18,"value":712},", ",{"type":13,"tag":34,"props":714,"children":716},{"className":715},[],[717],{"type":18,"value":380},{"type":18,"value":543},{"type":13,"tag":350,"props":720,"children":721},{"type":546},[],{"type":18,"value":723}," be a valid pointer to an array of ",{"type":13,"tag":34,"props":725,"children":727},{"className":726},[],[728],{"type":18,"value":676},{"type":18,"value":543},{"type":13,"tag":392,"props":731,"children":732},{"href":394},[733],{"type":18,"value":397},{"type":18,"value":735}," structures",{"type":13,"tag":638,"props":737,"children":739},{"name":738},"VUID-vkGetDeviceFaultReportsKHR-pFaultCounts-arraylength",[740],{"type":13,"tag":14,"props":741,"children":742},{},[743,744,749,750,755,757,762,763,766,768],{"type":18,"value":444},{"type":13,"tag":34,"props":745,"children":747},{"className":746},[],[748],{"type":18,"value":380},{"type":18,"value":705},{"type":13,"tag":34,"props":751,"children":753},{"className":752},[],[754],{"type":18,"value":388},{"type":18,"value":756},", the value referenced by ",{"type":13,"tag":34,"props":758,"children":760},{"className":759},[],[761],{"type":18,"value":676},{"type":18,"value":543},{"type":13,"tag":350,"props":764,"children":765},{"type":546},[],{"type":18,"value":767}," be greater than ",{"type":13,"tag":34,"props":769,"children":771},{"className":770},[],[772],{"type":18,"value":773},"0",{"type":13,"tag":775,"props":776,"children":777},"style",{},[778],{"type":18,"value":779},"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":781},[],"markdown",1773997302370]