| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151215221532154215521562157215821592160216121622163216421652166216721682169217021712172217321742175217621772178217921802181218221832184218521862187218821892190219121922193219421952196219721982199220022012202220322042205220622072208220922102211221222132214221522162217221822192220222122222223222422252226222722282229223022312232223322342235223622372238223922402241224222432244224522462247224822492250225122522253225422552256225722582259226022612262226322642265226622672268226922702271227222732274227522762277227822792280228122822283228422852286228722882289229022912292229322942295229622972298229923002301230223032304230523062307230823092310231123122313231423152316231723182319232023212322232323242325232623272328232923302331233223332334233523362337233823392340234123422343234423452346234723482349235023512352235323542355235623572358235923602361236223632364236523662367236823692370237123722373237423752376237723782379238023812382238323842385238623872388238923902391239223932394239523962397239823992400240124022403240424052406240724082409241024112412241324142415241624172418241924202421242224232424242524262427242824292430243124322433243424352436243724382439244024412442244324442445244624472448244924502451245224532454245524562457245824592460246124622463246424652466246724682469247024712472247324742475247624772478247924802481248224832484248524862487248824892490249124922493249424952496249724982499250025012502250325042505250625072508250925102511251225132514251525162517251825192520252125222523252425252526252725282529253025312532253325342535253625372538253925402541254225432544254525462547254825492550255125522553255425552556255725582559256025612562256325642565256625672568256925702571257225732574257525762577257825792580258125822583258425852586258725882589259025912592259325942595259625972598259926002601260226032604260526062607260826092610261126122613261426152616261726182619262026212622262326242625262626272628262926302631263226332634263526362637263826392640264126422643264426452646264726482649265026512652265326542655265626572658265926602661266226632664266526662667266826692670267126722673267426752676267726782679268026812682268326842685268626872688268926902691269226932694269526962697269826992700270127022703270427052706270727082709271027112712271327142715271627172718271927202721272227232724272527262727272827292730273127322733273427352736273727382739274027412742274327442745274627472748274927502751275227532754275527562757275827592760276127622763276427652766276727682769277027712772277327742775277627772778277927802781278227832784278527862787278827892790279127922793279427952796279727982799280028012802280328042805280628072808280928102811281228132814281528162817281828192820282128222823282428252826282728282829283028312832283328342835283628372838283928402841284228432844284528462847284828492850285128522853285428552856285728582859286028612862286328642865286628672868286928702871287228732874287528762877287828792880288128822883288428852886288728882889289028912892289328942895289628972898289929002901290229032904290529062907290829092910291129122913291429152916291729182919292029212922292329242925292629272928292929302931293229332934293529362937293829392940294129422943294429452946294729482949295029512952295329542955295629572958295929602961296229632964296529662967296829692970297129722973297429752976297729782979298029812982298329842985298629872988298929902991299229932994299529962997299829993000300130023003300430053006300730083009301030113012301330143015301630173018301930203021302230233024302530263027302830293030303130323033303430353036303730383039304030413042304330443045304630473048304930503051305230533054305530563057305830593060306130623063306430653066306730683069307030713072307330743075307630773078307930803081308230833084308530863087308830893090309130923093309430953096309730983099310031013102310331043105310631073108310931103111311231133114311531163117311831193120312131223123312431253126312731283129313031313132313331343135313631373138313931403141314231433144314531463147314831493150315131523153315431553156315731583159316031613162316331643165316631673168316931703171317231733174317531763177317831793180318131823183318431853186318731883189319031913192319331943195319631973198319932003201320232033204320532063207320832093210321132123213321432153216321732183219322032213222322332243225322632273228322932303231323232333234323532363237323832393240324132423243324432453246324732483249325032513252325332543255325632573258325932603261326232633264326532663267326832693270327132723273327432753276327732783279328032813282328332843285328632873288328932903291329232933294329532963297329832993300330133023303330433053306330733083309331033113312331333143315331633173318331933203321332233233324332533263327332833293330333133323333333433353336333733383339334033413342334333443345334633473348334933503351335233533354335533563357335833593360336133623363336433653366336733683369337033713372337333743375337633773378337933803381338233833384338533863387338833893390339133923393339433953396339733983399340034013402340334043405340634073408340934103411341234133414341534163417341834193420342134223423342434253426342734283429343034313432343334343435343634373438343934403441344234433444344534463447344834493450345134523453345434553456345734583459346034613462346334643465346634673468346934703471347234733474347534763477347834793480348134823483348434853486348734883489349034913492349334943495349634973498349935003501350235033504350535063507350835093510351135123513351435153516351735183519352035213522352335243525352635273528352935303531353235333534353535363537353835393540354135423543354435453546354735483549355035513552355335543555355635573558355935603561356235633564356535663567356835693570357135723573357435753576357735783579358035813582358335843585358635873588358935903591359235933594359535963597359835993600360136023603360436053606360736083609361036113612361336143615361636173618361936203621362236233624362536263627362836293630363136323633363436353636363736383639364036413642364336443645364636473648364936503651365236533654365536563657365836593660366136623663366436653666366736683669367036713672367336743675367636773678367936803681368236833684368536863687368836893690369136923693369436953696369736983699370037013702370337043705370637073708370937103711371237133714371537163717371837193720372137223723372437253726372737283729373037313732373337343735373637373738373937403741374237433744374537463747374837493750375137523753375437553756375737583759376037613762376337643765376637673768376937703771377237733774377537763777377837793780378137823783378437853786378737883789379037913792379337943795379637973798379938003801380238033804380538063807380838093810381138123813381438153816381738183819382038213822382338243825382638273828382938303831383238333834383538363837383838393840384138423843384438453846384738483849385038513852385338543855385638573858385938603861386238633864386538663867386838693870387138723873387438753876387738783879388038813882388338843885388638873888388938903891389238933894389538963897389838993900390139023903390439053906390739083909391039113912391339143915391639173918391939203921392239233924392539263927392839293930393139323933393439353936393739383939394039413942394339443945394639473948394939503951395239533954395539563957395839593960396139623963396439653966396739683969397039713972397339743975397639773978397939803981398239833984398539863987398839893990399139923993399439953996399739983999400040014002400340044005400640074008400940104011401240134014401540164017401840194020402140224023402440254026402740284029403040314032403340344035403640374038403940404041404240434044404540464047404840494050405140524053405440554056405740584059406040614062406340644065406640674068406940704071407240734074407540764077407840794080408140824083408440854086408740884089409040914092409340944095409640974098409941004101410241034104410541064107410841094110411141124113411441154116411741184119412041214122412341244125412641274128412941304131413241334134413541364137413841394140414141424143414441454146414741484149415041514152415341544155415641574158415941604161416241634164416541664167416841694170417141724173417441754176417741784179418041814182418341844185418641874188418941904191419241934194419541964197419841994200420142024203420442054206420742084209421042114212421342144215421642174218421942204221422242234224422542264227422842294230423142324233423442354236423742384239424042414242424342444245424642474248424942504251425242534254425542564257425842594260426142624263426442654266426742684269427042714272427342744275427642774278427942804281428242834284428542864287428842894290429142924293429442954296429742984299430043014302430343044305430643074308430943104311431243134314431543164317431843194320432143224323432443254326432743284329433043314332433343344335433643374338433943404341434243434344434543464347434843494350435143524353435443554356435743584359436043614362436343644365436643674368436943704371437243734374437543764377437843794380438143824383438443854386438743884389439043914392439343944395439643974398439944004401440244034404440544064407440844094410441144124413441444154416441744184419442044214422442344244425442644274428442944304431443244334434443544364437443844394440444144424443444444454446444744484449445044514452445344544455445644574458445944604461446244634464446544664467446844694470447144724473447444754476447744784479448044814482448344844485448644874488448944904491449244934494449544964497449844994500450145024503450445054506450745084509451045114512451345144515451645174518451945204521452245234524452545264527452845294530453145324533453445354536453745384539454045414542454345444545454645474548454945504551455245534554455545564557455845594560456145624563456445654566456745684569457045714572457345744575457645774578457945804581458245834584458545864587458845894590459145924593459445954596459745984599460046014602460346044605460646074608460946104611461246134614461546164617461846194620462146224623462446254626462746284629463046314632463346344635463646374638463946404641464246434644464546464647464846494650465146524653465446554656465746584659466046614662466346644665466646674668466946704671467246734674467546764677467846794680468146824683468446854686468746884689469046914692469346944695469646974698469947004701470247034704470547064707470847094710471147124713471447154716471747184719472047214722472347244725472647274728472947304731473247334734473547364737473847394740474147424743474447454746474747484749475047514752475347544755475647574758475947604761476247634764476547664767476847694770477147724773477447754776477747784779478047814782478347844785478647874788478947904791479247934794479547964797479847994800480148024803480448054806480748084809481048114812481348144815481648174818481948204821482248234824482548264827482848294830483148324833483448354836483748384839484048414842484348444845484648474848484948504851485248534854485548564857485848594860486148624863486448654866486748684869487048714872487348744875487648774878487948804881488248834884488548864887488848894890489148924893489448954896489748984899490049014902490349044905490649074908490949104911491249134914491549164917491849194920492149224923492449254926492749284929493049314932493349344935493649374938493949404941494249434944494549464947494849494950495149524953495449554956495749584959496049614962496349644965496649674968496949704971497249734974497549764977497849794980498149824983498449854986498749884989499049914992499349944995499649974998499950005001500250035004500550065007500850095010501150125013501450155016501750185019502050215022502350245025502650275028502950305031503250335034503550365037503850395040504150425043504450455046504750485049505050515052505350545055505650575058505950605061506250635064506550665067506850695070507150725073507450755076507750785079508050815082508350845085508650875088508950905091509250935094509550965097509850995100510151025103510451055106510751085109511051115112511351145115511651175118511951205121512251235124512551265127512851295130513151325133513451355136513751385139514051415142514351445145514651475148514951505151515251535154515551565157515851595160516151625163516451655166516751685169517051715172517351745175517651775178517951805181518251835184518551865187518851895190519151925193519451955196519751985199520052015202520352045205520652075208520952105211521252135214521552165217521852195220522152225223522452255226522752285229523052315232523352345235523652375238523952405241524252435244524552465247524852495250525152525253525452555256525752585259526052615262526352645265526652675268526952705271527252735274527552765277527852795280528152825283528452855286528752885289529052915292529352945295529652975298529953005301530253035304530553065307530853095310531153125313531453155316531753185319532053215322532353245325532653275328532953305331533253335334533553365337533853395340534153425343534453455346534753485349535053515352535353545355535653575358535953605361536253635364536553665367536853695370537153725373537453755376537753785379538053815382538353845385538653875388538953905391539253935394539553965397539853995400540154025403540454055406540754085409541054115412541354145415541654175418541954205421542254235424542554265427542854295430543154325433543454355436543754385439544054415442544354445445544654475448544954505451545254535454545554565457545854595460546154625463546454655466546754685469547054715472547354745475547654775478547954805481548254835484548554865487548854895490549154925493549454955496549754985499550055015502550355045505550655075508550955105511551255135514551555165517551855195520552155225523552455255526552755285529553055315532553355345535553655375538553955405541554255435544554555465547554855495550555155525553555455555556555755585559556055615562556355645565556655675568556955705571557255735574557555765577557855795580558155825583558455855586558755885589559055915592559355945595559655975598559956005601560256035604560556065607560856095610561156125613561456155616561756185619562056215622562356245625562656275628562956305631563256335634563556365637563856395640564156425643564456455646564756485649565056515652565356545655565656575658565956605661566256635664566556665667566856695670567156725673567456755676567756785679568056815682568356845685568656875688568956905691569256935694569556965697569856995700570157025703570457055706570757085709571057115712571357145715571657175718571957205721572257235724572557265727572857295730573157325733573457355736573757385739574057415742574357445745574657475748574957505751575257535754575557565757575857595760576157625763576457655766576757685769577057715772577357745775577657775778577957805781578257835784578557865787578857895790579157925793579457955796579757985799580058015802580358045805580658075808580958105811581258135814581558165817581858195820582158225823582458255826582758285829583058315832583358345835583658375838583958405841584258435844584558465847584858495850585158525853585458555856585758585859586058615862586358645865586658675868586958705871587258735874587558765877587858795880588158825883588458855886588758885889589058915892589358945895589658975898589959005901590259035904590559065907590859095910591159125913591459155916591759185919592059215922592359245925592659275928592959305931593259335934593559365937593859395940594159425943594459455946594759485949595059515952595359545955595659575958595959605961596259635964596559665967596859695970597159725973597459755976597759785979598059815982598359845985598659875988598959905991599259935994599559965997599859996000600160026003600460056006600760086009601060116012601360146015601660176018601960206021602260236024602560266027602860296030603160326033603460356036603760386039604060416042604360446045604660476048604960506051605260536054605560566057605860596060606160626063606460656066606760686069607060716072607360746075607660776078607960806081608260836084608560866087608860896090609160926093609460956096609760986099610061016102610361046105610661076108610961106111611261136114611561166117611861196120612161226123612461256126612761286129613061316132613361346135613661376138613961406141614261436144614561466147614861496150615161526153615461556156615761586159616061616162616361646165616661676168616961706171617261736174617561766177617861796180618161826183618461856186618761886189619061916192619361946195619661976198619962006201620262036204620562066207620862096210621162126213621462156216621762186219622062216222622362246225622662276228622962306231623262336234623562366237623862396240624162426243624462456246624762486249625062516252625362546255625662576258625962606261626262636264626562666267626862696270627162726273627462756276627762786279628062816282628362846285628662876288628962906291629262936294629562966297629862996300630163026303630463056306630763086309631063116312631363146315631663176318631963206321632263236324632563266327632863296330633163326333633463356336633763386339634063416342634363446345634663476348634963506351635263536354635563566357635863596360636163626363636463656366636763686369637063716372637363746375637663776378637963806381638263836384638563866387638863896390639163926393639463956396639763986399640064016402640364046405640664076408640964106411641264136414641564166417641864196420642164226423642464256426642764286429643064316432643364346435643664376438643964406441644264436444644564466447644864496450645164526453645464556456645764586459646064616462646364646465646664676468646964706471647264736474647564766477647864796480648164826483648464856486648764886489649064916492649364946495649664976498649965006501650265036504650565066507650865096510651165126513651465156516651765186519652065216522652365246525652665276528652965306531653265336534653565366537653865396540654165426543654465456546654765486549655065516552655365546555655665576558655965606561656265636564656565666567656865696570657165726573657465756576657765786579658065816582658365846585658665876588658965906591659265936594659565966597659865996600660166026603660466056606660766086609661066116612661366146615661666176618661966206621662266236624662566266627662866296630663166326633663466356636663766386639664066416642664366446645664666476648664966506651665266536654665566566657665866596660666166626663666466656666666766686669667066716672667366746675667666776678667966806681668266836684668566866687668866896690669166926693669466956696669766986699670067016702670367046705670667076708670967106711671267136714671567166717671867196720672167226723672467256726672767286729673067316732673367346735673667376738673967406741674267436744674567466747674867496750675167526753675467556756675767586759676067616762676367646765676667676768676967706771677267736774677567766777677867796780678167826783678467856786678767886789679067916792679367946795679667976798679968006801680268036804680568066807680868096810681168126813681468156816681768186819682068216822682368246825682668276828682968306831683268336834683568366837683868396840684168426843684468456846684768486849685068516852685368546855685668576858685968606861686268636864686568666867686868696870687168726873687468756876687768786879688068816882688368846885688668876888688968906891689268936894689568966897689868996900690169026903690469056906690769086909691069116912691369146915691669176918691969206921692269236924692569266927692869296930693169326933693469356936693769386939694069416942694369446945694669476948694969506951695269536954695569566957695869596960696169626963696469656966696769686969697069716972697369746975697669776978697969806981698269836984698569866987698869896990699169926993699469956996699769986999700070017002700370047005700670077008700970107011701270137014701570167017701870197020702170227023702470257026702770287029703070317032703370347035703670377038703970407041704270437044704570467047704870497050705170527053705470557056705770587059706070617062706370647065706670677068706970707071707270737074707570767077707870797080708170827083708470857086708770887089709070917092709370947095709670977098709971007101710271037104710571067107710871097110711171127113711471157116711771187119712071217122712371247125712671277128712971307131713271337134713571367137713871397140714171427143714471457146714771487149715071517152715371547155715671577158715971607161716271637164716571667167716871697170717171727173717471757176717771787179718071817182718371847185718671877188718971907191719271937194719571967197719871997200720172027203720472057206720772087209721072117212721372147215721672177218721972207221722272237224722572267227722872297230723172327233723472357236723772387239724072417242724372447245724672477248724972507251725272537254725572567257725872597260726172627263726472657266726772687269727072717272727372747275727672777278727972807281728272837284728572867287728872897290729172927293729472957296729772987299730073017302730373047305730673077308730973107311731273137314731573167317731873197320732173227323732473257326732773287329733073317332733373347335733673377338733973407341734273437344734573467347734873497350735173527353735473557356735773587359736073617362736373647365736673677368736973707371737273737374737573767377737873797380738173827383738473857386738773887389739073917392739373947395739673977398739974007401740274037404740574067407740874097410741174127413741474157416741774187419742074217422742374247425742674277428742974307431743274337434743574367437743874397440744174427443744474457446744774487449745074517452745374547455745674577458745974607461746274637464746574667467746874697470747174727473747474757476747774787479748074817482748374847485748674877488748974907491749274937494749574967497749874997500750175027503750475057506750775087509751075117512751375147515751675177518751975207521752275237524752575267527752875297530753175327533753475357536753775387539754075417542754375447545754675477548754975507551755275537554755575567557755875597560756175627563756475657566756775687569757075717572757375747575757675777578757975807581758275837584758575867587758875897590759175927593759475957596759775987599760076017602760376047605760676077608760976107611761276137614761576167617761876197620762176227623762476257626762776287629763076317632763376347635763676377638763976407641764276437644764576467647764876497650765176527653765476557656765776587659766076617662766376647665766676677668766976707671767276737674767576767677767876797680768176827683768476857686768776887689769076917692769376947695769676977698769977007701770277037704770577067707770877097710771177127713771477157716771777187719772077217722772377247725772677277728772977307731773277337734773577367737773877397740774177427743774477457746774777487749775077517752775377547755775677577758775977607761776277637764776577667767776877697770777177727773777477757776777777787779778077817782778377847785778677877788778977907791779277937794779577967797779877997800780178027803780478057806780778087809781078117812781378147815781678177818781978207821782278237824782578267827782878297830783178327833783478357836783778387839784078417842784378447845784678477848784978507851785278537854785578567857785878597860786178627863786478657866786778687869787078717872787378747875787678777878787978807881788278837884788578867887788878897890789178927893789478957896789778987899790079017902790379047905790679077908790979107911791279137914791579167917791879197920792179227923792479257926792779287929793079317932793379347935793679377938793979407941794279437944794579467947794879497950795179527953795479557956795779587959796079617962796379647965796679677968796979707971797279737974797579767977797879797980798179827983798479857986798779887989799079917992799379947995799679977998799980008001800280038004800580068007800880098010801180128013801480158016801780188019802080218022802380248025802680278028802980308031803280338034803580368037803880398040804180428043804480458046804780488049805080518052805380548055805680578058805980608061806280638064806580668067806880698070807180728073807480758076807780788079808080818082808380848085808680878088808980908091809280938094809580968097809880998100810181028103810481058106810781088109811081118112811381148115811681178118811981208121812281238124812581268127812881298130813181328133813481358136813781388139814081418142814381448145814681478148814981508151815281538154815581568157815881598160816181628163816481658166816781688169817081718172817381748175817681778178817981808181818281838184818581868187818881898190819181928193819481958196819781988199820082018202820382048205820682078208820982108211821282138214821582168217821882198220822182228223822482258226822782288229823082318232823382348235823682378238823982408241824282438244824582468247824882498250825182528253825482558256825782588259826082618262826382648265826682678268826982708271827282738274827582768277827882798280828182828283828482858286828782888289829082918292829382948295829682978298829983008301830283038304830583068307830883098310831183128313831483158316831783188319832083218322832383248325832683278328832983308331833283338334833583368337833883398340834183428343834483458346834783488349835083518352835383548355835683578358835983608361836283638364836583668367836883698370837183728373837483758376837783788379838083818382838383848385838683878388838983908391839283938394839583968397839883998400840184028403840484058406840784088409841084118412841384148415841684178418841984208421842284238424842584268427842884298430843184328433843484358436843784388439844084418442844384448445844684478448844984508451845284538454845584568457845884598460846184628463846484658466846784688469847084718472847384748475847684778478847984808481848284838484848584868487848884898490849184928493849484958496849784988499850085018502850385048505850685078508850985108511851285138514851585168517851885198520852185228523852485258526852785288529853085318532853385348535853685378538853985408541854285438544854585468547854885498550855185528553855485558556855785588559856085618562856385648565856685678568856985708571857285738574857585768577857885798580858185828583858485858586858785888589859085918592859385948595859685978598859986008601860286038604860586068607860886098610861186128613861486158616861786188619862086218622862386248625862686278628862986308631863286338634863586368637863886398640864186428643864486458646864786488649865086518652865386548655865686578658865986608661866286638664866586668667866886698670867186728673867486758676867786788679868086818682868386848685868686878688868986908691869286938694869586968697869886998700870187028703870487058706870787088709871087118712871387148715871687178718871987208721872287238724872587268727872887298730873187328733873487358736873787388739874087418742874387448745874687478748874987508751875287538754875587568757875887598760876187628763876487658766876787688769877087718772877387748775877687778778877987808781878287838784878587868787878887898790879187928793879487958796879787988799880088018802880388048805880688078808880988108811881288138814881588168817881888198820882188228823882488258826882788288829883088318832883388348835883688378838883988408841884288438844884588468847884888498850885188528853885488558856885788588859886088618862886388648865886688678868886988708871887288738874887588768877887888798880888188828883888488858886888788888889889088918892889388948895889688978898889989008901890289038904890589068907890889098910891189128913891489158916891789188919892089218922892389248925892689278928892989308931893289338934893589368937893889398940894189428943894489458946894789488949895089518952895389548955895689578958895989608961896289638964896589668967896889698970897189728973897489758976897789788979898089818982898389848985898689878988898989908991899289938994899589968997899889999000900190029003900490059006900790089009901090119012901390149015901690179018901990209021902290239024902590269027902890299030903190329033903490359036903790389039904090419042904390449045904690479048904990509051905290539054905590569057905890599060906190629063906490659066906790689069907090719072907390749075907690779078907990809081908290839084908590869087908890899090909190929093909490959096909790989099910091019102910391049105910691079108910991109111911291139114911591169117911891199120912191229123912491259126912791289129913091319132913391349135913691379138913991409141914291439144914591469147914891499150915191529153915491559156915791589159916091619162916391649165916691679168916991709171917291739174917591769177917891799180918191829183918491859186918791889189919091919192919391949195919691979198919992009201920292039204920592069207920892099210921192129213921492159216921792189219922092219222922392249225922692279228922992309231923292339234923592369237923892399240924192429243924492459246924792489249925092519252925392549255925692579258925992609261926292639264926592669267926892699270927192729273927492759276927792789279928092819282928392849285928692879288928992909291929292939294929592969297929892999300930193029303930493059306930793089309931093119312931393149315931693179318931993209321932293239324932593269327932893299330933193329333933493359336933793389339934093419342934393449345934693479348934993509351935293539354935593569357935893599360936193629363936493659366936793689369937093719372937393749375937693779378937993809381938293839384938593869387938893899390939193929393939493959396939793989399940094019402940394049405940694079408940994109411941294139414941594169417941894199420942194229423942494259426942794289429943094319432943394349435943694379438943994409441944294439444944594469447944894499450945194529453945494559456945794589459946094619462946394649465946694679468946994709471947294739474947594769477947894799480948194829483948494859486948794889489949094919492949394949495949694979498949995009501950295039504950595069507950895099510951195129513951495159516951795189519952095219522952395249525952695279528952995309531953295339534953595369537953895399540954195429543954495459546954795489549955095519552955395549555955695579558955995609561956295639564956595669567956895699570957195729573957495759576957795789579958095819582958395849585958695879588958995909591959295939594959595969597959895999600960196029603960496059606960796089609961096119612961396149615961696179618961996209621962296239624962596269627962896299630963196329633963496359636963796389639964096419642964396449645964696479648964996509651965296539654965596569657965896599660966196629663966496659666966796689669967096719672967396749675967696779678967996809681968296839684968596869687968896899690969196929693969496959696969796989699970097019702970397049705970697079708970997109711971297139714971597169717971897199720972197229723972497259726972797289729973097319732973397349735973697379738973997409741974297439744974597469747974897499750975197529753975497559756975797589759976097619762976397649765976697679768976997709771977297739774977597769777977897799780978197829783978497859786978797889789979097919792979397949795979697979798979998009801980298039804980598069807980898099810981198129813981498159816981798189819982098219822982398249825982698279828982998309831983298339834983598369837983898399840984198429843984498459846984798489849985098519852985398549855985698579858985998609861986298639864986598669867986898699870987198729873987498759876987798789879988098819882988398849885988698879888988998909891989298939894989598969897989898999900990199029903990499059906990799089909991099119912991399149915991699179918991999209921992299239924992599269927992899299930993199329933993499359936993799389939994099419942994399449945994699479948994999509951995299539954995599569957995899599960996199629963996499659966996799689969997099719972997399749975997699779978997999809981998299839984998599869987998899899990999199929993999499959996999799989999100001000110002100031000410005100061000710008100091001010011100121001310014100151001610017100181001910020100211002210023100241002510026100271002810029100301003110032100331003410035100361003710038100391004010041100421004310044100451004610047100481004910050100511005210053100541005510056100571005810059100601006110062100631006410065100661006710068100691007010071100721007310074100751007610077100781007910080100811008210083100841008510086100871008810089100901009110092100931009410095100961009710098100991010010101101021010310104101051010610107101081010910110101111011210113101141011510116101171011810119101201012110122101231012410125101261012710128101291013010131101321013310134101351013610137101381013910140101411014210143101441014510146101471014810149101501015110152101531015410155101561015710158101591016010161101621016310164101651016610167101681016910170101711017210173101741017510176101771017810179101801018110182101831018410185101861018710188101891019010191101921019310194101951019610197101981019910200102011020210203102041020510206102071020810209102101021110212102131021410215102161021710218102191022010221102221022310224102251022610227102281022910230102311023210233102341023510236102371023810239102401024110242102431024410245102461024710248102491025010251102521025310254102551025610257102581025910260102611026210263102641026510266102671026810269102701027110272102731027410275102761027710278102791028010281102821028310284102851028610287102881028910290102911029210293102941029510296102971029810299103001030110302103031030410305103061030710308103091031010311103121031310314103151031610317103181031910320103211032210323103241032510326103271032810329103301033110332103331033410335103361033710338103391034010341103421034310344103451034610347103481034910350103511035210353103541035510356103571035810359103601036110362103631036410365103661036710368103691037010371103721037310374103751037610377103781037910380103811038210383103841038510386103871038810389103901039110392103931039410395103961039710398103991040010401104021040310404104051040610407104081040910410104111041210413104141041510416104171041810419104201042110422104231042410425104261042710428104291043010431104321043310434104351043610437104381043910440104411044210443104441044510446104471044810449104501045110452104531045410455104561045710458104591046010461104621046310464104651046610467104681046910470104711047210473104741047510476104771047810479104801048110482104831048410485104861048710488104891049010491104921049310494104951049610497104981049910500105011050210503105041050510506105071050810509105101051110512105131051410515105161051710518105191052010521105221052310524105251052610527105281052910530105311053210533105341053510536105371053810539105401054110542105431054410545105461054710548105491055010551105521055310554105551055610557105581055910560105611056210563105641056510566105671056810569105701057110572105731057410575105761057710578105791058010581105821058310584105851058610587105881058910590105911059210593105941059510596105971059810599106001060110602106031060410605106061060710608106091061010611106121061310614106151061610617106181061910620106211062210623106241062510626106271062810629106301063110632106331063410635106361063710638106391064010641106421064310644106451064610647106481064910650106511065210653106541065510656106571065810659106601066110662106631066410665106661066710668106691067010671106721067310674106751067610677106781067910680106811068210683106841068510686106871068810689106901069110692106931069410695106961069710698106991070010701107021070310704107051070610707107081070910710107111071210713107141071510716107171071810719107201072110722107231072410725107261072710728107291073010731107321073310734107351073610737107381073910740107411074210743107441074510746107471074810749107501075110752107531075410755107561075710758107591076010761107621076310764107651076610767107681076910770107711077210773107741077510776107771077810779107801078110782107831078410785107861078710788107891079010791107921079310794107951079610797107981079910800108011080210803108041080510806108071080810809108101081110812108131081410815108161081710818108191082010821108221082310824108251082610827108281082910830108311083210833108341083510836108371083810839108401084110842108431084410845108461084710848108491085010851108521085310854108551085610857108581085910860108611086210863108641086510866108671086810869108701087110872108731087410875108761087710878108791088010881108821088310884108851088610887108881088910890108911089210893108941089510896108971089810899109001090110902109031090410905109061090710908109091091010911109121091310914109151091610917109181091910920109211092210923109241092510926109271092810929109301093110932109331093410935109361093710938109391094010941109421094310944109451094610947109481094910950109511095210953109541095510956109571095810959109601096110962109631096410965109661096710968109691097010971109721097310974109751097610977109781097910980109811098210983109841098510986109871098810989109901099110992109931099410995109961099710998109991100011001110021100311004110051100611007110081100911010110111101211013110141101511016110171101811019110201102111022110231102411025110261102711028110291103011031110321103311034110351103611037110381103911040110411104211043110441104511046110471104811049110501105111052110531105411055110561105711058110591106011061110621106311064110651106611067110681106911070110711107211073110741107511076110771107811079110801108111082110831108411085110861108711088110891109011091110921109311094110951109611097110981109911100111011110211103111041110511106111071110811109111101111111112111131111411115111161111711118111191112011121111221112311124111251112611127111281112911130111311113211133111341113511136111371113811139111401114111142111431114411145111461114711148111491115011151111521115311154111551115611157111581115911160111611116211163111641116511166111671116811169111701117111172111731117411175111761117711178111791118011181111821118311184111851118611187111881118911190111911119211193111941119511196111971119811199112001120111202112031120411205112061120711208112091121011211112121121311214112151121611217112181121911220112211122211223112241122511226112271122811229112301123111232112331123411235112361123711238112391124011241112421124311244112451124611247112481124911250112511125211253112541125511256112571125811259112601126111262112631126411265112661126711268112691127011271112721127311274112751127611277112781127911280112811128211283112841128511286112871128811289112901129111292112931129411295112961129711298112991130011301113021130311304113051130611307113081130911310113111131211313113141131511316113171131811319113201132111322113231132411325113261132711328113291133011331113321133311334113351133611337113381133911340113411134211343113441134511346113471134811349113501135111352113531135411355113561135711358113591136011361113621136311364113651136611367113681136911370113711137211373113741137511376113771137811379113801138111382113831138411385113861138711388113891139011391113921139311394113951139611397113981139911400114011140211403114041140511406114071140811409114101141111412114131141411415114161141711418114191142011421114221142311424114251142611427114281142911430114311143211433114341143511436114371143811439114401144111442114431144411445114461144711448114491145011451114521145311454114551145611457114581145911460114611146211463114641146511466114671146811469114701147111472114731147411475114761147711478114791148011481114821148311484114851148611487114881148911490114911149211493114941149511496114971149811499115001150111502115031150411505115061150711508115091151011511115121151311514115151151611517115181151911520115211152211523115241152511526115271152811529115301153111532115331153411535115361153711538115391154011541115421154311544115451154611547115481154911550115511155211553115541155511556115571155811559115601156111562115631156411565115661156711568115691157011571115721157311574115751157611577115781157911580115811158211583115841158511586115871158811589115901159111592115931159411595115961159711598115991160011601116021160311604116051160611607116081160911610116111161211613116141161511616116171161811619116201162111622116231162411625116261162711628116291163011631116321163311634116351163611637116381163911640116411164211643116441164511646116471164811649116501165111652116531165411655116561165711658116591166011661116621166311664116651166611667116681166911670116711167211673116741167511676116771167811679116801168111682116831168411685116861168711688116891169011691116921169311694116951169611697116981169911700117011170211703117041170511706117071170811709117101171111712117131171411715117161171711718117191172011721117221172311724117251172611727117281172911730117311173211733117341173511736117371173811739117401174111742117431174411745117461174711748117491175011751117521175311754117551175611757117581175911760117611176211763117641176511766117671176811769117701177111772117731177411775117761177711778117791178011781117821178311784117851178611787117881178911790117911179211793117941179511796117971179811799118001180111802118031180411805118061180711808118091181011811118121181311814118151181611817118181181911820118211182211823118241182511826118271182811829118301183111832118331183411835118361183711838118391184011841118421184311844118451184611847118481184911850118511185211853118541185511856118571185811859118601186111862118631186411865118661186711868118691187011871118721187311874118751187611877118781187911880118811188211883118841188511886118871188811889118901189111892118931189411895118961189711898118991190011901119021190311904119051190611907119081190911910119111191211913119141191511916119171191811919119201192111922119231192411925119261192711928119291193011931119321193311934119351193611937119381193911940119411194211943119441194511946119471194811949119501195111952119531195411955119561195711958119591196011961119621196311964119651196611967119681196911970119711197211973119741197511976119771197811979119801198111982119831198411985119861198711988119891199011991119921199311994119951199611997119981199912000120011200212003120041200512006120071200812009120101201112012120131201412015120161201712018120191202012021120221202312024120251202612027120281202912030120311203212033120341203512036120371203812039120401204112042120431204412045120461204712048120491205012051120521205312054120551205612057120581205912060120611206212063120641206512066120671206812069120701207112072120731207412075120761207712078120791208012081120821208312084120851208612087120881208912090120911209212093120941209512096120971209812099121001210112102121031210412105121061210712108121091211012111121121211312114121151211612117121181211912120121211212212123121241212512126121271212812129121301213112132121331213412135121361213712138121391214012141121421214312144121451214612147121481214912150121511215212153121541215512156121571215812159121601216112162121631216412165121661216712168121691217012171121721217312174121751217612177121781217912180121811218212183121841218512186121871218812189121901219112192121931219412195121961219712198121991220012201122021220312204122051220612207122081220912210122111221212213122141221512216122171221812219122201222112222122231222412225122261222712228122291223012231122321223312234122351223612237122381223912240122411224212243122441224512246122471224812249122501225112252122531225412255122561225712258122591226012261122621226312264122651226612267122681226912270122711227212273122741227512276122771227812279122801228112282122831228412285122861228712288122891229012291122921229312294122951229612297122981229912300123011230212303123041230512306123071230812309123101231112312123131231412315123161231712318123191232012321123221232312324123251232612327123281232912330123311233212333123341233512336123371233812339123401234112342123431234412345123461234712348123491235012351123521235312354123551235612357123581235912360123611236212363123641236512366123671236812369123701237112372123731237412375123761237712378123791238012381123821238312384123851238612387123881238912390123911239212393123941239512396123971239812399124001240112402124031240412405124061240712408124091241012411124121241312414124151241612417124181241912420124211242212423124241242512426124271242812429124301243112432124331243412435124361243712438124391244012441124421244312444124451244612447124481244912450124511245212453124541245512456124571245812459124601246112462124631246412465124661246712468124691247012471124721247312474124751247612477124781247912480124811248212483124841248512486124871248812489124901249112492124931249412495124961249712498124991250012501125021250312504125051250612507125081250912510125111251212513125141251512516125171251812519125201252112522125231252412525125261252712528125291253012531125321253312534125351253612537125381253912540125411254212543125441254512546125471254812549125501255112552125531255412555125561255712558125591256012561125621256312564125651256612567125681256912570125711257212573125741257512576125771257812579125801258112582125831258412585125861258712588125891259012591125921259312594125951259612597125981259912600126011260212603126041260512606126071260812609126101261112612126131261412615126161261712618126191262012621126221262312624126251262612627126281262912630126311263212633126341263512636126371263812639126401264112642126431264412645126461264712648126491265012651126521265312654126551265612657126581265912660126611266212663126641266512666126671266812669126701267112672126731267412675126761267712678126791268012681126821268312684126851268612687126881268912690126911269212693126941269512696126971269812699127001270112702127031270412705127061270712708127091271012711127121271312714127151271612717127181271912720127211272212723127241272512726127271272812729127301273112732127331273412735127361273712738127391274012741127421274312744127451274612747127481274912750127511275212753127541275512756127571275812759127601276112762127631276412765127661276712768127691277012771127721277312774127751277612777127781277912780127811278212783127841278512786127871278812789127901279112792127931279412795127961279712798127991280012801128021280312804128051280612807128081280912810128111281212813128141281512816128171281812819128201282112822128231282412825128261282712828128291283012831128321283312834128351283612837128381283912840128411284212843128441284512846128471284812849128501285112852128531285412855128561285712858128591286012861128621286312864128651286612867128681286912870128711287212873128741287512876128771287812879128801288112882128831288412885128861288712888128891289012891128921289312894128951289612897128981289912900129011290212903129041290512906129071290812909129101291112912129131291412915129161291712918129191292012921129221292312924129251292612927129281292912930129311293212933129341293512936129371293812939129401294112942129431294412945129461294712948129491295012951129521295312954129551295612957129581295912960129611296212963129641296512966129671296812969129701297112972129731297412975129761297712978129791298012981129821298312984129851298612987129881298912990129911299212993129941299512996129971299812999130001300113002130031300413005130061300713008130091301013011130121301313014130151301613017130181301913020130211302213023130241302513026130271302813029130301303113032130331303413035130361303713038130391304013041130421304313044130451304613047130481304913050130511305213053130541305513056130571305813059130601306113062130631306413065130661306713068130691307013071130721307313074130751307613077130781307913080130811308213083130841308513086130871308813089130901309113092130931309413095130961309713098130991310013101131021310313104131051310613107131081310913110131111311213113131141311513116131171311813119131201312113122131231312413125131261312713128131291313013131131321313313134131351313613137131381313913140131411314213143131441314513146131471314813149131501315113152131531315413155131561315713158131591316013161131621316313164131651316613167131681316913170131711317213173131741317513176131771317813179131801318113182131831318413185131861318713188131891319013191131921319313194131951319613197131981319913200132011320213203132041320513206132071320813209132101321113212132131321413215132161321713218132191322013221132221322313224132251322613227132281322913230132311323213233132341323513236132371323813239132401324113242132431324413245132461324713248132491325013251132521325313254132551325613257132581325913260132611326213263132641326513266132671326813269132701327113272132731327413275132761327713278132791328013281132821328313284132851328613287132881328913290132911329213293132941329513296132971329813299133001330113302133031330413305133061330713308133091331013311133121331313314133151331613317133181331913320133211332213323133241332513326133271332813329133301333113332133331333413335133361333713338133391334013341133421334313344133451334613347133481334913350133511335213353133541335513356133571335813359133601336113362133631336413365133661336713368133691337013371133721337313374133751337613377133781337913380133811338213383133841338513386133871338813389133901339113392133931339413395133961339713398133991340013401134021340313404134051340613407134081340913410134111341213413134141341513416134171341813419134201342113422134231342413425134261342713428134291343013431134321343313434134351343613437134381343913440134411344213443134441344513446134471344813449134501345113452134531345413455134561345713458134591346013461134621346313464134651346613467134681346913470134711347213473134741347513476134771347813479134801348113482134831348413485134861348713488134891349013491134921349313494134951349613497134981349913500135011350213503135041350513506135071350813509135101351113512135131351413515135161351713518135191352013521135221352313524135251352613527135281352913530135311353213533135341353513536135371353813539135401354113542135431354413545135461354713548135491355013551135521355313554135551355613557135581355913560135611356213563135641356513566135671356813569135701357113572135731357413575135761357713578135791358013581135821358313584135851358613587135881358913590135911359213593135941359513596135971359813599136001360113602136031360413605136061360713608136091361013611136121361313614136151361613617136181361913620136211362213623136241362513626136271362813629136301363113632136331363413635136361363713638136391364013641136421364313644136451364613647136481364913650136511365213653136541365513656136571365813659136601366113662136631366413665136661366713668136691367013671136721367313674136751367613677136781367913680136811368213683136841368513686136871368813689136901369113692136931369413695136961369713698136991370013701137021370313704137051370613707137081370913710137111371213713137141371513716137171371813719137201372113722137231372413725137261372713728137291373013731137321373313734137351373613737137381373913740137411374213743137441374513746137471374813749137501375113752137531375413755137561375713758137591376013761137621376313764137651376613767137681376913770137711377213773137741377513776137771377813779137801378113782137831378413785137861378713788137891379013791137921379313794137951379613797137981379913800138011380213803138041380513806138071380813809138101381113812138131381413815138161381713818138191382013821138221382313824138251382613827138281382913830138311383213833138341383513836138371383813839138401384113842138431384413845138461384713848138491385013851138521385313854138551385613857138581385913860138611386213863138641386513866138671386813869138701387113872138731387413875138761387713878138791388013881138821388313884138851388613887138881388913890138911389213893138941389513896138971389813899139001390113902139031390413905139061390713908139091391013911139121391313914139151391613917139181391913920139211392213923139241392513926139271392813929139301393113932139331393413935139361393713938139391394013941139421394313944139451394613947139481394913950139511395213953139541395513956139571395813959139601396113962139631396413965139661396713968139691397013971139721397313974139751397613977139781397913980139811398213983139841398513986139871398813989139901399113992139931399413995139961399713998139991400014001140021400314004140051400614007140081400914010140111401214013140141401514016140171401814019140201402114022140231402414025140261402714028140291403014031140321403314034140351403614037140381403914040140411404214043140441404514046140471404814049140501405114052140531405414055140561405714058140591406014061140621406314064140651406614067140681406914070140711407214073140741407514076140771407814079140801408114082140831408414085140861408714088140891409014091140921409314094140951409614097140981409914100141011410214103141041410514106141071410814109141101411114112141131411414115141161411714118141191412014121141221412314124141251412614127141281412914130141311413214133141341413514136141371413814139141401414114142141431414414145141461414714148141491415014151141521415314154141551415614157141581415914160141611416214163141641416514166141671416814169141701417114172141731417414175141761417714178141791418014181141821418314184141851418614187141881418914190141911419214193141941419514196141971419814199142001420114202142031420414205142061420714208142091421014211142121421314214142151421614217142181421914220142211422214223142241422514226142271422814229142301423114232142331423414235142361423714238142391424014241142421424314244142451424614247142481424914250142511425214253142541425514256142571425814259142601426114262142631426414265142661426714268142691427014271142721427314274142751427614277142781427914280142811428214283142841428514286142871428814289142901429114292142931429414295142961429714298142991430014301143021430314304143051430614307143081430914310143111431214313143141431514316143171431814319143201432114322143231432414325143261432714328143291433014331143321433314334143351433614337143381433914340143411434214343143441434514346143471434814349143501435114352143531435414355143561435714358143591436014361143621436314364143651436614367143681436914370143711437214373143741437514376143771437814379143801438114382143831438414385143861438714388143891439014391143921439314394143951439614397143981439914400144011440214403144041440514406144071440814409144101441114412144131441414415144161441714418144191442014421144221442314424144251442614427144281442914430144311443214433144341443514436144371443814439144401444114442144431444414445144461444714448144491445014451144521445314454144551445614457144581445914460144611446214463144641446514466144671446814469144701447114472144731447414475144761447714478144791448014481144821448314484144851448614487144881448914490144911449214493144941449514496144971449814499145001450114502145031450414505145061450714508145091451014511145121451314514145151451614517145181451914520145211452214523145241452514526145271452814529145301453114532145331453414535145361453714538145391454014541145421454314544145451454614547145481454914550145511455214553145541455514556145571455814559145601456114562145631456414565145661456714568145691457014571145721457314574145751457614577145781457914580145811458214583145841458514586145871458814589145901459114592145931459414595145961459714598145991460014601146021460314604146051460614607146081460914610146111461214613146141461514616146171461814619146201462114622146231462414625146261462714628146291463014631146321463314634146351463614637146381463914640146411464214643146441464514646146471464814649146501465114652146531465414655146561465714658146591466014661146621466314664146651466614667146681466914670146711467214673146741467514676146771467814679146801468114682146831468414685146861468714688146891469014691146921469314694146951469614697146981469914700147011470214703147041470514706147071470814709147101471114712147131471414715147161471714718147191472014721147221472314724147251472614727147281472914730147311473214733147341473514736147371473814739147401474114742147431474414745147461474714748147491475014751147521475314754147551475614757147581475914760147611476214763147641476514766147671476814769147701477114772147731477414775147761477714778147791478014781147821478314784147851478614787147881478914790147911479214793147941479514796147971479814799148001480114802148031480414805148061480714808148091481014811148121481314814148151481614817148181481914820148211482214823148241482514826148271482814829148301483114832148331483414835148361483714838148391484014841148421484314844148451484614847148481484914850148511485214853148541485514856148571485814859148601486114862148631486414865148661486714868148691487014871148721487314874148751487614877148781487914880148811488214883148841488514886148871488814889148901489114892148931489414895148961489714898148991490014901149021490314904149051490614907149081490914910149111491214913149141491514916149171491814919149201492114922149231492414925149261492714928149291493014931149321493314934149351493614937149381493914940149411494214943149441494514946149471494814949149501495114952149531495414955149561495714958149591496014961149621496314964149651496614967149681496914970149711497214973149741497514976149771497814979149801498114982149831498414985149861498714988149891499014991149921499314994149951499614997149981499915000150011500215003150041500515006150071500815009150101501115012150131501415015150161501715018150191502015021150221502315024150251502615027150281502915030150311503215033150341503515036150371503815039150401504115042150431504415045150461504715048150491505015051150521505315054150551505615057150581505915060150611506215063150641506515066150671506815069150701507115072150731507415075150761507715078150791508015081150821508315084150851508615087150881508915090150911509215093150941509515096150971509815099151001510115102151031510415105151061510715108151091511015111151121511315114151151511615117151181511915120151211512215123151241512515126151271512815129151301513115132151331513415135151361513715138151391514015141151421514315144151451514615147151481514915150151511515215153151541515515156151571515815159151601516115162151631516415165151661516715168151691517015171151721517315174151751517615177151781517915180151811518215183151841518515186151871518815189151901519115192151931519415195151961519715198151991520015201152021520315204152051520615207152081520915210152111521215213152141521515216152171521815219152201522115222152231522415225152261522715228152291523015231152321523315234152351523615237152381523915240152411524215243152441524515246152471524815249152501525115252152531525415255152561525715258152591526015261152621526315264152651526615267152681526915270152711527215273152741527515276152771527815279152801528115282152831528415285152861528715288152891529015291152921529315294152951529615297152981529915300153011530215303153041530515306153071530815309153101531115312153131531415315153161531715318153191532015321153221532315324153251532615327153281532915330153311533215333153341533515336153371533815339153401534115342153431534415345153461534715348153491535015351153521535315354153551535615357153581535915360153611536215363153641536515366153671536815369153701537115372153731537415375153761537715378153791538015381153821538315384153851538615387153881538915390153911539215393153941539515396153971539815399154001540115402154031540415405154061540715408154091541015411154121541315414154151541615417154181541915420154211542215423154241542515426154271542815429154301543115432154331543415435154361543715438154391544015441154421544315444154451544615447154481544915450154511545215453154541545515456154571545815459154601546115462154631546415465154661546715468154691547015471154721547315474154751547615477154781547915480154811548215483154841548515486154871548815489154901549115492154931549415495154961549715498154991550015501155021550315504155051550615507155081550915510155111551215513155141551515516155171551815519155201552115522155231552415525155261552715528155291553015531155321553315534155351553615537155381553915540155411554215543155441554515546155471554815549155501555115552155531555415555155561555715558155591556015561155621556315564155651556615567155681556915570155711557215573155741557515576155771557815579155801558115582155831558415585155861558715588155891559015591155921559315594155951559615597155981559915600156011560215603156041560515606156071560815609156101561115612156131561415615156161561715618156191562015621156221562315624156251562615627156281562915630156311563215633156341563515636156371563815639156401564115642156431564415645156461564715648156491565015651156521565315654156551565615657156581565915660156611566215663156641566515666156671566815669156701567115672156731567415675156761567715678156791568015681156821568315684156851568615687156881568915690156911569215693156941569515696156971569815699157001570115702157031570415705157061570715708157091571015711157121571315714157151571615717157181571915720157211572215723157241572515726157271572815729157301573115732157331573415735157361573715738157391574015741157421574315744157451574615747157481574915750157511575215753157541575515756157571575815759157601576115762157631576415765157661576715768157691577015771157721577315774157751577615777157781577915780157811578215783157841578515786157871578815789157901579115792157931579415795157961579715798157991580015801158021580315804158051580615807158081580915810158111581215813158141581515816158171581815819158201582115822158231582415825158261582715828158291583015831158321583315834158351583615837158381583915840158411584215843158441584515846158471584815849158501585115852158531585415855158561585715858158591586015861158621586315864158651586615867158681586915870158711587215873158741587515876158771587815879158801588115882158831588415885158861588715888158891589015891158921589315894158951589615897158981589915900159011590215903159041590515906159071590815909159101591115912159131591415915159161591715918159191592015921159221592315924159251592615927159281592915930159311593215933159341593515936159371593815939159401594115942159431594415945159461594715948159491595015951159521595315954159551595615957159581595915960159611596215963159641596515966159671596815969159701597115972159731597415975159761597715978159791598015981159821598315984159851598615987159881598915990159911599215993159941599515996159971599815999160001600116002160031600416005160061600716008160091601016011160121601316014160151601616017160181601916020160211602216023160241602516026160271602816029160301603116032160331603416035160361603716038160391604016041160421604316044160451604616047160481604916050160511605216053160541605516056160571605816059160601606116062160631606416065160661606716068160691607016071160721607316074160751607616077160781607916080160811608216083160841608516086160871608816089160901609116092160931609416095160961609716098160991610016101161021610316104161051610616107161081610916110161111611216113161141611516116161171611816119161201612116122161231612416125161261612716128161291613016131161321613316134161351613616137161381613916140161411614216143161441614516146161471614816149161501615116152161531615416155161561615716158161591616016161161621616316164161651616616167161681616916170161711617216173161741617516176161771617816179161801618116182161831618416185161861618716188161891619016191161921619316194161951619616197161981619916200162011620216203162041620516206162071620816209162101621116212162131621416215162161621716218162191622016221162221622316224162251622616227162281622916230162311623216233162341623516236162371623816239162401624116242162431624416245162461624716248162491625016251162521625316254162551625616257162581625916260162611626216263162641626516266162671626816269162701627116272162731627416275162761627716278162791628016281162821628316284162851628616287162881628916290162911629216293162941629516296162971629816299163001630116302163031630416305163061630716308163091631016311163121631316314163151631616317163181631916320163211632216323163241632516326163271632816329163301633116332163331633416335163361633716338163391634016341163421634316344163451634616347163481634916350163511635216353163541635516356163571635816359163601636116362163631636416365163661636716368163691637016371163721637316374163751637616377163781637916380163811638216383163841638516386163871638816389163901639116392163931639416395163961639716398163991640016401164021640316404164051640616407164081640916410164111641216413164141641516416164171641816419164201642116422164231642416425164261642716428164291643016431164321643316434164351643616437164381643916440164411644216443164441644516446164471644816449164501645116452164531645416455164561645716458164591646016461164621646316464164651646616467164681646916470164711647216473164741647516476164771647816479164801648116482164831648416485164861648716488164891649016491164921649316494164951649616497164981649916500165011650216503165041650516506165071650816509165101651116512165131651416515165161651716518165191652016521165221652316524165251652616527165281652916530165311653216533165341653516536165371653816539165401654116542165431654416545165461654716548165491655016551165521655316554165551655616557165581655916560165611656216563165641656516566165671656816569165701657116572165731657416575165761657716578165791658016581165821658316584165851658616587165881658916590165911659216593165941659516596165971659816599166001660116602166031660416605166061660716608166091661016611166121661316614166151661616617166181661916620166211662216623166241662516626166271662816629166301663116632166331663416635166361663716638166391664016641166421664316644166451664616647166481664916650166511665216653166541665516656166571665816659166601666116662166631666416665166661666716668166691667016671166721667316674166751667616677166781667916680166811668216683166841668516686166871668816689166901669116692166931669416695166961669716698166991670016701167021670316704167051670616707167081670916710167111671216713167141671516716167171671816719167201672116722167231672416725167261672716728167291673016731167321673316734167351673616737167381673916740167411674216743167441674516746167471674816749167501675116752167531675416755167561675716758167591676016761167621676316764167651676616767167681676916770167711677216773167741677516776167771677816779167801678116782167831678416785167861678716788167891679016791167921679316794167951679616797167981679916800168011680216803168041680516806168071680816809168101681116812168131681416815168161681716818168191682016821168221682316824168251682616827168281682916830168311683216833168341683516836168371683816839168401684116842168431684416845168461684716848168491685016851168521685316854168551685616857168581685916860168611686216863168641686516866168671686816869168701687116872168731687416875168761687716878168791688016881168821688316884168851688616887168881688916890168911689216893168941689516896168971689816899169001690116902169031690416905169061690716908169091691016911169121691316914169151691616917169181691916920169211692216923169241692516926169271692816929169301693116932169331693416935169361693716938169391694016941169421694316944169451694616947169481694916950169511695216953169541695516956169571695816959169601696116962169631696416965169661696716968169691697016971169721697316974169751697616977169781697916980169811698216983169841698516986169871698816989169901699116992169931699416995169961699716998169991700017001170021700317004170051700617007170081700917010170111701217013170141701517016170171701817019170201702117022170231702417025170261702717028170291703017031170321703317034170351703617037170381703917040170411704217043170441704517046170471704817049170501705117052170531705417055170561705717058170591706017061170621706317064170651706617067170681706917070170711707217073170741707517076170771707817079170801708117082170831708417085170861708717088170891709017091170921709317094170951709617097170981709917100171011710217103171041710517106171071710817109171101711117112171131711417115171161711717118171191712017121171221712317124171251712617127171281712917130171311713217133171341713517136171371713817139171401714117142171431714417145171461714717148171491715017151171521715317154171551715617157171581715917160171611716217163171641716517166171671716817169171701717117172171731717417175171761717717178171791718017181171821718317184171851718617187171881718917190171911719217193171941719517196171971719817199172001720117202172031720417205172061720717208172091721017211172121721317214172151721617217172181721917220172211722217223172241722517226172271722817229172301723117232172331723417235172361723717238172391724017241172421724317244172451724617247172481724917250172511725217253172541725517256172571725817259172601726117262172631726417265172661726717268172691727017271172721727317274172751727617277172781727917280172811728217283172841728517286172871728817289172901729117292172931729417295172961729717298172991730017301173021730317304173051730617307173081730917310173111731217313173141731517316173171731817319173201732117322173231732417325173261732717328173291733017331173321733317334173351733617337173381733917340173411734217343173441734517346173471734817349173501735117352173531735417355173561735717358173591736017361173621736317364173651736617367173681736917370173711737217373173741737517376173771737817379173801738117382173831738417385173861738717388173891739017391173921739317394173951739617397173981739917400174011740217403174041740517406174071740817409174101741117412174131741417415174161741717418174191742017421174221742317424174251742617427174281742917430174311743217433174341743517436174371743817439174401744117442174431744417445174461744717448174491745017451174521745317454174551745617457174581745917460174611746217463174641746517466174671746817469174701747117472174731747417475174761747717478174791748017481174821748317484174851748617487174881748917490174911749217493174941749517496174971749817499175001750117502175031750417505175061750717508175091751017511175121751317514175151751617517175181751917520175211752217523175241752517526175271752817529175301753117532175331753417535175361753717538175391754017541175421754317544175451754617547175481754917550175511755217553175541755517556175571755817559175601756117562175631756417565175661756717568175691757017571175721757317574175751757617577175781757917580175811758217583175841758517586175871758817589175901759117592175931759417595175961759717598175991760017601176021760317604176051760617607176081760917610176111761217613176141761517616176171761817619176201762117622176231762417625176261762717628176291763017631176321763317634176351763617637176381763917640176411764217643176441764517646176471764817649176501765117652176531765417655176561765717658176591766017661176621766317664176651766617667176681766917670176711767217673176741767517676176771767817679176801768117682176831768417685176861768717688176891769017691176921769317694176951769617697176981769917700177011770217703177041770517706177071770817709177101771117712177131771417715177161771717718177191772017721177221772317724177251772617727177281772917730177311773217733177341773517736177371773817739177401774117742177431774417745177461774717748177491775017751177521775317754177551775617757177581775917760177611776217763177641776517766177671776817769177701777117772177731777417775177761777717778177791778017781177821778317784177851778617787177881778917790177911779217793177941779517796177971779817799178001780117802178031780417805178061780717808178091781017811178121781317814178151781617817178181781917820178211782217823178241782517826178271782817829178301783117832178331783417835178361783717838178391784017841178421784317844178451784617847178481784917850178511785217853178541785517856178571785817859178601786117862178631786417865178661786717868178691787017871178721787317874178751787617877178781787917880178811788217883178841788517886178871788817889178901789117892178931789417895178961789717898178991790017901179021790317904179051790617907179081790917910179111791217913179141791517916179171791817919179201792117922179231792417925179261792717928179291793017931179321793317934179351793617937179381793917940179411794217943179441794517946179471794817949179501795117952179531795417955179561795717958179591796017961179621796317964179651796617967179681796917970179711797217973179741797517976179771797817979179801798117982179831798417985179861798717988179891799017991179921799317994179951799617997179981799918000180011800218003180041800518006180071800818009180101801118012180131801418015180161801718018180191802018021180221802318024180251802618027180281802918030180311803218033180341803518036180371803818039180401804118042180431804418045180461804718048180491805018051180521805318054180551805618057180581805918060180611806218063180641806518066180671806818069180701807118072180731807418075180761807718078180791808018081180821808318084180851808618087180881808918090180911809218093180941809518096180971809818099181001810118102181031810418105181061810718108181091811018111181121811318114181151811618117181181811918120181211812218123181241812518126181271812818129181301813118132181331813418135181361813718138181391814018141181421814318144181451814618147181481814918150181511815218153181541815518156181571815818159181601816118162181631816418165181661816718168181691817018171181721817318174181751817618177181781817918180181811818218183181841818518186181871818818189181901819118192181931819418195181961819718198181991820018201182021820318204182051820618207182081820918210182111821218213182141821518216182171821818219182201822118222182231822418225182261822718228182291823018231182321823318234182351823618237182381823918240182411824218243182441824518246182471824818249182501825118252182531825418255182561825718258182591826018261182621826318264182651826618267182681826918270182711827218273182741827518276182771827818279182801828118282182831828418285182861828718288182891829018291182921829318294182951829618297182981829918300183011830218303183041830518306183071830818309183101831118312183131831418315183161831718318183191832018321183221832318324183251832618327183281832918330183311833218333183341833518336183371833818339183401834118342183431834418345183461834718348183491835018351183521835318354183551835618357183581835918360183611836218363183641836518366183671836818369183701837118372183731837418375183761837718378183791838018381183821838318384183851838618387183881838918390183911839218393183941839518396183971839818399184001840118402184031840418405184061840718408184091841018411184121841318414184151841618417184181841918420184211842218423184241842518426184271842818429184301843118432184331843418435184361843718438184391844018441184421844318444184451844618447184481844918450184511845218453184541845518456184571845818459184601846118462184631846418465184661846718468184691847018471184721847318474184751847618477184781847918480184811848218483184841848518486184871848818489184901849118492184931849418495184961849718498184991850018501185021850318504185051850618507185081850918510185111851218513185141851518516185171851818519185201852118522185231852418525185261852718528185291853018531185321853318534185351853618537185381853918540185411854218543185441854518546185471854818549185501855118552185531855418555185561855718558185591856018561185621856318564185651856618567185681856918570185711857218573185741857518576185771857818579185801858118582185831858418585185861858718588185891859018591185921859318594185951859618597185981859918600186011860218603186041860518606186071860818609186101861118612186131861418615186161861718618186191862018621186221862318624186251862618627186281862918630186311863218633186341863518636186371863818639186401864118642186431864418645186461864718648186491865018651186521865318654186551865618657186581865918660186611866218663186641866518666186671866818669186701867118672186731867418675186761867718678186791868018681186821868318684186851868618687186881868918690186911869218693186941869518696186971869818699187001870118702187031870418705187061870718708187091871018711187121871318714187151871618717187181871918720187211872218723187241872518726187271872818729187301873118732187331873418735187361873718738187391874018741187421874318744187451874618747187481874918750187511875218753187541875518756187571875818759187601876118762187631876418765187661876718768187691877018771187721877318774187751877618777187781877918780187811878218783187841878518786187871878818789187901879118792187931879418795187961879718798187991880018801188021880318804188051880618807188081880918810188111881218813188141881518816188171881818819188201882118822188231882418825188261882718828188291883018831188321883318834188351883618837188381883918840188411884218843188441884518846188471884818849188501885118852188531885418855188561885718858188591886018861188621886318864188651886618867188681886918870188711887218873188741887518876188771887818879188801888118882188831888418885188861888718888188891889018891188921889318894188951889618897188981889918900189011890218903189041890518906189071890818909189101891118912189131891418915189161891718918189191892018921189221892318924189251892618927189281892918930189311893218933189341893518936189371893818939189401894118942189431894418945189461894718948189491895018951189521895318954189551895618957189581895918960189611896218963189641896518966189671896818969189701897118972189731897418975189761897718978189791898018981189821898318984189851898618987189881898918990189911899218993189941899518996189971899818999190001900119002190031900419005190061900719008190091901019011190121901319014190151901619017190181901919020190211902219023190241902519026190271902819029190301903119032190331903419035190361903719038190391904019041190421904319044190451904619047190481904919050190511905219053190541905519056190571905819059190601906119062190631906419065190661906719068190691907019071190721907319074190751907619077190781907919080190811908219083190841908519086190871908819089190901909119092190931909419095190961909719098190991910019101191021910319104191051910619107191081910919110191111911219113191141911519116191171911819119191201912119122191231912419125191261912719128191291913019131191321913319134191351913619137191381913919140191411914219143191441914519146191471914819149191501915119152191531915419155191561915719158191591916019161191621916319164191651916619167191681916919170191711917219173191741917519176191771917819179191801918119182191831918419185191861918719188191891919019191191921919319194191951919619197191981919919200192011920219203192041920519206192071920819209192101921119212192131921419215192161921719218192191922019221192221922319224192251922619227192281922919230192311923219233192341923519236192371923819239192401924119242192431924419245192461924719248192491925019251192521925319254192551925619257192581925919260192611926219263192641926519266192671926819269192701927119272192731927419275192761927719278192791928019281192821928319284192851928619287192881928919290192911929219293192941929519296192971929819299193001930119302193031930419305193061930719308193091931019311193121931319314193151931619317193181931919320193211932219323193241932519326193271932819329193301933119332193331933419335193361933719338193391934019341193421934319344193451934619347193481934919350193511935219353193541935519356193571935819359193601936119362193631936419365193661936719368193691937019371193721937319374193751937619377193781937919380193811938219383193841938519386193871938819389193901939119392193931939419395193961939719398193991940019401194021940319404194051940619407194081940919410194111941219413194141941519416194171941819419194201942119422194231942419425194261942719428194291943019431194321943319434194351943619437194381943919440194411944219443194441944519446194471944819449194501945119452194531945419455194561945719458194591946019461194621946319464194651946619467194681946919470194711947219473194741947519476194771947819479194801948119482194831948419485194861948719488194891949019491194921949319494194951949619497194981949919500195011950219503195041950519506195071950819509195101951119512195131951419515195161951719518195191952019521195221952319524195251952619527195281952919530195311953219533195341953519536195371953819539195401954119542195431954419545195461954719548195491955019551195521955319554195551955619557195581955919560195611956219563195641956519566195671956819569195701957119572195731957419575195761957719578195791958019581195821958319584195851958619587195881958919590195911959219593195941959519596195971959819599196001960119602196031960419605196061960719608196091961019611196121961319614196151961619617196181961919620196211962219623196241962519626196271962819629196301963119632196331963419635196361963719638196391964019641196421964319644196451964619647196481964919650196511965219653196541965519656196571965819659196601966119662196631966419665196661966719668196691967019671196721967319674196751967619677196781967919680196811968219683196841968519686196871968819689196901969119692196931969419695196961969719698196991970019701197021970319704197051970619707197081970919710197111971219713197141971519716197171971819719197201972119722197231972419725197261972719728197291973019731197321973319734197351973619737197381973919740197411974219743197441974519746197471974819749197501975119752197531975419755197561975719758197591976019761197621976319764197651976619767197681976919770197711977219773197741977519776197771977819779197801978119782197831978419785197861978719788197891979019791197921979319794197951979619797197981979919800198011980219803198041980519806198071980819809198101981119812198131981419815198161981719818198191982019821198221982319824198251982619827198281982919830198311983219833198341983519836198371983819839198401984119842198431984419845198461984719848198491985019851198521985319854198551985619857198581985919860198611986219863198641986519866198671986819869198701987119872198731987419875198761987719878198791988019881198821988319884198851988619887198881988919890198911989219893198941989519896198971989819899199001990119902199031990419905199061990719908199091991019911199121991319914199151991619917199181991919920199211992219923199241992519926199271992819929199301993119932199331993419935199361993719938199391994019941199421994319944199451994619947199481994919950199511995219953199541995519956199571995819959199601996119962199631996419965199661996719968199691997019971199721997319974199751997619977199781997919980199811998219983199841998519986199871998819989199901999119992199931999419995199961999719998199992000020001200022000320004200052000620007200082000920010200112001220013200142001520016200172001820019200202002120022200232002420025200262002720028200292003020031200322003320034200352003620037200382003920040200412004220043200442004520046200472004820049200502005120052200532005420055200562005720058200592006020061200622006320064200652006620067200682006920070200712007220073200742007520076200772007820079200802008120082200832008420085200862008720088200892009020091200922009320094200952009620097200982009920100201012010220103201042010520106201072010820109201102011120112201132011420115201162011720118201192012020121201222012320124201252012620127201282012920130201312013220133201342013520136201372013820139201402014120142201432014420145201462014720148201492015020151201522015320154201552015620157201582015920160201612016220163201642016520166201672016820169201702017120172201732017420175201762017720178201792018020181201822018320184201852018620187201882018920190201912019220193201942019520196201972019820199202002020120202202032020420205202062020720208202092021020211202122021320214202152021620217202182021920220202212022220223202242022520226202272022820229202302023120232202332023420235202362023720238202392024020241202422024320244202452024620247202482024920250202512025220253202542025520256202572025820259202602026120262202632026420265202662026720268202692027020271202722027320274202752027620277202782027920280202812028220283202842028520286202872028820289202902029120292202932029420295202962029720298202992030020301203022030320304203052030620307203082030920310203112031220313203142031520316203172031820319203202032120322203232032420325203262032720328203292033020331203322033320334203352033620337203382033920340203412034220343203442034520346203472034820349203502035120352203532035420355203562035720358203592036020361203622036320364203652036620367203682036920370203712037220373203742037520376203772037820379203802038120382203832038420385203862038720388203892039020391203922039320394203952039620397203982039920400204012040220403204042040520406204072040820409204102041120412204132041420415204162041720418204192042020421204222042320424204252042620427204282042920430204312043220433204342043520436204372043820439204402044120442204432044420445204462044720448204492045020451204522045320454204552045620457204582045920460204612046220463204642046520466204672046820469204702047120472204732047420475204762047720478204792048020481204822048320484204852048620487204882048920490204912049220493204942049520496204972049820499205002050120502205032050420505205062050720508205092051020511205122051320514205152051620517205182051920520205212052220523205242052520526205272052820529205302053120532205332053420535205362053720538205392054020541205422054320544205452054620547205482054920550205512055220553205542055520556205572055820559205602056120562205632056420565205662056720568205692057020571205722057320574205752057620577205782057920580205812058220583205842058520586205872058820589205902059120592205932059420595205962059720598205992060020601206022060320604206052060620607206082060920610206112061220613206142061520616206172061820619206202062120622206232062420625206262062720628206292063020631206322063320634206352063620637206382063920640206412064220643206442064520646206472064820649206502065120652206532065420655206562065720658206592066020661206622066320664206652066620667206682066920670206712067220673206742067520676206772067820679206802068120682206832068420685206862068720688206892069020691206922069320694206952069620697206982069920700207012070220703207042070520706207072070820709207102071120712207132071420715207162071720718207192072020721207222072320724207252072620727207282072920730207312073220733207342073520736207372073820739207402074120742207432074420745207462074720748207492075020751207522075320754207552075620757207582075920760207612076220763207642076520766207672076820769207702077120772207732077420775207762077720778207792078020781207822078320784207852078620787207882078920790207912079220793207942079520796207972079820799208002080120802208032080420805208062080720808208092081020811208122081320814208152081620817208182081920820208212082220823208242082520826208272082820829208302083120832208332083420835208362083720838208392084020841208422084320844208452084620847208482084920850208512085220853208542085520856208572085820859208602086120862208632086420865208662086720868208692087020871208722087320874208752087620877208782087920880208812088220883208842088520886208872088820889208902089120892208932089420895208962089720898208992090020901209022090320904209052090620907209082090920910209112091220913209142091520916209172091820919209202092120922209232092420925209262092720928209292093020931209322093320934209352093620937209382093920940209412094220943209442094520946209472094820949209502095120952209532095420955209562095720958209592096020961209622096320964209652096620967209682096920970209712097220973209742097520976209772097820979209802098120982209832098420985209862098720988209892099020991209922099320994209952099620997 |
- <!DOCTYPE html>
- <!-- saved from url=(0084)http://pabprod.blob.core.windows.net/books/d385673a-8a13-495b-b4fc-e946b683e6c9.html -->
- <html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>My Collection</title><!--<base href="http://msdn.microsoft.com/">--><base href="."><style type="text/css"></style><script class="mtps-injected">try {
- /**/
- (window.MTPS || (window.MTPS = {})).cdnDomains || (window.MTPS.cdnDomains = {
- "image": "https://i-msdn.sec.s-msft.com",
- "js": "https://i2-msdn.sec.s-msft.com",
- "css": "https://i-msdn.sec.s-msft.com",
- "ttf": "https://i-msdn.sec.s-msft.com"
- });
- /**/
- } finally { MTPS._injectNextScript_0 && MTPS._injectNextScript_0(); }</script><script class="mtps-injected">try {
- //
- var literalNormalizedUrl = '/en-us/library/ms809754(d=printer,l=en-us,v=msdn.10).aspx';
- var wt_nvr_ru = 'WT_NVR_RU';
- var wt_fpcdom = '.microsoft.com';
- var wt_domlist = 'msdn.microsoft.com';
- var wt_pathlist = '';
- var wt_paramlist = 'DCSext.mtps_devcenter';
- var wt_siteid = 'MSDN';
- var gDomain = 'm.webtrends.com';
- var gDcsId = 'dcsmgru7m99k7mqmgrhudo0k8_8c6m';
- var gFpc = 'WT_FPC';
- if (document.cookie.indexOf(gFpc + "=") == -1) {
- var wtidJs = document.createElement("script");
- wtidJs.src = "//" + gDomain + "/" + gDcsId + "/wtid.js";
- document.getElementsByTagName("head")[0].appendChild(wtidJs);
- }
- var detectedLocale = 'en-us';
- var wtsp = 'msdnlib_w32_com';
- var gTrackEvents = '0';
- /**/
- } finally { MTPS._injectNextScript_1 && MTPS._injectNextScript_1(); }</script><script src="./Windows Kernel Development Articles (2016-03-30)_files/wtid.js"></script><script class="mtps-injected">try {
- //
- window.appInsightsId = '5eb1b2eb-c47a-497a-a7ac-a1c230b2882f';
- //
- } finally { MTPS._injectNextScript_2 && MTPS._injectNextScript_2(); }</script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/Combined.js"></script><script class="mtps-injected">try {
- /**/
- (window.MTPS || (window.MTPS = {})).cdnDomains || (window.MTPS.cdnDomains = {
- "image": "https://i-msdn.sec.s-msft.com",
- "js": "https://i2-msdn.sec.s-msft.com",
- "css": "https://i-msdn.sec.s-msft.com",
- "ttf": "https://i-msdn.sec.s-msft.com"
- });
- /**/
- } finally { MTPS._injectNextScript_0 && MTPS._injectNextScript_0(); }</script><script class="mtps-injected">try {
- //
- var literalNormalizedUrl = '/en-us/library/dn655038(d=printer,l=en-us,v=vs.140).aspx';
- var wt_nvr_ru = 'WT_NVR_RU';
- var wt_fpcdom = '.microsoft.com';
- var wt_domlist = 'msdn.microsoft.com';
- var wt_pathlist = '';
- var wt_paramlist = 'DCSext.mtps_devcenter';
- var wt_siteid = 'MSDN';
- var gDomain = 'm.webtrends.com';
- var gDcsId = 'dcsmgru7m99k7mqmgrhudo0k8_8c6m';
- var gFpc = 'WT_FPC';
- if (document.cookie.indexOf(gFpc + "=") == -1) {
- var wtidJs = document.createElement("script");
- wtidJs.src = "//" + gDomain + "/" + gDcsId + "/wtid.js";
- document.getElementsByTagName("head")[0].appendChild(wtidJs);
- }
- var detectedLocale = 'en-us';
- var wtsp = 'msdnlib_devtools_lang';
- var gTrackEvents = '0';
- /**/
- } finally { MTPS._injectNextScript_1 && MTPS._injectNextScript_1(); }</script><script src="./Windows Kernel Development Articles (2016-03-30)_files/wtid.js"></script><script class="mtps-injected">try {
- //
- window.appInsightsId = '5eb1b2eb-c47a-497a-a7ac-a1c230b2882f';
- //
- } finally { MTPS._injectNextScript_2 && MTPS._injectNextScript_2(); }</script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/Combined(1).js"></script><script class="mtps-injected">try {
- /**/
- (window.MTPS || (window.MTPS = {})).cdnDomains || (window.MTPS.cdnDomains = {
- "image": "https://i-msdn.sec.s-msft.com",
- "js": "https://i2-msdn.sec.s-msft.com",
- "css": "https://i-msdn.sec.s-msft.com",
- "ttf": "https://i-msdn.sec.s-msft.com"
- });
- /**/
- } finally { MTPS._injectNextScript_0 && MTPS._injectNextScript_0(); }</script><script class="mtps-injected">try {
- //
- var literalNormalizedUrl = '/en-us/library/t6tay6cz(d=printer,l=en-us,v=vs.140).aspx';
- var wt_nvr_ru = 'WT_NVR_RU';
- var wt_fpcdom = '.microsoft.com';
- var wt_domlist = 'msdn.microsoft.com';
- var wt_pathlist = '';
- var wt_paramlist = 'DCSext.mtps_devcenter';
- var wt_siteid = 'MSDN';
- var gDomain = 'm.webtrends.com';
- var gDcsId = 'dcsmgru7m99k7mqmgrhudo0k8_8c6m';
- var gFpc = 'WT_FPC';
- if (document.cookie.indexOf(gFpc + "=") == -1) {
- var wtidJs = document.createElement("script");
- wtidJs.src = "//" + gDomain + "/" + gDcsId + "/wtid.js";
- document.getElementsByTagName("head")[0].appendChild(wtidJs);
- }
- var detectedLocale = 'en-us';
- var wtsp = 'msdnlib_devtools_lang';
- var gTrackEvents = '0';
- /**/
- } finally { MTPS._injectNextScript_1 && MTPS._injectNextScript_1(); }</script><script src="./Windows Kernel Development Articles (2016-03-30)_files/wtid.js"></script><script class="mtps-injected">try {
- //
- window.appInsightsId = '5eb1b2eb-c47a-497a-a7ac-a1c230b2882f';
- //
- } finally { MTPS._injectNextScript_2 && MTPS._injectNextScript_2(); }</script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/Combined(1).js"></script><script class="mtps-injected">try {
- /**/
- (window.MTPS || (window.MTPS = {})).cdnDomains || (window.MTPS.cdnDomains = {
- "image": "https://i-msdn.sec.s-msft.com",
- "js": "https://i2-msdn.sec.s-msft.com",
- "css": "https://i-msdn.sec.s-msft.com",
- "ttf": "https://i-msdn.sec.s-msft.com"
- });
- /**/
- } finally { MTPS._injectNextScript_0 && MTPS._injectNextScript_0(); }</script><script class="mtps-injected">try {
- //
- var literalNormalizedUrl = '/en-us/library/ff554731(d=printer,l=en-us,v=vs.85).aspx';
- var wt_nvr_ru = 'WT_NVR_RU';
- var wt_fpcdom = '.microsoft.com';
- var wt_domlist = 'msdn.microsoft.com';
- var wt_pathlist = '';
- var wt_paramlist = 'DCSext.mtps_devcenter';
- var wt_siteid = 'MSDN';
- var gDomain = 'm.webtrends.com';
- var gDcsId = 'dcsmgru7m99k7mqmgrhudo0k8_8c6m';
- var gFpc = 'WT_FPC';
- if (document.cookie.indexOf(gFpc + "=") == -1) {
- var wtidJs = document.createElement("script");
- wtidJs.src = "//" + gDomain + "/" + gDcsId + "/wtid.js";
- document.getElementsByTagName("head")[0].appendChild(wtidJs);
- }
- var detectedLocale = 'en-us';
- var wtsp = 'msdnlib_w32_com';
- var gTrackEvents = '0';
- /**/
- } finally { MTPS._injectNextScript_1 && MTPS._injectNextScript_1(); }</script><script src="./Windows Kernel Development Articles (2016-03-30)_files/wtid.js"></script><script class="mtps-injected">try {
- //
- window.appInsightsId = '5eb1b2eb-c47a-497a-a7ac-a1c230b2882f';
- //
- } finally { MTPS._injectNextScript_2 && MTPS._injectNextScript_2(); }</script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/Combined.js"></script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/SearchBox.jss"></script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/SearchBox.jss"></script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/SearchBox.jss"></script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/SearchBox.jss"></script><script class="mtps-injected">try {
- /**/
- (window.MTPS || (window.MTPS = {})).cdnDomains || (window.MTPS.cdnDomains = {
- "image": "https://i-msdn.sec.s-msft.com",
- "js": "https://i2-msdn.sec.s-msft.com",
- "css": "https://i-msdn.sec.s-msft.com",
- "ttf": "https://i-msdn.sec.s-msft.com"
- });
- /**/
- } finally { MTPS._injectNextScript_0 && MTPS._injectNextScript_0(); }</script><script class="mtps-injected">try {
- //
- var literalNormalizedUrl = '/en-us/library/ff554836(d=printer,l=en-us,v=vs.85).aspx';
- var wt_nvr_ru = 'WT_NVR_RU';
- var wt_fpcdom = '.microsoft.com';
- var wt_domlist = 'msdn.microsoft.com';
- var wt_pathlist = '';
- var wt_paramlist = 'DCSext.mtps_devcenter';
- var wt_siteid = 'MSDN';
- var gDomain = 'm.webtrends.com';
- var gDcsId = 'dcsmgru7m99k7mqmgrhudo0k8_8c6m';
- var gFpc = 'WT_FPC';
- if (document.cookie.indexOf(gFpc + "=") == -1) {
- var wtidJs = document.createElement("script");
- wtidJs.src = "//" + gDomain + "/" + gDcsId + "/wtid.js";
- document.getElementsByTagName("head")[0].appendChild(wtidJs);
- }
- var detectedLocale = 'en-us';
- var wtsp = 'msdnlib_w32_com';
- var gTrackEvents = '0';
- /**/
- } finally { MTPS._injectNextScript_1 && MTPS._injectNextScript_1(); }</script><script src="./Windows Kernel Development Articles (2016-03-30)_files/wtid.js"></script><script class="mtps-injected">try {
- //
- window.appInsightsId = '5eb1b2eb-c47a-497a-a7ac-a1c230b2882f';
- //
- } finally { MTPS._injectNextScript_2 && MTPS._injectNextScript_2(); }</script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/Combined.js"></script><script class="mtps-injected">try {
- /**/
- (window.MTPS || (window.MTPS = {})).cdnDomains || (window.MTPS.cdnDomains = {
- "image": "https://i-msdn.sec.s-msft.com",
- "js": "https://i2-msdn.sec.s-msft.com",
- "css": "https://i-msdn.sec.s-msft.com",
- "ttf": "https://i-msdn.sec.s-msft.com"
- });
- /**/
- } finally { MTPS._injectNextScript_0 && MTPS._injectNextScript_0(); }</script><script class="mtps-injected">try {
- //
- var literalNormalizedUrl = '/en-us/library/hh439648(d=printer,l=en-us,v=vs.85).aspx';
- var wt_nvr_ru = 'WT_NVR_RU';
- var wt_fpcdom = '.microsoft.com';
- var wt_domlist = 'msdn.microsoft.com';
- var wt_pathlist = '';
- var wt_paramlist = 'DCSext.mtps_devcenter';
- var wt_siteid = 'MSDN';
- var gDomain = 'm.webtrends.com';
- var gDcsId = 'dcsmgru7m99k7mqmgrhudo0k8_8c6m';
- var gFpc = 'WT_FPC';
- if (document.cookie.indexOf(gFpc + "=") == -1) {
- var wtidJs = document.createElement("script");
- wtidJs.src = "//" + gDomain + "/" + gDcsId + "/wtid.js";
- document.getElementsByTagName("head")[0].appendChild(wtidJs);
- }
- var detectedLocale = 'en-us';
- var wtsp = 'msdnlib_w32_com';
- var gTrackEvents = '0';
- /**/
- } finally { MTPS._injectNextScript_1 && MTPS._injectNextScript_1(); }</script><script src="./Windows Kernel Development Articles (2016-03-30)_files/wtid.js"></script><script class="mtps-injected">try {
- //
- window.appInsightsId = '5eb1b2eb-c47a-497a-a7ac-a1c230b2882f';
- //
- } finally { MTPS._injectNextScript_2 && MTPS._injectNextScript_2(); }</script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/Combined.js"></script><script class="mtps-injected">try {
- /**/
- (window.MTPS || (window.MTPS = {})).cdnDomains || (window.MTPS.cdnDomains = {
- "image": "https://i-msdn.sec.s-msft.com",
- "js": "https://i2-msdn.sec.s-msft.com",
- "css": "https://i-msdn.sec.s-msft.com",
- "ttf": "https://i-msdn.sec.s-msft.com"
- });
- /**/
- } finally { MTPS._injectNextScript_0 && MTPS._injectNextScript_0(); }</script><script class="mtps-injected">try {
- //
- var literalNormalizedUrl = '/en-us/library/ff554721(d=printer,l=en-us,v=vs.85).aspx';
- var wt_nvr_ru = 'WT_NVR_RU';
- var wt_fpcdom = '.microsoft.com';
- var wt_domlist = 'msdn.microsoft.com';
- var wt_pathlist = '';
- var wt_paramlist = 'DCSext.mtps_devcenter';
- var wt_siteid = 'MSDN';
- var gDomain = 'm.webtrends.com';
- var gDcsId = 'dcsmgru7m99k7mqmgrhudo0k8_8c6m';
- var gFpc = 'WT_FPC';
- if (document.cookie.indexOf(gFpc + "=") == -1) {
- var wtidJs = document.createElement("script");
- wtidJs.src = "//" + gDomain + "/" + gDcsId + "/wtid.js";
- document.getElementsByTagName("head")[0].appendChild(wtidJs);
- }
- var detectedLocale = 'en-us';
- var wtsp = 'msdnlib_w32_com';
- var gTrackEvents = '0';
- /**/
- } finally { MTPS._injectNextScript_1 && MTPS._injectNextScript_1(); }</script><script src="./Windows Kernel Development Articles (2016-03-30)_files/wtid.js"></script><script class="mtps-injected">try {
- //
- window.appInsightsId = '5eb1b2eb-c47a-497a-a7ac-a1c230b2882f';
- //
- } finally { MTPS._injectNextScript_2 && MTPS._injectNextScript_2(); }</script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/Combined.js"></script><script class="mtps-injected">try {
- /**/
- (window.MTPS || (window.MTPS = {})).cdnDomains || (window.MTPS.cdnDomains = {
- "image": "https://i-msdn.sec.s-msft.com",
- "js": "https://i2-msdn.sec.s-msft.com",
- "css": "https://i-msdn.sec.s-msft.com",
- "ttf": "https://i-msdn.sec.s-msft.com"
- });
- /**/
- } finally { MTPS._injectNextScript_0 && MTPS._injectNextScript_0(); }</script><script class="mtps-injected">try {
- //
- var literalNormalizedUrl = '/en-us/library/hh439638(d=printer,l=en-us,v=vs.85).aspx';
- var wt_nvr_ru = 'WT_NVR_RU';
- var wt_fpcdom = '.microsoft.com';
- var wt_domlist = 'msdn.microsoft.com';
- var wt_pathlist = '';
- var wt_paramlist = 'DCSext.mtps_devcenter';
- var wt_siteid = 'MSDN';
- var gDomain = 'm.webtrends.com';
- var gDcsId = 'dcsmgru7m99k7mqmgrhudo0k8_8c6m';
- var gFpc = 'WT_FPC';
- if (document.cookie.indexOf(gFpc + "=") == -1) {
- var wtidJs = document.createElement("script");
- wtidJs.src = "//" + gDomain + "/" + gDcsId + "/wtid.js";
- document.getElementsByTagName("head")[0].appendChild(wtidJs);
- }
- var detectedLocale = 'en-us';
- var wtsp = 'msdnlib_w32_com';
- var gTrackEvents = '0';
- /**/
- } finally { MTPS._injectNextScript_1 && MTPS._injectNextScript_1(); }</script><script src="./Windows Kernel Development Articles (2016-03-30)_files/wtid.js"></script><script class="mtps-injected">try {
- //
- window.appInsightsId = '5eb1b2eb-c47a-497a-a7ac-a1c230b2882f';
- //
- } finally { MTPS._injectNextScript_2 && MTPS._injectNextScript_2(); }</script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/Combined.js"></script><script class="mtps-injected">try {
- /**/
- (window.MTPS || (window.MTPS = {})).cdnDomains || (window.MTPS.cdnDomains = {
- "image": "https://i-msdn.sec.s-msft.com",
- "js": "https://i2-msdn.sec.s-msft.com",
- "css": "https://i-msdn.sec.s-msft.com",
- "ttf": "https://i-msdn.sec.s-msft.com"
- });
- /**/
- } finally { MTPS._injectNextScript_0 && MTPS._injectNextScript_0(); }</script><script class="mtps-injected">try {
- //
- var literalNormalizedUrl = '/en-us/library/hh439632(d=printer,l=en-us,v=vs.85).aspx';
- var wt_nvr_ru = 'WT_NVR_RU';
- var wt_fpcdom = '.microsoft.com';
- var wt_domlist = 'msdn.microsoft.com';
- var wt_pathlist = '';
- var wt_paramlist = 'DCSext.mtps_devcenter';
- var wt_siteid = 'MSDN';
- var gDomain = 'm.webtrends.com';
- var gDcsId = 'dcsmgru7m99k7mqmgrhudo0k8_8c6m';
- var gFpc = 'WT_FPC';
- if (document.cookie.indexOf(gFpc + "=") == -1) {
- var wtidJs = document.createElement("script");
- wtidJs.src = "//" + gDomain + "/" + gDcsId + "/wtid.js";
- document.getElementsByTagName("head")[0].appendChild(wtidJs);
- }
- var detectedLocale = 'en-us';
- var wtsp = 'msdnlib_w32_com';
- var gTrackEvents = '0';
- /**/
- } finally { MTPS._injectNextScript_1 && MTPS._injectNextScript_1(); }</script><script src="./Windows Kernel Development Articles (2016-03-30)_files/wtid.js"></script><script class="mtps-injected">try {
- //
- window.appInsightsId = '5eb1b2eb-c47a-497a-a7ac-a1c230b2882f';
- //
- } finally { MTPS._injectNextScript_2 && MTPS._injectNextScript_2(); }</script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/Combined.js"></script><script class="mtps-injected">try {
- /**/
- (window.MTPS || (window.MTPS = {})).cdnDomains || (window.MTPS.cdnDomains = {
- "image": "https://i-msdn.sec.s-msft.com",
- "js": "https://i2-msdn.sec.s-msft.com",
- "css": "https://i-msdn.sec.s-msft.com",
- "ttf": "https://i-msdn.sec.s-msft.com"
- });
- /**/
- } finally { MTPS._injectNextScript_0 && MTPS._injectNextScript_0(); }</script><script class="mtps-injected">try {
- //
- var literalNormalizedUrl = '/en-us/library/hh439643(d=printer,l=en-us,v=vs.85).aspx';
- var wt_nvr_ru = 'WT_NVR_RU';
- var wt_fpcdom = '.microsoft.com';
- var wt_domlist = 'msdn.microsoft.com';
- var wt_pathlist = '';
- var wt_paramlist = 'DCSext.mtps_devcenter';
- var wt_siteid = 'MSDN';
- var gDomain = 'm.webtrends.com';
- var gDcsId = 'dcsmgru7m99k7mqmgrhudo0k8_8c6m';
- var gFpc = 'WT_FPC';
- if (document.cookie.indexOf(gFpc + "=") == -1) {
- var wtidJs = document.createElement("script");
- wtidJs.src = "//" + gDomain + "/" + gDcsId + "/wtid.js";
- document.getElementsByTagName("head")[0].appendChild(wtidJs);
- }
- var detectedLocale = 'en-us';
- var wtsp = 'msdnlib_w32_com';
- var gTrackEvents = '0';
- /**/
- } finally { MTPS._injectNextScript_1 && MTPS._injectNextScript_1(); }</script><script src="./Windows Kernel Development Articles (2016-03-30)_files/wtid.js"></script><script class="mtps-injected">try {
- //
- window.appInsightsId = '5eb1b2eb-c47a-497a-a7ac-a1c230b2882f';
- //
- } finally { MTPS._injectNextScript_2 && MTPS._injectNextScript_2(); }</script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/Combined.js"></script><script class="mtps-injected">try {
- /**/
- (window.MTPS || (window.MTPS = {})).cdnDomains || (window.MTPS.cdnDomains = {
- "image": "https://i-msdn.sec.s-msft.com",
- "js": "https://i2-msdn.sec.s-msft.com",
- "css": "https://i-msdn.sec.s-msft.com",
- "ttf": "https://i-msdn.sec.s-msft.com"
- });
- /**/
- } finally { MTPS._injectNextScript_0 && MTPS._injectNextScript_0(); }</script><script class="mtps-injected">try {
- //
- var literalNormalizedUrl = '/en-us/library/hh706279(d=printer,l=en-us,v=vs.85).aspx';
- var wt_nvr_ru = 'WT_NVR_RU';
- var wt_fpcdom = '.microsoft.com';
- var wt_domlist = 'msdn.microsoft.com';
- var wt_pathlist = '';
- var wt_paramlist = 'DCSext.mtps_devcenter';
- var wt_siteid = 'MSDN';
- var gDomain = 'm.webtrends.com';
- var gDcsId = 'dcsmgru7m99k7mqmgrhudo0k8_8c6m';
- var gFpc = 'WT_FPC';
- if (document.cookie.indexOf(gFpc + "=") == -1) {
- var wtidJs = document.createElement("script");
- wtidJs.src = "//" + gDomain + "/" + gDcsId + "/wtid.js";
- document.getElementsByTagName("head")[0].appendChild(wtidJs);
- }
- var detectedLocale = 'en-us';
- var wtsp = 'msdnlib_w32_com';
- var gTrackEvents = '0';
- /**/
- } finally { MTPS._injectNextScript_1 && MTPS._injectNextScript_1(); }</script><script src="./Windows Kernel Development Articles (2016-03-30)_files/wtid.js"></script><script class="mtps-injected">try {
- //
- window.appInsightsId = '5eb1b2eb-c47a-497a-a7ac-a1c230b2882f';
- //
- } finally { MTPS._injectNextScript_2 && MTPS._injectNextScript_2(); }</script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/Combined.js"></script><script class="mtps-injected">try {
- /**/
- (window.MTPS || (window.MTPS = {})).cdnDomains || (window.MTPS.cdnDomains = {
- "image": "https://i-msdn.sec.s-msft.com",
- "js": "https://i2-msdn.sec.s-msft.com",
- "css": "https://i-msdn.sec.s-msft.com",
- "ttf": "https://i-msdn.sec.s-msft.com"
- });
- /**/
- } finally { MTPS._injectNextScript_0 && MTPS._injectNextScript_0(); }</script><script class="mtps-injected">try {
- //
- var literalNormalizedUrl = '/en-us/library/hh706278(d=printer,l=en-us,v=vs.85).aspx';
- var wt_nvr_ru = 'WT_NVR_RU';
- var wt_fpcdom = '.microsoft.com';
- var wt_domlist = 'msdn.microsoft.com';
- var wt_pathlist = '';
- var wt_paramlist = 'DCSext.mtps_devcenter';
- var wt_siteid = 'MSDN';
- var gDomain = 'm.webtrends.com';
- var gDcsId = 'dcsmgru7m99k7mqmgrhudo0k8_8c6m';
- var gFpc = 'WT_FPC';
- if (document.cookie.indexOf(gFpc + "=") == -1) {
- var wtidJs = document.createElement("script");
- wtidJs.src = "//" + gDomain + "/" + gDcsId + "/wtid.js";
- document.getElementsByTagName("head")[0].appendChild(wtidJs);
- }
- var detectedLocale = 'en-us';
- var wtsp = 'msdnlib_w32_com';
- var gTrackEvents = '0';
- /**/
- } finally { MTPS._injectNextScript_1 && MTPS._injectNextScript_1(); }</script><script src="./Windows Kernel Development Articles (2016-03-30)_files/wtid.js"></script><script class="mtps-injected">try {
- //
- window.appInsightsId = '5eb1b2eb-c47a-497a-a7ac-a1c230b2882f';
- //
- } finally { MTPS._injectNextScript_2 && MTPS._injectNextScript_2(); }</script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/Combined.js"></script><script class="mtps-injected">try {
- /**/
- (window.MTPS || (window.MTPS = {})).cdnDomains || (window.MTPS.cdnDomains = {
- "image": "https://i-msdn.sec.s-msft.com",
- "js": "https://i2-msdn.sec.s-msft.com",
- "css": "https://i-msdn.sec.s-msft.com",
- "ttf": "https://i-msdn.sec.s-msft.com"
- });
- /**/
- } finally { MTPS._injectNextScript_0 && MTPS._injectNextScript_0(); }</script><script class="mtps-injected">try {
- //
- var literalNormalizedUrl = '/en-us/library/hh706280(d=printer,l=en-us,v=vs.85).aspx';
- var wt_nvr_ru = 'WT_NVR_RU';
- var wt_fpcdom = '.microsoft.com';
- var wt_domlist = 'msdn.microsoft.com';
- var wt_pathlist = '';
- var wt_paramlist = 'DCSext.mtps_devcenter';
- var wt_siteid = 'MSDN';
- var gDomain = 'm.webtrends.com';
- var gDcsId = 'dcsmgru7m99k7mqmgrhudo0k8_8c6m';
- var gFpc = 'WT_FPC';
- if (document.cookie.indexOf(gFpc + "=") == -1) {
- var wtidJs = document.createElement("script");
- wtidJs.src = "//" + gDomain + "/" + gDcsId + "/wtid.js";
- document.getElementsByTagName("head")[0].appendChild(wtidJs);
- }
- var detectedLocale = 'en-us';
- var wtsp = 'msdnlib_w32_com';
- var gTrackEvents = '0';
- /**/
- } finally { MTPS._injectNextScript_1 && MTPS._injectNextScript_1(); }</script><script src="./Windows Kernel Development Articles (2016-03-30)_files/wtid.js"></script><script class="mtps-injected">try {
- //
- window.appInsightsId = '5eb1b2eb-c47a-497a-a7ac-a1c230b2882f';
- //
- } finally { MTPS._injectNextScript_2 && MTPS._injectNextScript_2(); }</script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/Combined.js"></script><script class="mtps-injected">try {
- /**/
- (window.MTPS || (window.MTPS = {})).cdnDomains || (window.MTPS.cdnDomains = {
- "image": "https://i-msdn.sec.s-msft.com",
- "js": "https://i2-msdn.sec.s-msft.com",
- "css": "https://i-msdn.sec.s-msft.com",
- "ttf": "https://i-msdn.sec.s-msft.com"
- });
- /**/
- } finally { MTPS._injectNextScript_0 && MTPS._injectNextScript_0(); }</script><script class="mtps-injected">try {
- //
- var literalNormalizedUrl = '/en-us/library/ff554695(d=printer,l=en-us,v=vs.85).aspx';
- var wt_nvr_ru = 'WT_NVR_RU';
- var wt_fpcdom = '.microsoft.com';
- var wt_domlist = 'msdn.microsoft.com';
- var wt_pathlist = '';
- var wt_paramlist = 'DCSext.mtps_devcenter';
- var wt_siteid = 'MSDN';
- var gDomain = 'm.webtrends.com';
- var gDcsId = 'dcsmgru7m99k7mqmgrhudo0k8_8c6m';
- var gFpc = 'WT_FPC';
- if (document.cookie.indexOf(gFpc + "=") == -1) {
- var wtidJs = document.createElement("script");
- wtidJs.src = "//" + gDomain + "/" + gDcsId + "/wtid.js";
- document.getElementsByTagName("head")[0].appendChild(wtidJs);
- }
- var detectedLocale = 'en-us';
- var wtsp = 'msdnlib_w32_com';
- var gTrackEvents = '0';
- /**/
- } finally { MTPS._injectNextScript_1 && MTPS._injectNextScript_1(); }</script><script src="./Windows Kernel Development Articles (2016-03-30)_files/wtid.js"></script><script class="mtps-injected">try {
- //
- window.appInsightsId = '5eb1b2eb-c47a-497a-a7ac-a1c230b2882f';
- //
- } finally { MTPS._injectNextScript_2 && MTPS._injectNextScript_2(); }</script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/Combined.js"></script><script class="mtps-injected">try {
- /**/
- (window.MTPS || (window.MTPS = {})).cdnDomains || (window.MTPS.cdnDomains = {
- "image": "https://i-msdn.sec.s-msft.com",
- "js": "https://i2-msdn.sec.s-msft.com",
- "css": "https://i-msdn.sec.s-msft.com",
- "ttf": "https://i-msdn.sec.s-msft.com"
- });
- /**/
- } finally { MTPS._injectNextScript_0 && MTPS._injectNextScript_0(); }</script><script class="mtps-injected">try {
- //
- var literalNormalizedUrl = '/en-us/library/ff554887(d=printer,l=en-us,v=vs.85).aspx';
- var wt_nvr_ru = 'WT_NVR_RU';
- var wt_fpcdom = '.microsoft.com';
- var wt_domlist = 'msdn.microsoft.com';
- var wt_pathlist = '';
- var wt_paramlist = 'DCSext.mtps_devcenter';
- var wt_siteid = 'MSDN';
- var gDomain = 'm.webtrends.com';
- var gDcsId = 'dcsmgru7m99k7mqmgrhudo0k8_8c6m';
- var gFpc = 'WT_FPC';
- if (document.cookie.indexOf(gFpc + "=") == -1) {
- var wtidJs = document.createElement("script");
- wtidJs.src = "//" + gDomain + "/" + gDcsId + "/wtid.js";
- document.getElementsByTagName("head")[0].appendChild(wtidJs);
- }
- var detectedLocale = 'en-us';
- var wtsp = 'msdnlib_w32_com';
- var gTrackEvents = '0';
- /**/
- } finally { MTPS._injectNextScript_1 && MTPS._injectNextScript_1(); }</script><script src="./Windows Kernel Development Articles (2016-03-30)_files/wtid.js"></script><script class="mtps-injected">try {
- //
- window.appInsightsId = '5eb1b2eb-c47a-497a-a7ac-a1c230b2882f';
- //
- } finally { MTPS._injectNextScript_2 && MTPS._injectNextScript_2(); }</script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/Combined.js"></script><script class="mtps-injected">try {
- /**/
- (window.MTPS || (window.MTPS = {})).cdnDomains || (window.MTPS.cdnDomains = {
- "image": "https://i-msdn.sec.s-msft.com",
- "js": "https://i2-msdn.sec.s-msft.com",
- "css": "https://i-msdn.sec.s-msft.com",
- "ttf": "https://i-msdn.sec.s-msft.com"
- });
- /**/
- } finally { MTPS._injectNextScript_0 && MTPS._injectNextScript_0(); }</script><script class="mtps-injected">try {
- //
- var literalNormalizedUrl = '/en-us/library/ff554836(d=printer,l=en-us,v=vs.85).aspx';
- var wt_nvr_ru = 'WT_NVR_RU';
- var wt_fpcdom = '.microsoft.com';
- var wt_domlist = 'msdn.microsoft.com';
- var wt_pathlist = '';
- var wt_paramlist = 'DCSext.mtps_devcenter';
- var wt_siteid = 'MSDN';
- var gDomain = 'm.webtrends.com';
- var gDcsId = 'dcsmgru7m99k7mqmgrhudo0k8_8c6m';
- var gFpc = 'WT_FPC';
- if (document.cookie.indexOf(gFpc + "=") == -1) {
- var wtidJs = document.createElement("script");
- wtidJs.src = "//" + gDomain + "/" + gDcsId + "/wtid.js";
- document.getElementsByTagName("head")[0].appendChild(wtidJs);
- }
- var detectedLocale = 'en-us';
- var wtsp = 'msdnlib_w32_com';
- var gTrackEvents = '0';
- /**/
- } finally { MTPS._injectNextScript_1 && MTPS._injectNextScript_1(); }</script><script src="./Windows Kernel Development Articles (2016-03-30)_files/wtid.js"></script><script class="mtps-injected">try {
- //
- window.appInsightsId = '5eb1b2eb-c47a-497a-a7ac-a1c230b2882f';
- //
- } finally { MTPS._injectNextScript_2 && MTPS._injectNextScript_2(); }</script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/Combined.js"></script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/Combined(2).js"></script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/PrintExportButton.js"></script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/PrintExportButton.js"></script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/Combined(2).js"></script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/SearchBox.jss"></script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/SearchBox.jss"></script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/SearchBox.jss"></script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/SearchBox.jss"></script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/SearchBox.jss"></script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/SearchBox.jss"></script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/SearchBox.jss"></script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/SearchBox.jss"></script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/SearchBox.jss"></script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/SearchBox.jss"></script><script class="mtps-injected">try {
- /**/
- (window.MTPS || (window.MTPS = {})).cdnDomains || (window.MTPS.cdnDomains = {
- "image": "https://i-msdn.sec.s-msft.com",
- "js": "https://i2-msdn.sec.s-msft.com",
- "css": "https://i-msdn.sec.s-msft.com",
- "ttf": "https://i-msdn.sec.s-msft.com"
- });
- /**/
- } finally { MTPS._injectNextScript_0 && MTPS._injectNextScript_0(); }</script><script class="mtps-injected">try {
- //
- var literalNormalizedUrl = '/en-us/library/hh439648(d=printer,l=en-us,v=vs.85).aspx';
- var wt_nvr_ru = 'WT_NVR_RU';
- var wt_fpcdom = '.microsoft.com';
- var wt_domlist = 'msdn.microsoft.com';
- var wt_pathlist = '';
- var wt_paramlist = 'DCSext.mtps_devcenter';
- var wt_siteid = 'MSDN';
- var gDomain = 'm.webtrends.com';
- var gDcsId = 'dcsmgru7m99k7mqmgrhudo0k8_8c6m';
- var gFpc = 'WT_FPC';
- if (document.cookie.indexOf(gFpc + "=") == -1) {
- var wtidJs = document.createElement("script");
- wtidJs.src = "//" + gDomain + "/" + gDcsId + "/wtid.js";
- document.getElementsByTagName("head")[0].appendChild(wtidJs);
- }
- var detectedLocale = 'en-us';
- var wtsp = 'msdnlib_w32_com';
- var gTrackEvents = '0';
- /**/
- } finally { MTPS._injectNextScript_1 && MTPS._injectNextScript_1(); }</script><script src="./Windows Kernel Development Articles (2016-03-30)_files/wtid.js"></script><script class="mtps-injected">try {
- //
- window.appInsightsId = '5eb1b2eb-c47a-497a-a7ac-a1c230b2882f';
- //
- } finally { MTPS._injectNextScript_2 && MTPS._injectNextScript_2(); }</script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/Combined.js"></script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/SearchBox.jss"></script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/SearchBox.jss"></script><script class="mtps-injected">try {
- /**/
- (window.MTPS || (window.MTPS = {})).cdnDomains || (window.MTPS.cdnDomains = {
- "image": "https://i-msdn.sec.s-msft.com",
- "js": "https://i2-msdn.sec.s-msft.com",
- "css": "https://i-msdn.sec.s-msft.com",
- "ttf": "https://i-msdn.sec.s-msft.com"
- });
- /**/
- } finally { MTPS._injectNextScript_0 && MTPS._injectNextScript_0(); }</script><script class="mtps-injected">try {
- //
- var literalNormalizedUrl = '/en-us/library/ff554721(d=printer,l=en-us,v=vs.85).aspx';
- var wt_nvr_ru = 'WT_NVR_RU';
- var wt_fpcdom = '.microsoft.com';
- var wt_domlist = 'msdn.microsoft.com';
- var wt_pathlist = '';
- var wt_paramlist = 'DCSext.mtps_devcenter';
- var wt_siteid = 'MSDN';
- var gDomain = 'm.webtrends.com';
- var gDcsId = 'dcsmgru7m99k7mqmgrhudo0k8_8c6m';
- var gFpc = 'WT_FPC';
- if (document.cookie.indexOf(gFpc + "=") == -1) {
- var wtidJs = document.createElement("script");
- wtidJs.src = "//" + gDomain + "/" + gDcsId + "/wtid.js";
- document.getElementsByTagName("head")[0].appendChild(wtidJs);
- }
- var detectedLocale = 'en-us';
- var wtsp = 'msdnlib_w32_com';
- var gTrackEvents = '0';
- /**/
- } finally { MTPS._injectNextScript_1 && MTPS._injectNextScript_1(); }</script><script src="./Windows Kernel Development Articles (2016-03-30)_files/wtid.js"></script><script class="mtps-injected">try {
- //
- window.appInsightsId = '5eb1b2eb-c47a-497a-a7ac-a1c230b2882f';
- //
- } finally { MTPS._injectNextScript_2 && MTPS._injectNextScript_2(); }</script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/Combined.js"></script><script class="mtps-injected">try {
- /**/
- (window.MTPS || (window.MTPS = {})).cdnDomains || (window.MTPS.cdnDomains = {
- "image": "https://i-msdn.sec.s-msft.com",
- "js": "https://i2-msdn.sec.s-msft.com",
- "css": "https://i-msdn.sec.s-msft.com",
- "ttf": "https://i-msdn.sec.s-msft.com"
- });
- /**/
- } finally { MTPS._injectNextScript_0 && MTPS._injectNextScript_0(); }</script><script class="mtps-injected">try {
- //
- var literalNormalizedUrl = '/en-us/library/hh439638(d=printer,l=en-us,v=vs.85).aspx';
- var wt_nvr_ru = 'WT_NVR_RU';
- var wt_fpcdom = '.microsoft.com';
- var wt_domlist = 'msdn.microsoft.com';
- var wt_pathlist = '';
- var wt_paramlist = 'DCSext.mtps_devcenter';
- var wt_siteid = 'MSDN';
- var gDomain = 'm.webtrends.com';
- var gDcsId = 'dcsmgru7m99k7mqmgrhudo0k8_8c6m';
- var gFpc = 'WT_FPC';
- if (document.cookie.indexOf(gFpc + "=") == -1) {
- var wtidJs = document.createElement("script");
- wtidJs.src = "//" + gDomain + "/" + gDcsId + "/wtid.js";
- document.getElementsByTagName("head")[0].appendChild(wtidJs);
- }
- var detectedLocale = 'en-us';
- var wtsp = 'msdnlib_w32_com';
- var gTrackEvents = '0';
- /**/
- } finally { MTPS._injectNextScript_1 && MTPS._injectNextScript_1(); }</script><script src="./Windows Kernel Development Articles (2016-03-30)_files/wtid.js"></script><script class="mtps-injected">try {
- //
- window.appInsightsId = '5eb1b2eb-c47a-497a-a7ac-a1c230b2882f';
- //
- } finally { MTPS._injectNextScript_2 && MTPS._injectNextScript_2(); }</script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/Combined.js"></script><script class="mtps-injected">try {
- $(document).ready(function() {
- try {
- var token = $("#globalRequestVerification input[name='__RequestVerificationToken']").clone();
- $("#siteFeedbackForm").append(token);
- } catch(err) {
-
- }
- });
- } finally { MTPS._injectNextScript_6 && MTPS._injectNextScript_6(); }</script><script class="mtps-injected">try {
- MTPS = window.MTPS || {}; MTPS.LocalizedStrings = window.MTPS.LocalizedStrings || {}; MTPS.LocalizedStrings.ExpandButtonTooltip = 'Expand'; MTPS.LocalizedStrings.CollapseButtonTooltip = 'Collapse'; MTPS.LocalizedStrings.EnhancedExpandTooltip = 'Click to expand. Double-click to expand all.'; MTPS.LocalizedStrings.EnhancedCollapseTooltip = 'Click to collapse. Double-click to collapse all.'; MTPS.LocalizedStrings.ExpandAllButtonTooltip = 'Expand All'; MTPS.LocalizedStrings.CollapseAllButtonTooltip = 'Collapse All';
- } finally { MTPS._injectNextScript_6 && MTPS._injectNextScript_6(); }</script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/Combined(3).js"></script><script class="mtps-injected">try {
- MTPS = window.MTPS || {}; MTPS.LocalizedStrings = window.MTPS.LocalizedStrings || {}; MTPS.LocalizedStrings.ExpandButtonTooltip = 'Expand'; MTPS.LocalizedStrings.CollapseButtonTooltip = 'Collapse'; MTPS.LocalizedStrings.EnhancedExpandTooltip = 'Click to expand. Double-click to expand all.'; MTPS.LocalizedStrings.EnhancedCollapseTooltip = 'Click to collapse. Double-click to collapse all.'; MTPS.LocalizedStrings.ExpandAllButtonTooltip = 'Expand All'; MTPS.LocalizedStrings.CollapseAllButtonTooltip = 'Collapse All';
- } finally { MTPS._injectNextScript_6 && MTPS._injectNextScript_6(); }</script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/Combined(3).js"></script><script class="mtps-injected">try {
- $(document).ready(function() {
- try {
- var token = $("#globalRequestVerification input[name='__RequestVerificationToken']").clone();
- $("#siteFeedbackForm").append(token);
- } catch(err) {
-
- }
- });
- } finally { MTPS._injectNextScript_6 && MTPS._injectNextScript_6(); }</script><script class="mtps-injected">try {
- /**/
- (window.MTPS || (window.MTPS = {})).cdnDomains || (window.MTPS.cdnDomains = {
- "image": "https://i-msdn.sec.s-msft.com",
- "js": "https://i2-msdn.sec.s-msft.com",
- "css": "https://i-msdn.sec.s-msft.com",
- "ttf": "https://i-msdn.sec.s-msft.com"
- });
- /**/
- } finally { MTPS._injectNextScript_0 && MTPS._injectNextScript_0(); }</script><script class="mtps-injected">try {
- //
- var literalNormalizedUrl = '/en-us/library/hh439632(d=printer,l=en-us,v=vs.85).aspx';
- var wt_nvr_ru = 'WT_NVR_RU';
- var wt_fpcdom = '.microsoft.com';
- var wt_domlist = 'msdn.microsoft.com';
- var wt_pathlist = '';
- var wt_paramlist = 'DCSext.mtps_devcenter';
- var wt_siteid = 'MSDN';
- var gDomain = 'm.webtrends.com';
- var gDcsId = 'dcsmgru7m99k7mqmgrhudo0k8_8c6m';
- var gFpc = 'WT_FPC';
- if (document.cookie.indexOf(gFpc + "=") == -1) {
- var wtidJs = document.createElement("script");
- wtidJs.src = "//" + gDomain + "/" + gDcsId + "/wtid.js";
- document.getElementsByTagName("head")[0].appendChild(wtidJs);
- }
- var detectedLocale = 'en-us';
- var wtsp = 'msdnlib_w32_com';
- var gTrackEvents = '0';
- /**/
- } finally { MTPS._injectNextScript_1 && MTPS._injectNextScript_1(); }</script><script src="./Windows Kernel Development Articles (2016-03-30)_files/wtid.js"></script><script class="mtps-injected">try {
- //
- window.appInsightsId = '5eb1b2eb-c47a-497a-a7ac-a1c230b2882f';
- //
- } finally { MTPS._injectNextScript_2 && MTPS._injectNextScript_2(); }</script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/Combined.js"></script><script class="mtps-injected">try {
- /**/
- (window.MTPS || (window.MTPS = {})).cdnDomains || (window.MTPS.cdnDomains = {
- "image": "https://i-msdn.sec.s-msft.com",
- "js": "https://i2-msdn.sec.s-msft.com",
- "css": "https://i-msdn.sec.s-msft.com",
- "ttf": "https://i-msdn.sec.s-msft.com"
- });
- /**/
- } finally { MTPS._injectNextScript_0 && MTPS._injectNextScript_0(); }</script><script class="mtps-injected">try {
- //
- var literalNormalizedUrl = '/en-us/library/hh439643(d=printer,l=en-us,v=vs.85).aspx';
- var wt_nvr_ru = 'WT_NVR_RU';
- var wt_fpcdom = '.microsoft.com';
- var wt_domlist = 'msdn.microsoft.com';
- var wt_pathlist = '';
- var wt_paramlist = 'DCSext.mtps_devcenter';
- var wt_siteid = 'MSDN';
- var gDomain = 'm.webtrends.com';
- var gDcsId = 'dcsmgru7m99k7mqmgrhudo0k8_8c6m';
- var gFpc = 'WT_FPC';
- if (document.cookie.indexOf(gFpc + "=") == -1) {
- var wtidJs = document.createElement("script");
- wtidJs.src = "//" + gDomain + "/" + gDcsId + "/wtid.js";
- document.getElementsByTagName("head")[0].appendChild(wtidJs);
- }
- var detectedLocale = 'en-us';
- var wtsp = 'msdnlib_w32_com';
- var gTrackEvents = '0';
- /**/
- } finally { MTPS._injectNextScript_1 && MTPS._injectNextScript_1(); }</script><script src="./Windows Kernel Development Articles (2016-03-30)_files/wtid.js"></script><script class="mtps-injected">try {
- //
- window.appInsightsId = '5eb1b2eb-c47a-497a-a7ac-a1c230b2882f';
- //
- } finally { MTPS._injectNextScript_2 && MTPS._injectNextScript_2(); }</script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/Combined.js"></script><script class="mtps-injected">try {
- /**/
- (window.MTPS || (window.MTPS = {})).cdnDomains || (window.MTPS.cdnDomains = {
- "image": "https://i-msdn.sec.s-msft.com",
- "js": "https://i2-msdn.sec.s-msft.com",
- "css": "https://i-msdn.sec.s-msft.com",
- "ttf": "https://i-msdn.sec.s-msft.com"
- });
- /**/
- } finally { MTPS._injectNextScript_0 && MTPS._injectNextScript_0(); }</script><script class="mtps-injected">try {
- //
- var literalNormalizedUrl = '/en-us/library/hh706279(d=printer,l=en-us,v=vs.85).aspx';
- var wt_nvr_ru = 'WT_NVR_RU';
- var wt_fpcdom = '.microsoft.com';
- var wt_domlist = 'msdn.microsoft.com';
- var wt_pathlist = '';
- var wt_paramlist = 'DCSext.mtps_devcenter';
- var wt_siteid = 'MSDN';
- var gDomain = 'm.webtrends.com';
- var gDcsId = 'dcsmgru7m99k7mqmgrhudo0k8_8c6m';
- var gFpc = 'WT_FPC';
- if (document.cookie.indexOf(gFpc + "=") == -1) {
- var wtidJs = document.createElement("script");
- wtidJs.src = "//" + gDomain + "/" + gDcsId + "/wtid.js";
- document.getElementsByTagName("head")[0].appendChild(wtidJs);
- }
- var detectedLocale = 'en-us';
- var wtsp = 'msdnlib_w32_com';
- var gTrackEvents = '0';
- /**/
- } finally { MTPS._injectNextScript_1 && MTPS._injectNextScript_1(); }</script><script src="./Windows Kernel Development Articles (2016-03-30)_files/wtid.js"></script><script class="mtps-injected">try {
- //
- window.appInsightsId = '5eb1b2eb-c47a-497a-a7ac-a1c230b2882f';
- //
- } finally { MTPS._injectNextScript_2 && MTPS._injectNextScript_2(); }</script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/Combined.js"></script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/Combined(2).js"></script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/Combined(2).js"></script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/Combined(2).js"></script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/Combined(2).js"></script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/Combined(2).js"></script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/Combined(2).js"></script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/Combined(2).js"></script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/Combined(2).js"></script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/Combined(2).js"></script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/Combined(2).js"></script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/SearchBox.jss"></script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/Combined(2).js"></script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/Combined(2).js"></script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/SearchBox.jss"></script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/SearchBox.jss"></script><script class="mtps-injected">try {
- /**/
- (window.MTPS || (window.MTPS = {})).cdnDomains || (window.MTPS.cdnDomains = {
- "image": "https://i-msdn.sec.s-msft.com",
- "js": "https://i2-msdn.sec.s-msft.com",
- "css": "https://i-msdn.sec.s-msft.com",
- "ttf": "https://i-msdn.sec.s-msft.com"
- });
- /**/
- } finally { MTPS._injectNextScript_0 && MTPS._injectNextScript_0(); }</script><script class="mtps-injected">try {
- //
- var literalNormalizedUrl = '/en-us/library/hh706278(d=printer,l=en-us,v=vs.85).aspx';
- var wt_nvr_ru = 'WT_NVR_RU';
- var wt_fpcdom = '.microsoft.com';
- var wt_domlist = 'msdn.microsoft.com';
- var wt_pathlist = '';
- var wt_paramlist = 'DCSext.mtps_devcenter';
- var wt_siteid = 'MSDN';
- var gDomain = 'm.webtrends.com';
- var gDcsId = 'dcsmgru7m99k7mqmgrhudo0k8_8c6m';
- var gFpc = 'WT_FPC';
- if (document.cookie.indexOf(gFpc + "=") == -1) {
- var wtidJs = document.createElement("script");
- wtidJs.src = "//" + gDomain + "/" + gDcsId + "/wtid.js";
- document.getElementsByTagName("head")[0].appendChild(wtidJs);
- }
- var detectedLocale = 'en-us';
- var wtsp = 'msdnlib_w32_com';
- var gTrackEvents = '0';
- /**/
- } finally { MTPS._injectNextScript_1 && MTPS._injectNextScript_1(); }</script><script src="./Windows Kernel Development Articles (2016-03-30)_files/wtid.js"></script><script class="mtps-injected">try {
- //
- window.appInsightsId = '5eb1b2eb-c47a-497a-a7ac-a1c230b2882f';
- //
- } finally { MTPS._injectNextScript_2 && MTPS._injectNextScript_2(); }</script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/Combined.js"></script><script class="mtps-injected">try {
- $(document).ready(function() {
- try {
- var token = $("#globalRequestVerification input[name='__RequestVerificationToken']").clone();
- $("#siteFeedbackForm").append(token);
- } catch(err) {
-
- }
- });
- } finally { MTPS._injectNextScript_8 && MTPS._injectNextScript_8(); }</script><script class="mtps-injected">try {
- $(document).ready(function() {
- try {
- var token = $("#globalRequestVerification input[name='__RequestVerificationToken']").clone();
- $("#siteFeedbackForm").append(token);
- } catch(err) {
-
- }
- });
- } finally { MTPS._injectNextScript_8 && MTPS._injectNextScript_8(); }</script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/SearchBox.jss"></script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/SearchBox.jss"></script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/SearchBox.jss"></script><script class="mtps-injected">try {
- /**/
- (window.MTPS || (window.MTPS = {})).cdnDomains || (window.MTPS.cdnDomains = {
- "image": "https://i-msdn.sec.s-msft.com",
- "js": "https://i2-msdn.sec.s-msft.com",
- "css": "https://i-msdn.sec.s-msft.com",
- "ttf": "https://i-msdn.sec.s-msft.com"
- });
- /**/
- } finally { MTPS._injectNextScript_0 && MTPS._injectNextScript_0(); }</script><script class="mtps-injected">try {
- //
- var literalNormalizedUrl = '/en-us/library/hh706280(d=printer,l=en-us,v=vs.85).aspx';
- var wt_nvr_ru = 'WT_NVR_RU';
- var wt_fpcdom = '.microsoft.com';
- var wt_domlist = 'msdn.microsoft.com';
- var wt_pathlist = '';
- var wt_paramlist = 'DCSext.mtps_devcenter';
- var wt_siteid = 'MSDN';
- var gDomain = 'm.webtrends.com';
- var gDcsId = 'dcsmgru7m99k7mqmgrhudo0k8_8c6m';
- var gFpc = 'WT_FPC';
- if (document.cookie.indexOf(gFpc + "=") == -1) {
- var wtidJs = document.createElement("script");
- wtidJs.src = "//" + gDomain + "/" + gDcsId + "/wtid.js";
- document.getElementsByTagName("head")[0].appendChild(wtidJs);
- }
- var detectedLocale = 'en-us';
- var wtsp = 'msdnlib_w32_com';
- var gTrackEvents = '0';
- /**/
- } finally { MTPS._injectNextScript_1 && MTPS._injectNextScript_1(); }</script><script src="./Windows Kernel Development Articles (2016-03-30)_files/wtid.js"></script><script class="mtps-injected">try {
- //
- window.appInsightsId = '5eb1b2eb-c47a-497a-a7ac-a1c230b2882f';
- //
- } finally { MTPS._injectNextScript_2 && MTPS._injectNextScript_2(); }</script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/Combined.js"></script><script class="mtps-injected">try {
- $(document).ready(function() {
- try {
- var token = $("#globalRequestVerification input[name='__RequestVerificationToken']").clone();
- $("#siteFeedbackForm").append(token);
- } catch(err) {
-
- }
- });
- } finally { MTPS._injectNextScript_6 && MTPS._injectNextScript_6(); }</script><script class="mtps-injected">try {
- $(document).ready(function() {
- try {
- var token = $("#globalRequestVerification input[name='__RequestVerificationToken']").clone();
- $("#siteFeedbackForm").append(token);
- } catch(err) {
-
- }
- });
- } finally { MTPS._injectNextScript_6 && MTPS._injectNextScript_6(); }</script><script class="mtps-injected">try {
- $(document).ready(function() {
- try {
- var token = $("#globalRequestVerification input[name='__RequestVerificationToken']").clone();
- $("#siteFeedbackForm").append(token);
- } catch(err) {
-
- }
- });
- } finally { MTPS._injectNextScript_6 && MTPS._injectNextScript_6(); }</script><script class="mtps-injected">try {
- $(document).ready(function() {
- try {
- var token = $("#globalRequestVerification input[name='__RequestVerificationToken']").clone();
- $("#siteFeedbackForm").append(token);
- } catch(err) {
-
- }
- });
- } finally { MTPS._injectNextScript_6 && MTPS._injectNextScript_6(); }</script><script class="mtps-injected">try {
- $(document).ready(function() {
- try {
- var token = $("#globalRequestVerification input[name='__RequestVerificationToken']").clone();
- $("#siteFeedbackForm").append(token);
- } catch(err) {
-
- }
- });
- } finally { MTPS._injectNextScript_6 && MTPS._injectNextScript_6(); }</script><script class="mtps-injected">try {
- $(document).ready(function() {
- try {
- var token = $("#globalRequestVerification input[name='__RequestVerificationToken']").clone();
- $("#siteFeedbackForm").append(token);
- } catch(err) {
-
- }
- });
- } finally { MTPS._injectNextScript_6 && MTPS._injectNextScript_6(); }</script><script class="mtps-injected">try {
- $(document).ready(function() {
- try {
- var token = $("#globalRequestVerification input[name='__RequestVerificationToken']").clone();
- $("#siteFeedbackForm").append(token);
- } catch(err) {
-
- }
- });
- } finally { MTPS._injectNextScript_6 && MTPS._injectNextScript_6(); }</script><script class="mtps-injected">try {
- $(document).ready(function() {
- try {
- var token = $("#globalRequestVerification input[name='__RequestVerificationToken']").clone();
- $("#siteFeedbackForm").append(token);
- } catch(err) {
-
- }
- });
- } finally { MTPS._injectNextScript_6 && MTPS._injectNextScript_6(); }</script><script class="mtps-injected">try {
- $(document).ready(function() {
- try {
- var token = $("#globalRequestVerification input[name='__RequestVerificationToken']").clone();
- $("#siteFeedbackForm").append(token);
- } catch(err) {
-
- }
- });
- } finally { MTPS._injectNextScript_6 && MTPS._injectNextScript_6(); }</script><script class="mtps-injected">try {
- $(document).ready(function() {
- try {
- var token = $("#globalRequestVerification input[name='__RequestVerificationToken']").clone();
- $("#siteFeedbackForm").append(token);
- } catch(err) {
-
- }
- });
- } finally { MTPS._injectNextScript_6 && MTPS._injectNextScript_6(); }</script><script class="mtps-injected">try {
- /**/
- (window.MTPS || (window.MTPS = {})).cdnDomains || (window.MTPS.cdnDomains = {
- "image": "https://i-msdn.sec.s-msft.com",
- "js": "https://i2-msdn.sec.s-msft.com",
- "css": "https://i-msdn.sec.s-msft.com",
- "ttf": "https://i-msdn.sec.s-msft.com"
- });
- /**/
- } finally { MTPS._injectNextScript_0 && MTPS._injectNextScript_0(); }</script><script class="mtps-injected">try {
- //
- var literalNormalizedUrl = '/en-us/library/ff554695(d=printer,l=en-us,v=vs.85).aspx';
- var wt_nvr_ru = 'WT_NVR_RU';
- var wt_fpcdom = '.microsoft.com';
- var wt_domlist = 'msdn.microsoft.com';
- var wt_pathlist = '';
- var wt_paramlist = 'DCSext.mtps_devcenter';
- var wt_siteid = 'MSDN';
- var gDomain = 'm.webtrends.com';
- var gDcsId = 'dcsmgru7m99k7mqmgrhudo0k8_8c6m';
- var gFpc = 'WT_FPC';
- if (document.cookie.indexOf(gFpc + "=") == -1) {
- var wtidJs = document.createElement("script");
- wtidJs.src = "//" + gDomain + "/" + gDcsId + "/wtid.js";
- document.getElementsByTagName("head")[0].appendChild(wtidJs);
- }
- var detectedLocale = 'en-us';
- var wtsp = 'msdnlib_w32_com';
- var gTrackEvents = '0';
- /**/
- } finally { MTPS._injectNextScript_1 && MTPS._injectNextScript_1(); }</script><script src="./Windows Kernel Development Articles (2016-03-30)_files/wtid.js"></script><script class="mtps-injected">try {
- //
- window.appInsightsId = '5eb1b2eb-c47a-497a-a7ac-a1c230b2882f';
- //
- } finally { MTPS._injectNextScript_2 && MTPS._injectNextScript_2(); }</script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/Combined.js"></script><script class="mtps-injected">try {
- /**/
- (window.MTPS || (window.MTPS = {})).cdnDomains || (window.MTPS.cdnDomains = {
- "image": "https://i-msdn.sec.s-msft.com",
- "js": "https://i2-msdn.sec.s-msft.com",
- "css": "https://i-msdn.sec.s-msft.com",
- "ttf": "https://i-msdn.sec.s-msft.com"
- });
- /**/
- } finally { MTPS._injectNextScript_0 && MTPS._injectNextScript_0(); }</script><script class="mtps-injected">try {
- //
- var literalNormalizedUrl = '/en-us/library/ff554887(d=printer,l=en-us,v=vs.85).aspx';
- var wt_nvr_ru = 'WT_NVR_RU';
- var wt_fpcdom = '.microsoft.com';
- var wt_domlist = 'msdn.microsoft.com';
- var wt_pathlist = '';
- var wt_paramlist = 'DCSext.mtps_devcenter';
- var wt_siteid = 'MSDN';
- var gDomain = 'm.webtrends.com';
- var gDcsId = 'dcsmgru7m99k7mqmgrhudo0k8_8c6m';
- var gFpc = 'WT_FPC';
- if (document.cookie.indexOf(gFpc + "=") == -1) {
- var wtidJs = document.createElement("script");
- wtidJs.src = "//" + gDomain + "/" + gDcsId + "/wtid.js";
- document.getElementsByTagName("head")[0].appendChild(wtidJs);
- }
- var detectedLocale = 'en-us';
- var wtsp = 'msdnlib_w32_com';
- var gTrackEvents = '0';
- /**/
- } finally { MTPS._injectNextScript_1 && MTPS._injectNextScript_1(); }</script><script src="./Windows Kernel Development Articles (2016-03-30)_files/wtid.js"></script><script class="mtps-injected">try {
- //
- window.appInsightsId = '5eb1b2eb-c47a-497a-a7ac-a1c230b2882f';
- //
- } finally { MTPS._injectNextScript_2 && MTPS._injectNextScript_2(); }</script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/Combined.js"></script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/Combined(2).js"></script><script class="mtps-injected">try {
- $(document).ready(function() {
- try {
- var token = $("#globalRequestVerification input[name='__RequestVerificationToken']").clone();
- $("#siteFeedbackForm").append(token);
- } catch(err) {
-
- }
- });
- } finally { MTPS._injectNextScript_6 && MTPS._injectNextScript_6(); }</script><script class="mtps-injected">try {
- $(document).ready(function() {
- try {
- var token = $("#globalRequestVerification input[name='__RequestVerificationToken']").clone();
- $("#siteFeedbackForm").append(token);
- } catch(err) {
-
- }
- });
- } finally { MTPS._injectNextScript_6 && MTPS._injectNextScript_6(); }</script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/Combined(2).js"></script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/Combined(2).js"></script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/SearchBox.jss"></script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/Combined(2).js"></script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/Combined(2).js"></script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/Combined(2).js"></script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/SearchBox.jss"></script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/SearchBox.jss"></script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/SearchBox.jss"></script><script class="mtps-injected">try {
- $(document).ready(function() {
- try {
- var token = $("#globalRequestVerification input[name='__RequestVerificationToken']").clone();
- $("#siteFeedbackForm").append(token);
- } catch(err) {
-
- }
- });
- } finally { MTPS._injectNextScript_6 && MTPS._injectNextScript_6(); }</script><script class="mtps-injected">try {
- $(document).ready(function() {
- try {
- var token = $("#globalRequestVerification input[name='__RequestVerificationToken']").clone();
- $("#siteFeedbackForm").append(token);
- } catch(err) {
-
- }
- });
- } finally { MTPS._injectNextScript_6 && MTPS._injectNextScript_6(); }</script><script class="mtps-injected">try {
- $(document).ready(function() {
- try {
- var token = $("#globalRequestVerification input[name='__RequestVerificationToken']").clone();
- $("#siteFeedbackForm").append(token);
- } catch(err) {
-
- }
- });
- } finally { MTPS._injectNextScript_6 && MTPS._injectNextScript_6(); }</script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/Combined(2).js"></script><script class="mtps-injected">try {
- $(document).ready(function() {
- try {
- var token = $("#globalRequestVerification input[name='__RequestVerificationToken']").clone();
- $("#siteFeedbackForm").append(token);
- } catch(err) {
-
- }
- });
- } finally { MTPS._injectNextScript_6 && MTPS._injectNextScript_6(); }</script><script class="mtps-injected">try {
- $(document).ready(function() {
- try {
- var token = $("#globalRequestVerification input[name='__RequestVerificationToken']").clone();
- $("#siteFeedbackForm").append(token);
- } catch(err) {
-
- }
- });
- } finally { MTPS._injectNextScript_6 && MTPS._injectNextScript_6(); }</script><script class="mtps-injected">try {
- $(document).ready(function() {
- try {
- var token = $("#globalRequestVerification input[name='__RequestVerificationToken']").clone();
- $("#siteFeedbackForm").append(token);
- } catch(err) {
-
- }
- });
- } finally { MTPS._injectNextScript_6 && MTPS._injectNextScript_6(); }</script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/Combined(2).js"></script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/Combined(2).js"></script><script class="mtps-injected" src="./Windows Kernel Development Articles (2016-03-30)_files/Combined(2).js"></script><script class="mtps-injected">try {
- $(document).ready(function() {
- try {
- var token = $("#globalRequestVerification input[name='__RequestVerificationToken']").clone();
- $("#siteFeedbackForm").append(token);
- } catch(err) {
-
- }
- });
- } finally { MTPS._injectNextScript_6 && MTPS._injectNextScript_6(); }</script><script class="mtps-injected">try {
- $(document).ready(function() {
- try {
- var token = $("#globalRequestVerification input[name='__RequestVerificationToken']").clone();
- $("#siteFeedbackForm").append(token);
- } catch(err) {
-
- }
- });
- } finally { MTPS._injectNextScript_6 && MTPS._injectNextScript_6(); }</script><script class="mtps-injected">try {
- $(document).ready(function() {
- try {
- var token = $("#globalRequestVerification input[name='__RequestVerificationToken']").clone();
- $("#siteFeedbackForm").append(token);
- } catch(err) {
-
- }
- });
- } finally { MTPS._injectNextScript_6 && MTPS._injectNextScript_6(); }</script><script class="mtps-injected">try {
- $(document).ready(function() {
- try {
- var token = $("#globalRequestVerification input[name='__RequestVerificationToken']").clone();
- $("#siteFeedbackForm").append(token);
- } catch(err) {
-
- }
- });
- } finally { MTPS._injectNextScript_6 && MTPS._injectNextScript_6(); }</script></head><body>
- <link href="./Windows Kernel Development Articles (2016-03-30)_files/PrintBook.css" rel="stylesheet" type="text/css"> <div class="BookHeader"><div class="BookTitleHeading">My Collection</div><div class="PabLogo"><a href="http://msdn.microsoft.com/" title="Microsoft Developer Network"><img alt="Microsoft Developer Network" src="./Windows Kernel Development Articles (2016-03-30)_files/BrandLogoMsdn.png"></a></div><div style="clear: both"></div><div class="pageBlank"><div class="pageFooter"><hr class="pageFooterSeparater">This document is provided "as-is". Information and views expressed in this document, including URL and other Internet Web site references, may change without notice. This document does not provide you with any legal rights to any intellectual property in any Microsoft product or product name. You may copy and use this document for your internal, reference purposes. You may modify this document for your internal, reference purposes.© 2016 Microsoft. All rights reserved. Terms of Use (https://msdn.microsoft.com/cc300389.aspx) | Trademarks (http://www.microsoft.com/library/toolbar/3.0/trademarks/en-us.mspx)</div></div></div><p style="page-break-before: always"></p><div class="TableOfContents"><hr class="pageSplitter"><div class="TableOfContentsTitle">Table Of Contents</div><div class="ChapterName">Chapter 1</div><div><a href="http://msdn.microsoft.com/en-us/library/ms809754.aspx" class="TopicLink">The Debugging Application Programming Interface</a></div><div><a href="https://msdn.microsoft.com/en-us/library/dn655038.aspx" class="TopicLink">/CGTHREADS (Compiler Threads)</a></div><div><a href="https://msdn.microsoft.com/en-us/library/t6tay6cz.aspx" class="TopicLink">Getting Started (Debug Interface Access SDK)</a></div><div><a href="https://msdn.microsoft.com/en-us/library/ff554731(v=vs.85).aspx" class="TopicLink">Concepts for all driver developers</a></div><div><a href="https://msdn.microsoft.com/en-us/library/ff554836(v=vs.85).aspx" class="TopicLink">User mode and kernel mode</a></div><div><a href="https://msdn.microsoft.com/en-us/library/hh439648(v=vs.85).aspx" class="TopicLink">Virtual address spaces</a></div><div><a href="https://msdn.microsoft.com/en-us/library/ff554721(v=vs.85).aspx" class="TopicLink">Device nodes and device stacks</a></div><div><a href="https://msdn.microsoft.com/en-us/library/hh439638(v=vs.85).aspx" class="TopicLink">I/O request packets</a></div><div><a href="https://msdn.microsoft.com/en-us/library/hh439632(v=vs.85).aspx" class="TopicLink">Driver stacks</a></div><div><a href="https://msdn.microsoft.com/en-us/library/hh439643(v=vs.85).aspx" class="TopicLink">Minidrivers, miniport drivers, and driver pairs</a></div><div><a href="https://msdn.microsoft.com/en-us/library/hh706279(v=vs.85).aspx" class="TopicLink">KMDF as a generic driver pair model</a></div><div><a href="https://msdn.microsoft.com/en-us/library/hh706278(v=vs.85).aspx" class="TopicLink">KMDF extensions and driver triples</a></div><div><a href="https://msdn.microsoft.com/en-us/library/hh706280(v=vs.85).aspx" class="TopicLink">Upper and lower edges of drivers</a></div><div><a href="https://msdn.microsoft.com/en-us/library/ff554695(v=vs.85).aspx" class="TopicLink">Header files in the Windows Driver Kit</a></div><div><a href="https://msdn.microsoft.com/en-us/library/ff554887(v=vs.85).aspx" class="TopicLink">Writing drivers for different versions of Windows</a></div><div class="chapterSplitter"></div><div style="clear: both"></div></div><p style="page-break-before: always"></p>
- <hr class="pageSplitter"><div class="ChapterTitle">Chapter 1</div>
- <link rel="stylesheet" type="text/css" href="./Windows Kernel Development Articles (2016-03-30)_files/Combined.css">
- <div id="page">
-
-
-
-
- <link type="text/css" rel="stylesheet">
-
- <input type="hidden" id="isHeaderBleeding" value="true">
- <div id="ux-header" dir="ltr" class="ltr msdn">
-
- <header>
- <span id="singleCol"></span>
- <span id="doubleCol"></span>
- <span id="isMobile"></span>
- <div>
- <div class="row topRow">
- <div class="top">
- <div class="left">
- <a class="msdnLogoImg" href="https://msdn.microsoft.com/en-us" title="MSDN home">
- <div id="msft-logo" class="msft-logo"></div>
- </a>
- <div class="GrayPipe"></div>
- <a class="DevCenterFullNameNonMegaBlade" href="https://msdn.microsoft.com/en-us">Developer Network</a>
- <a class="DevCenterFullName" href="https://msdn.microsoft.com/en-us">Developer Network</a>
- <a class="DevCenterShortName" href="https://msdn.microsoft.com/en-us">Developer</a>
- </div>
- <div class="right">
- <div id="signIn">
- <div class="profileImage"></div>
- <a class="scarabLink" href="https://login.live.com/login.srf?wa=wsignin1.0&rpsnv=12&ct=1459376395&rver=6.0.5276.0&wp=mcmbi&wlcxt=msdn%24msdn%24msdn&wreply=https%3a%2f%2fmsdn.microsoft.com%2fen-us%2flibrary%2fms809754%2528d%3dprinter%2529.aspx%3flan%3dcsharp%26cc%3dn%26trm%3dtra%26view%3dbook&lc=1033&id=254354&mkt=en-us" title="Sign in">Sign in</a></div>
- <div class="auxNav">
- <div>
- <div data-fragmentname="Subscriptions" id="Fragment_Subscriptions" xmlns="http://www.w3.org/1999/xhtml">
- <a href="https://msdn.microsoft.com/subscriptions/manage/hh442900" id="Subscriptions_2153_1" xmlns="http://www.w3.org/1999/xhtml">MSDN subscriptions</a>
- </div>
- <div data-fragmentname="GetTools" id="Fragment_GetTools" xmlns="http://www.w3.org/1999/xhtml">
- <a href="http://go.microsoft.com/fwlink/?LinkId=309297&clcid=0x409&slcid=0x409&campaign=o~msft~msdn~gettools-header~dn308572" id="GetTools_2153_3" xmlns="http://www.w3.org/1999/xhtml">Get tools</a>
- </div>
- </div>
- <div>
- <div data-fragmentname="SocialLinks" id="Fragment_SocialLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <ul class="links horizontal">
- <li>
- <a href="http://www.facebook.com/microsoftdeveloper" target="_blank" id="SocialLinks_2152_4" class="facebook" xmlns="http://www.w3.org/1999/xhtml">http://www.facebook.com/microsoftdeveloper</a>
- </li>
- <li>
- <a href="https://twitter.com/msdev" target="_blank" id="SocialLinks_2152_5" class="twitter" xmlns="http://www.w3.org/1999/xhtml">https://twitter.com/msdev</a>
- </li>
- <li>
- <a href="http://plus.google.com/111221966647232053570/" target="_blank" id="SocialLinks_2152_6" class="googlePlus" xmlns="http://www.w3.org/1999/xhtml">http://plus.google.com/111221966647232053570/</a>
- </li>
- </ul>
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- <div class="row middleRow">
- <div class="expandTop">
- <div class="left"></div>
- <div class="right"></div>
- </div>
- </div>
- </div>
- <div id="buttomRowWrapper" class="bg_default">
- <div class="row buttomRow bg_default">
- <div class="bottom">
- <div class="left">
- <a id="grip" class="menu-icon" href="javascript:void(0)"></a>
-
- <div id="drawer">
- <div class="toc">
-
- <nav>
- <ul class="navL1">
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Technologies">Technologies</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/cloud-app-development-msdn" title="Cloud">Cloud</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/app-development-msdn" title="App Development">App Development</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/web-app-development-msdn" title="Web">Web</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/big-data-development-msdn" title="Data">Data</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/games-development-msdn" title="Gaming">Gaming</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/internetofthings" title="Internet of Things">Internet of Things</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Downloads">Downloads</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://www.visualstudio.com/downloads/download-visual-studio-vs" title="Visual Studio">Visual Studio</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/subscriptions" title="MSDN subscription access">MSDN subscription access</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/microsoft-sdks-msdn" title="SDKs">SDKs</a>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Trial software">Trial software</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/evalcenter" title="Free downloads">Free downloads</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/officeevaluationresources" title="Office resources">Office resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/sharepoint2013resources" title="SharePoint Server 2013 resources">SharePoint Server 2013 resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/sqlserver2014expressresources" title="SQL Server 2014 Express resources">SQL Server 2014 Express resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/windowsserver2012r2resources" title="Windows Server 2012 resources">Windows Server 2012 resources</a>
- </li>
- </ul>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Programs">Programs</a>
- <ul class="navL2">
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Visual Studio subscriptions">Visual Studio subscriptions</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/msdn-subscriptions-overview" title="Overview">Overview</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/benefits-overview" title="Benefits">Benefits</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/msdn-subscriptions-administration" title="Administrators">Administrators</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Students">Students</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/imagine/imagine-home" title="Microsoft Imagine">Microsoft Imagine</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/microsoftstudentpartners" title="Microsoft Student Partners">Microsoft Student Partners</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Architects">Architects</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-overview-msdn" title="Overview">Overview</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-case-studies-msdn" title="Case studies">Case studies</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-blueprints-msdn" title="Blueprints">Blueprints</a>
- </li>
- <li class="inactive">
- <a href="http://blogs.msdn.com/b/msarchitecture/" title="Blog">Blog</a>
- </li>
- <li class="inactive">
- <a href="http://social.msdn.microsoft.com/forums/en-us/home?brandignore=true&sort=relevancedesc&searchterm=architecture+or+architect" title="Forums">Forums</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/applicationbuilder" title="ISV">ISV</a>
-
- </li>
- <li class="inactive">
- <a href="https://www.microsoft.com/bizspark" title="Startups">Startups</a>
-
- </li>
- <li class="inactive">
- <a href="https://rewards.msdn.microsoft.com/" title="TechRewards">TechRewards</a>
-
- </li>
- <li class="inactive">
- <a href="http://events.msdn.microsoft.com/" title="Events">Events</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Community">Community</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/magazine/dd767791" title="Magazine">Magazine</a>
-
- </li>
- <li class="inactive">
- <a href="https://social.msdn.microsoft.com/forums/" title="Forums">Forums</a>
-
- </li>
- <li class="inactive">
- <a href="http://blogs.msdn.com/b/developer-tools/" title="Blogs">Blogs</a>
-
- </li>
- <li class="inactive">
- <a href="http://tech-advisors.msdn.microsoft.com/en-us" title="Tech Advisors">Tech Advisors</a>
-
- </li>
- <li class="inactive">
- <a href="http://channel9.msdn.com/" title="Channel 9">Channel 9</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive current toggle">
- <a href="javascript:void(0)" title="Documentation">Documentation</a>
- <ul class="navL2">
- <li class="inactive current">
- <a href="https://msdn.microsoft.com/library" title="APIs and reference">APIs and reference</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/developer-centers-msdn" title="Dev centers">Dev centers</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive">
- <a href="https://code.msdn.microsoft.com/" title="Samples">Samples</a>
- </li>
- </ul>
- </nav>
- </div>
- </div>
- </div>
- <div class="right">
- <div data-fragmentname="SearchBox" id="Fragment_SearchBox" xmlns="http://www.w3.org/1999/xhtml">
- <div class="SearchBox">
- <form id="HeaderSearchForm" name="HeaderSearchForm" method="get">
- <button id="FakeHeaderSearchButton" value="Search" type="submit" class="header-search-button">
- <div id="search-finder" class="search-finder"></div>
- </button>
- <button id="HeaderSearchButton" style="display:none"></button>
- <div id="searchSplitter"></div>
- <div id="searchCloseIcon" class="search-clear-x"></div>
- <div id="searchTextContainer" style="width: 0;">
- <input id="HeaderSearchTextBox" name="query" type="text" maxlength="200" onfocus="Epx.Controls.SearchBox.watermarkFocus(event, this.title)" onblur="Epx.Controls.SearchBox.watermarkBlur(event, this.title)">
- </div>
- </form>
-
-
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- </header>
- </div>
-
-
-
- <div class="printExportMenus ltr">
- <a id="isd_printABook" href="http://msdn.microsoft.com/en-us/library/export/help/(d=printer)?returnurl=%2fen-us%2flibrary%2fms809754(d%3dprinter).aspx%3flan%3dcsharp%26cc%3dn%26trm%3dtra%26view%3dbook">
- Export (<span class="count">0</span>)
- </a>
- <a id="isd_print" href="https://msdn.microsoft.com/en-us/library/ms809754(d=printer).aspx?lan=csharp&cc=n&trm=tra&view=book" rel="nofollow">
- Print
- </a>
- <a id="isd_archiveControl" style="display:none;" data-include-archive="Include Previous Version" data-exclude-archive="Exclude Previous Version">
- </a>
- </div>
-
- <div class="printExportMenus ltr">
- <a id="expandCollapseAll" accesskey="e" href="javascript:void(0)" title="Expand/Collapse all sections by pressing Ctrl + Shift + e">Expand All</a>
- </div>
-
- <div id="body" ms.pgarea="body">
- <span id="tabletView_large"></span>
- <span id="tabletView_small"></span>
- <span id="mobileView"></span>
-
- <div id="content" class="content">
- <input type="hidden" id="printForPab" value="true">
-
- <div class="topic" xmlns="http://www.w3.org/1999/xhtml">
- <h1 class="title">The Debugging Application Programming Interface</h1>
-
- <a id="msdn_debugeh">
-
- </a>
- <div id="nstext">
- <p>Randy Kath<br>
- Microsoft Developer Network Technology Group</p>
- <p>November 5, 1992</p>
- <br>
- <h2 class="dtH1">Abstract</h2>
- <p>This article demonstrates how the debugging support in the Microsoft Windows Application Programming Interface (API) can be used by developers to create custom debugging applications that behave exactly the way they want, including any specific features they desire. Specifically, this article discusses the following topics:
- </p><ul>
- <li>Exploring the built-in debugging support, including debug events and debug functions</li>
- <li>Looking at the relationship between a debugger and the process being debugged</li>
- <li>Representing information about a process being debugged</li>
- <li>Using event objects for communicating between debugger threads</li>
- <li>Managing the debugger's graphical user interface (GUI)</li>
- <li>Responding to user commands in debug threads</li>
- <li>Controlling the threads of a process being debugged</li>
- <li>Accessing thread context information from threads of a process being debugged</li>
- <li>Terminating and exiting a process being debugged</li>
- <li>Calling debug functions from a process being debugged</li>
- <li>Expanding on this debugger model</li>
- </ul>
- <p>Each of the key concepts presented is supported with code segments extracted from a sample debugging application called DEBUGAPP.EXE, whose source is included with this article. The sample application stands on its own as a multiprocess debugging application, or its source code can be used as the framework for a more elaborate custom debugger.</p>
- <h2 class="dtH1">Introduction</h2>
- <p>Of the time a programmer spends developing an application, a large portion is usually spent debugging that application. Consequently, developers rely on third-party debuggers almost as much as they do editors. Unlike editors, however, debuggers can rarely be customized much. If a debugger lacks an important feature or behaves in an unusual or irritating way, developers are simply forced to put up with it.</p>
- <p>Windows appears ready to break this cumbersome debugging tradition with new, built-in debugging support included as part of the standard application programming interface (API). Now developers have the flexibility to create their own personal debugger that behaves exactly the way they wish. And once that is complete, having the source code to that debugger makes it all the more flexible. Developers can repeatedly add new features directly to the source code of the debugger as needed in the future.</p>
- <p>The debugging architecture consists of a clean, relatively straightforward set of functions and events that make it useful to all developers, not just debugger builders. Simply being familiar with Windows and, more importantly, the Windows API is enough to build an understanding of the debugging support. The debugger sample application described in this article required only about three weeks for implementation, including the time required to make sense of the API.</p>
- <h2 class="dtH1">Exploring the Built-In Debugging Support</h2>
- <p>DebugApp, the sample application associated with this article, is a high-level debugger that meets a number of important requirements for a debugger. It can debug multiple applications simultaneously, controlling the execution of each process being debugged and presenting feedback about noteworthy events that occur in each of the processes. It can also be used to view the 2 gigabyte (GB) heap space of each process for learning how memory allocations are organized. These are only some of the capabilities that could be added to a debugger. To get a better feel for what capabilities can be implemented in a debugger, you will need to gain some knowledge of how the debugging API works.</p>
- <h3 class="dtH1">Debug Events</h3>
- <p><em>Debug events</em> are the objects of interest to a debugger—they're noteworthy incidents that occur within the process being debugged, causing the kernel to notify the debugger when they occur. As defined by Windows, debug events are one of the following:
- </p><ul>
- <li>CREATE_PROCESS_DEBUG_EVENT occurs before a new process being debugged initializes or at the time a debugger attaches to an active process.</li>
- <li>EXIT_PROCESS_DEBUG_EVENT occurs when the process being debugged exits.</li>
- <li>CREATE_THREAD_DEBUG_EVENT occurs when the process being debugged creates a new thread.</li>
- <li>EXIT_THREAD_DEBUG_EVENT occurs when a thread in the process being debugged exits.</li>
- <li>LOAD_DLL_DEBUG_EVENT occurs when the process being debugged loads a DLL (either explicitly or implicitly).</li>
- <li>UNLOAD_DLL_DEBUG_EVENT occurs when the process being debugged frees a DLL.</li>
- <li>EXCEPTION_DEBUG_EVENT occurs when an exception occurs in the process being debugged.</li>
- <li>OUTPUT_DEBUG_STRING_DEBUG_EVENT occurs when the process being debugged makes a call to the <strong>OutputDebugString</strong> function.</li>
- </ul>
- <p>When a debug event is generated, it comes to the debugger packaged in a <strong>DEBUG_EVENT</strong> structure. The structure contains fields that represent an event code (listed above), the process ID of the process that generated the debug event, the thread ID of the thread executing when the debug event occurred, and a union of eight structures, one for each of the different events. This structure provides information necessary for the debugger to distinguish between different debug events and process them individually based on their unique requirements. The <strong>DEBUG_EVENT</strong> structure is:</p>
- <div id="code-snippet-1" class="codeSnippetContainer" xmlns="http://www.w3.org/1999/xhtml">
- <div class="codeSnippetContainerTabs">
- <div class="codeSnippetContainerTab codeSnippetContainerTabActive" dir="ltr">
- <a></a>
- </div>
- </div>
- <div class="codeSnippetContainerCodeContainer">
- <div class="codeSnippetToolBar"></div>
- <div class="codeSnippetContainerCode" dir="ltr">
- <div style="color:Black;"><pre>typedef struct _DEBUG_EVENT { /* de */
- DWORD dwDebugEventCode;
- DWORD dwProcessId;
- DWORD dwThreadId;
- union {
- EXCEPTION_DEBUG_INFO Exception;
- CREATE_THREAD_DEBUG_INFO CreateThread;
- CREATE_PROCESS_DEBUG_INFO CreateProcess;
- EXIT_THREAD_DEBUG_INFO ExitThread;
- EXIT_PROCESS_DEBUG_INFO ExitProcess;
- LOAD_DLL_DEBUG_INFO LoadDll;
- UNLOAD_DLL_DEBUG_INFO UnloadDll;
- OUTPUT_DEBUG_STRING_INFO DebugString;
- } u;
- } DEBUG_EVENT, *LPDEBUG_EVENT;
- </pre></div>
- </div>
- </div>
- </div>
- <h3 class="dtH1">Debug Functions</h3>
- <p>Two functions, <strong>WaitForDebugEvent</strong> and <strong>ContinueDebugEvent</strong>, are designed specifically for managing debug events as they occur in a process being debugged. These functions permit a debugger to wait for a debug event to occur, suspend execution of the process being debugged, process each debug event, and resume execution of the process being debugged when finished. Additionally, while the process being debugged is suspended, the debugger is able to change the thread context information of each of its threads. This ability provides a mechanism through which the debugger can alter normal execution of one or more threads in the process being debugged. It can, for example, change the instruction pointer for a thread to refer to an instruction at a new location. Then, when the thread resumes execution, it begins executing code at the new location. A discussion of this subject is presented later in the "Accessing Thread Context Information from Threads of a Process Being Debugged" section.</p>
- <p>When called, the <strong>WaitForDebugEvent</strong> function does not return until a debug event occurs in the process being debugged or a time-out value is reached. The time-out value is set as one of the parameters in the function. The function returns TRUE if an event occurs, and FALSE if the function times out.</p>
- <p><strong>DEBUG.C</strong></p>
- <div id="code-snippet-2" class="codeSnippetContainer" xmlns="http://www.w3.org/1999/xhtml">
- <div class="codeSnippetContainerTabs">
- <div class="codeSnippetContainerTab codeSnippetContainerTabActive" dir="ltr">
- <a></a>
- </div>
- </div>
- <div class="codeSnippetContainerCodeContainer">
- <div class="codeSnippetToolBar"></div>
- <div class="codeSnippetContainerCode" dir="ltr">
- <div style="color:Black;"><pre>while (TRUE)
- {
- /* Wait for 1/10 second for a debug event. */
- if (WaitForDebugEvent (&de, (DWORD)100))
- {
- switch (de.dwDebugEventCode)
- {
- case EXCEPTION_DEBUG_EVENT:
- ProcessExceptionEvent (&de);
- break;
- case CREATE_PROCESS_DEBUG_EVENT:
- ProcessCreateProcessEvent (&de);
- break;
- .
- .
- .
- case default:
- ProcessUnknownDebugEvent (&de);
- break;
- }
- ContinueDebugEvent (de.dwProcessId,
- de.dwThreadId,
- DBG_CONTINUE);
- }
- else
- /* Perform periodic debugger responsibilities. */
- }
- </pre></div>
- </div>
- </div>
- </div>
- <p>In the code fragment above, notice that <strong>WaitForDebugEvent</strong> returns a Boolean value where a value of TRUE indicates that a debug event occurred and FALSE means that the function timed out. This example waits for 1/10 second for a debug event to occur, but if an event does not occur in that amount of time, it uses the time-out indicator to perform some other periodic debugger responsibilities. Since time-outs only happen when there are no debug events, this time is analogous to the idle time a CPU observes. Specifically, the DEBUGAPP.EXE sample uses this time to communicate with the main debugger thread in order to process user commands.</p>
- <p>When a debug event occurs, execution of that process is suspended until the debugger calls the <strong>ContinueDebugEvent</strong> function. Consequently, all threads in the process are suspended while the debugger is processing the debug event. A debugger needs to be mindful of the performance impact this will impose on the process being debugged. A good design, in this case, is one that allows the process being debugged to continue as soon as possible after a debug event occurs. On the other hand, when the <strong>WaitForDebugEvent</strong> function times out, the process being debugged is able to run concurrently with the debugger process and no performance impact is observed. Any debug events that occur during the time-out period are queued until the debugger calls the <strong>WaitForDebugEvent</strong> function again. So, no need to worry—there is no possibility of missing a debug event because of this circumstance.</p>
- <p>To call the <strong>ContinueDebugEvent</strong> function, the debugger must supply as parameters the thread ID and process ID of the process that generated the last debug event. Both the process and thread IDs are included as part of the <strong>DEBUG_EVENT</strong> structure with each debug event. They're also returned as part of the <strong>PROCESS_INFORMATION</strong> structure filled out by the <strong>CreateProcess</strong> function when starting a process for debugging. A debugger can attach to an active process for debugging, but an ID for that process is required prior to the attachment. Once the debugger has attached, the thread ID is retrieved from the <strong>DEBUG_EVENT</strong> structure.</p>
- <h3 class="dtH1">The Relationship Between a Debugger and the Process Being Debugged</h3>
- <p>For one application (process) to become the debugger of another, it must either create the process as a debug process or attach to an active process. In both cases, a parent/child relationship is established between the debugger and the process being debugged. If the debugger process ends without ending the process being debugged, the latter process is terminated by the system. If the process being debugged ends, the debugger process becomes a normal process, able to start or attach to another process to debug.</p>
- <p>When the parent/child association is made, the debugger thread responsible for establishing this dependence—the thread that attaches or starts the process to be debugged—becomes the parent thread to the process being debugged. Only the parent thread of a process being debugged is capable of receiving debug events for that process. Consequently, the parent thread is the only thread able to call the <strong>WaitForDebugEvent</strong> and <strong>ContinueDebugEvent</strong> functions. If another thread calls these functions, they simply return FALSE. The basis for the design of the sample application, DEBUGAPP.EXE, is inherent in this requirement.</p>
- <h4 class="dtH1">Creating a process to debug</h4>
- <p>To create a process for debugging, the debugger calls the <strong>CreateProcess</strong> function with the <em>fdwCreate</em> parameter set to either DEBUG_PROCESS or DEBUG_ONLY_THIS_PROCESS. DEBUG_PROCESS sets up the parent/child relationship so that the debugger will receive debug events from a process being debugged and any other processes created by that process. In this case, processes created by the process being debugged are automatically debugged by the same debugger. Using DEBUG_ONLY_THIS_PROCESS restricts debugging to the immediate process being debugged only. Processes created by the process being debugged are normal processes that have no debugging relationship established with any other process. </p>
- <p>An abbreviated definition of <strong>CreateProcess</strong> is found below. A complete definition of the <strong>CreateProcess</strong> function is in the Platform SDK.</p>
- <div id="code-snippet-3" class="codeSnippetContainer" xmlns="http://www.w3.org/1999/xhtml">
- <div class="codeSnippetContainerTabs">
- <div class="codeSnippetContainerTab codeSnippetContainerTabActive" dir="ltr">
- <a></a>
- </div>
- </div>
- <div class="codeSnippetContainerCodeContainer">
- <div class="codeSnippetToolBar"></div>
- <div class="codeSnippetContainerCode" dir="ltr">
- <div style="color:Black;"><pre>BOOL CreateProcess(
- LPCTSTR lpszImageName, /* address of image file name */
- LPCTSTR lpszCommandLine, /* address of the command line */
- LPSECURITY_ATTRIBUTES lpsaProcess, /* optional process attrs */
- LPSECURITY_ATTRIBUTES lpsaThread, /* optional thread attrs */
- BOOL fInheritHandles, /* new process inherits handles? */
- DWORD fdwCreate, /* creation flags */
- LPVOID lpvEnvironment, /* address of optional environment */
- LPTSTR lpszCurDir, /* address of new current directory */
- LPSTARTUPINFO lpsi, /* address of STARTUPINFO */
- LPPROCESS_INFORMATION lppi); /* address of PROCESSINFORMATION */
- </pre></div>
- </div>
- </div>
- </div>
- <p><strong>CreateProcess</strong> includes several parameters for establishing the environment of the process being debugged, passing command-line arguments to the process being debugged, specifying security attributes about the process, and indicating how to start the application. The LPPROCESS_INFORMATION parameter is used for receiving information about the process being started. Specifically, it consists of the process and thread IDs of the process being debugged that are used in <strong>ContinueDebugEvent</strong> and handles to both the process being debugged and its initial thread.</p>
- <h4 class="dtH1">Attaching a debugger to an active process</h4>
- <p>A debugger can attach to any existing process in the system, providing that it has the ID of that process. Through the <strong>DebugActiveProcess</strong> function, a debugger can establish the same parent/child relationship described earlier with active processes. In theory, then, the debugger should be able to present a list of active processes to the user, allowing them to select which one they would like to debug. Upon selection, the debugger could determine the ID of the selected process and begin debugging it by means of the <strong>DebugActiveProcess</strong> function. All that is needed then is a mechanism for enumerating the handles of each active process in the system. Unfortunately, Windows provides no support for determining the ID of other processes in the system. While this seems to render the function useless, it really just limits the way it can be used. On its own, a debugger process cannot determine the ID of other active processes, but with some help from the system it can get the ID of a specific process in need of debugging.</p>
- <p>Built into Windows is the ability for the system to start a debugger upon the occurrence of an unhandled exception in a process. When such an exception occurs, Windows starts the default debugger and passes it the ID of the process to be debugged as a command-line parameter. Windows also passes an event handle as a second command-line parameter. The debugger then calls the <strong>DebugActiveProcess</strong> function using the process ID passed as a command-line parameter. Once the debugger has established the debugging relationship with the offending process, it signals that it is ready to begin debugging by calling the <strong>SetEvent</strong> function on the event handle. At that time the system releases control of the process to the debugger.</p>
- <blockquote class="dtBlock"><div>
- <strong>Note</strong><div class="tt"> </div>The system administrator can change the default debugger in Windows to be any third-party debugger or any other debugger you choose. To do this, an entry must be added to the WIN.INI file as indicated:</div></blockquote>
- <div id="code-snippet-4" class="codeSnippetContainer" xmlns="http://www.w3.org/1999/xhtml">
- <div class="codeSnippetContainerTabs">
- <div class="codeSnippetContainerTab codeSnippetContainerTabActive" dir="ltr">
- <a></a>
- </div>
- </div>
- <div class="codeSnippetContainerCodeContainer">
- <div class="codeSnippetToolBar"></div>
- <div class="codeSnippetContainerCode" dir="ltr">
- <div style="color:Black;"><pre>[AeDebug]
- Debugger = ntsd -d -p %d -e %d -g
- </pre></div>
- </div>
- </div>
- </div>
- <blockquote class="dtBlock"><div>
- To change from the standard default debugger, ntsd, to one of your choosing, simply replace the name ntsd with the name of the debugger you want. Also, make sure that the debugger resides in a directory in the path.</div></blockquote>
- <p>An application can take advantage of this built-in behavior as a way of invoking a debugger to debug itself if, and only if, a special circumstance occurs. For example, an application could be executing normally when a condition occurs that warrants debugging. The application could then start the debugger by calling the <strong>CreateProcess</strong> function similar to the way it was described above, only not as a process to debug. Also, the process needs to pass its ID as a single command-line parameter to the debugger process. The debugger is then started and passed an ID of the process to debug. One requirement of this technique is that the debugger must differentiate between the two ways that it can be created. The difference is that, when the system starts the debugger, there is a second command-line parameter representing a valid wait event that the debugger must eventually signal. When the process wishing to be debugged creates the debugger, there is no second command-line parameter and no wait event to signal.</p>
- <h2 class="dtH1">DEBUGAPP.EXE, A Sample Implementation</h2>
- <p>Combining a knowledge of the debugging API and some idea of the features a custom debugger should have is important for devising the architecture of a debugger application. For example, Figure 1 portrays the architecture that was used in implementing the sample custom debugger, DebugApp.</p>
- <p class="fig"><code><img id="debug_1" alt="ms809754.debug_1(en-us,MSDN.10).gif" src="./Windows Kernel Development Articles (2016-03-30)_files/IC17357.gif" title="ms809754.debug_1(en-us,MSDN.10).gif" xmlns=""></code></p>
- <p class="label"><strong>Figure 1. DebugApp's architecture. A main debugger thread manages the debugger interface, while one thread exists for each process being debugged.</strong></p>
- <p>DebugApp consists of one main thread and one or more debug threads. The main thread is responsible for handling the entire graphical user interface (GUI) of the debugger. Each of the other debug threads is created and destroyed as new debug sessions are started and ended. This structure serves to contain the debug-specific functionality in the debug threads and the GUI-specific functionality in the main thread. Embedded, then, is a layer of encapsulation that promotes maintenance and revision of the source code. Further, the source code for these two types of threads is located in separate source modules, DEBUG.C and MAIN.C, making it easier to go back and add functionality to one part of the system without having an adverse impact on the other.</p>
- <p>Once the underlying structure for the debugger is in place, the next issue is how to represent the debugger and, more specifically, each process being debugged in a single Windows® interface. This implementation uses multiple document interface (MDI) because MDI supports multiple process debugging simultaneously and offers basic multiple window management functionality for free. It turns out MDI is also a good selection because each MDI child window can be used as a separate object capable of maintaining its own private data structures. In that case, writing the interface code to support multiple processes for debugging is no more work than writing it for one.</p>
- <p>A final consideration concerns the bells and whistles that should be added to the debugger. DEBUGAPP.EXE need only meet the basic requirements stated earlier in this article, but at this point many more features and behaviors could easily be applied to the underlying debugger architecture. Specifically, DEBUGAPP.EXE implements support for controlling the execution of individual threads in each of the processes being debugged. It also records all debug events chronologically and provides a mechanism for saving this log to a file for post-mortem review. </p>
- <h2 class="dtH1">Representing Information About a Process Being Debugged</h2>
- <p>DEBUGAPP.EXE uses a single data structure for representing all of the information associated with a process being debugged and its threads. The structure is a simple, singly-linked list where the header (<strong>DBGPROCESS</strong> structure) represents the information of the process being debugged, and each node (<strong>DBGTHREAD</strong> structure) in the list represents information about each thread in the process. Figure 2 depicts this information and how it is organized.</p>
- <p class="fig"><code><img id="debug_2" alt="ms809754.debug_2(en-us,MSDN.10).gif" src="./Windows Kernel Development Articles (2016-03-30)_files/IC33205.gif" title="ms809754.debug_2(en-us,MSDN.10).gif" xmlns=""></code></p>
- <p class="label"><strong>Figure 2. A linked list stores information about the process being debugged and its threads.</strong></p>
- <p>As the process being debugged creates and destroys new threads, the linked list grows and shrinks dynamically. Storage for this data structure is allocated within the debugger process in the form of a <em>serialized heap</em>. Since all threads in the debugger process have access to a shared heap, their access must be serialized to allow one thread to finish accessing the heap before another thread begins accessing it. Windows provides serialized heaps as a mechanism to prevent access contention between threads that share a heap.</p>
- <p>In addition to information about the process being debugged, Windows uses the linked-list header as a place to store information that is communicated between the main thread and the debug thread. Such information includes the MDI child window handle representing a specific debug session, the module path and filename of the process being debugged, a thread number for control information, and a handle to the heap itself, which is used both for destroying the heap when the debug session ends and allocating additional linked-list nodes. Both the linked-list header and node structures are presented in the code below.</p>
- <p><strong>DEBUG.H</strong></p>
- <div id="code-snippet-5" class="codeSnippetContainer" xmlns="http://www.w3.org/1999/xhtml">
- <div class="codeSnippetContainerTabs">
- <div class="codeSnippetContainerTab codeSnippetContainerTabActive" dir="ltr">
- <a></a>
- </div>
- </div>
- <div class="codeSnippetContainerCodeContainer">
- <div class="codeSnippetToolBar"></div>
- <div class="codeSnippetContainerCode" dir="ltr">
- <div style="color:Black;"><pre>// Define structures for debugging processes and threads.
- typedef struct DBGTHREAD *LPDBGTHREAD;
- typedef struct tagDbgThread
- {
- HANDLE hThread;
- LPTHREAD_START_ROUTINE lpStartAddress;
- BOOL bfState;
- LPDBGTHREAD Next;
- }DBGTHREAD;
-
- typedef struct tagDbgProcess
- {
- HANDLE hDbgHeap;
- DWORD dwProcessID;
- DWORD dwThreadID;
- HANDLE hProcess;
- HANDLE hFile;
- LPVOID lpImage;
- DWORD dwDbgInfoOffset;
- DWORD nDbgInfoSize;
- DBGTHREAD *lpThreads;
- HWND hWnd;
- int ProcessPriority;
- HANDLE hThread;
- int ThreadPriority;
- char szModule[MAX_PATH];
- }DBGPROCESS;
- </pre></div>
- </div>
- </div>
- </div>
- <p>DebugApp's main thread creates a serialized heap for each debug thread prior to creating the thread, and a pointer to the heap is passed to the debug thread at creation time. Both the debug thread and the main thread, each keeping a separate copy of the pointer to the structure, maintain the heap independently. The main thread stores its heap pointer in the window extra bytes of the MDI child window responsible for the process being debugged. This way each window can keep track of its own structures, independent of every other window. </p>
- <p>Because the debug thread is implemented as a function (similar to a <strong>WinMain</strong> function) that returns only when the thread has completed, and because each thread has its own stack, each debug thread can keep the pointer to the heap as an automatic variable on its stack. In this way, each debug thread can access its pointer as a local variable because it resides permanently on the stack for that thread. When the thread exits (returns from the function), its stack is deallocated and the pointer is automatically freed. Keep in mind that the heap itself is not freed by this action; it must be explicitly freed through a call to <strong>DestroyHeap</strong>. When and where the heap gets deallocated is discussed in the "Terminating and Exiting a Process Being Debugged" section later in this article.</p>
- <h2 class="dtH1">Using Event Objects for Communicating Between Debugger Threads</h2>
- <p>Because, as described above, the debug thread and the main thread both share access to the same heap, some type of synchronization is necessary for at least creating and destroying that heap. Also, because both the debug thread and the main thread independently perform functions that occasionally must be coordinated, it stands to reason that a debugger needs a mechanism to communicate between threads. DEBUGAPP.EXE uses wait event objects for this purpose.</p>
- <p>Windows uses wait events as a signaling mechanism much like a traffic signal, except there's no yellow light. A wait event represents either a signaled or unsignaled state. A thread can wait for one or more of these events to become signaled and then perform some related action. While waiting for an event to become signaled, a thread is idle. Consequently, events are perfect synchronization objects that allow one thread to wait for a signal from another before performing a specific task. In DEBUGAPP.EXE, the main thread opens a set of event objects, one for each debug thread, and stores the handles in a segment of global memory. The memory is treated as an array of object handles called <em>lpDbgEvents</em> and is kept in the window extra bytes of the responsible child window, along with the linked-list structure mentioned in the previous section.</p>
- <p>Threads cannot share handles to event objects, so the debug thread must open its own array of handles to access the same event objects. The strategy so far is reasonable, but a potential problem lurks here. Since the debug thread must open handles to the same event objects, it has to do so by referring to these objects by name. Windows provides support for naming objects when they are created and referring to objects by name when they are opened for exactly this purpose. Consequently, the wait event objects must be named so that both the main thread and the debug thread can refer to identical objects. The problem arises when you start a second debug session. The second debug session requires a unique set of wait event objects—objects that can be referred to by both the debug thread and the main thread, but that also must be distinguishable from the first debug session's objects.</p>
- <p>To solve this problem, DEBUGAPP.EXE uses the process ID of each process being debugged as part of the name used to identify each object, as in the following example.</p>
- <p><strong>DEBUG.C</strong></p>
- <div id="code-snippet-6" class="codeSnippetContainer" xmlns="http://www.w3.org/1999/xhtml">
- <div class="codeSnippetContainerTabs">
- <div class="codeSnippetContainerTab codeSnippetContainerTabActive" dir="ltr">
- <a></a>
- </div>
- </div>
- <div class="codeSnippetContainerCodeContainer">
- <div class="codeSnippetToolBar"></div>
- <div class="codeSnippetContainerCode" dir="ltr">
- <div style="color:Black;"><pre>/* Local function creates debug event objects for thread */
- /* synchronization. */
- BOOL CreateDebugEvents (
- LPHANDLE lpDbgEvents,
- DWORD dwProcessID)
- {
- char szEvent[MAX_PATH];
- char Buff[15];
- LoadString (GetModuleHandle (NULL),
- IDS_DBGEVNTACTIVE,
- szEvent,
- sizeof (szEvent));
- strcat (szEvent, itoa (dwProcessID, Buff, 10));
- if (!(lpDbgEvents[DEBUGACTIVE] = CreateEvent (NULL,
- TRUE,
- FALSE,
- szEvent)))
- return FALSE;
- .
- .
- .
- </pre></div>
- </div>
- </div>
- </div>
- <p>Each wait event object is given a static name that is stored in a string resource table. Then, when creating a new event or opening a new handle to an existing event, the ID of the process being debugged is appended to the end of the static string. Together the static string and the process ID uniquely identify an object belonging to a specific process.</p>
- <p>Because each thread is responsible for storing its own array of wait event handles, each thread creates its own handles independently. Fortunately, Windows is robust enough that no synchronization is needed for this process. In fact, both threads can make the same call to <strong>CreateEvent</strong> using the same object name, but only the first call will actually create new objects. The second call will return a valid handle to the same object. For that reason, both threads use one function (<strong>CreateDebugEvents</strong>) to retrieve valid handles without regard to which one calls first. The debug thread stores its debug event handle array on the stack as an automatic variable.</p>
- <blockquote class="dtBlock"><div>
- <strong>Note</strong><div class="tt"> </div>In an effort to make the code in DebugApp more readable, I defined constants to represent array indexes by name rather than number. Refer to DEBUG.H to find the array index value that corresponds to a specific wait event handle.</div></blockquote>
- <p>In addition to the array of wait events used for communication between the two threads, DebugApp uses two other wait events, one for synchronizing startup and one for shutdown of the debug thread. These two event objects need only be created and used for a relatively short duration, so no accommodation is needed for them. Instead, they are created, freed, and released, all within the context of a single window message in the main thread. In both cases they are used as in the following example.</p>
- <p><strong>DEBUG.C</strong></p>
- <div id="code-snippet-7" class="codeSnippetContainer" xmlns="http://www.w3.org/1999/xhtml">
- <div class="codeSnippetContainerTabs">
- <div class="codeSnippetContainerTab codeSnippetContainerTabActive" dir="ltr">
- <a></a>
- </div>
- </div>
- <div class="codeSnippetContainerCodeContainer">
- <div class="codeSnippetToolBar"></div>
- <div class="codeSnippetContainerCode" dir="ltr">
- <div style="color:Black;"><pre>/* Create initialize event. */
- LoadString (GetModuleHandle (NULL),
- IDS_DBGEVNTINITACK,
- szEvent,
- MAX_PATH);
- hEvent = CreateEvent (NULL, TRUE, FALSE, szEvent);
- /* Create debug thread. */
- if (!(CreateThread ((LPSECURITY_ATTRIBUTES)NULL,
- 4096,
- (LPTHREAD_START_ROUTINE)DebugEventThread,
- (LPVOID)lpDbgProcess,
- 0,
- &TID)))
- return NULL;
- /* Wait for debugger to complete initialization before opening */
- /* debug events. */
- WaitForSingleObject (hEvent, INFINITE);
- CloseHandle (hEvent);
- </pre></div>
- </div>
- </div>
- </div>
- <p>First, the main thread creates an event by name with an initial value of FALSE. Then, it starts the debug thread and waits for the object it created. At this point, the thread stops execution until the wait event becomes TRUE, its signaled state. Meanwhile, the debug thread starts execution at the same time. The following code fragment shows how the debug thread signals the same wait event, identified by a common name, once it has completed its initialization.</p>
- <p><strong>DEBUG.C</strong></p>
- <div id="code-snippet-8" class="codeSnippetContainer" xmlns="http://www.w3.org/1999/xhtml">
- <div class="codeSnippetContainerTabs">
- <div class="codeSnippetContainerTab codeSnippetContainerTabActive" dir="ltr">
- <a></a>
- </div>
- </div>
- <div class="codeSnippetContainerCodeContainer">
- <div class="codeSnippetToolBar"></div>
- <div class="codeSnippetContainerCode" dir="ltr">
- <div style="color:Black;"><pre>/* Create process to be debugged. */
- .
- .
- .
- /* Signal completion of initialization to calling thread. */
- LoadString (GetModuleHandle (NULL),
- IDS_DBGEVNTINITACK,
- szEvent,
- MAX_PATH);
- hEvent = OpenEvent (EVENT_ALL_ACCESS, FALSE, szEvent);
- SetEvent (hEvent);
- CloseHandle (hEvent);
- </pre></div>
- </div>
- </div>
- </div>
- <p>The main thread is able to continue execution after the event is signaled. Then, it is free to release the event object because the synchronization is complete. A similar wait event is used for synchronization when the debug thread shuts down.</p>
- <h2 class="dtH1">Managing the Debugger's Graphical User Interface</h2>
- <p>When DEBUGAPP.EXE begins, the first thread in the process gets started. This thread behaves exactly like a basic, single-threaded MDI Windows-based application. It registers window classes for the frame and debug windows, creates the frame and MDI client windows, and initializes application-specific data. When complete, the thread enters a continuous <strong>GetMessage</strong> loop, awaiting commands from the user.</p>
- <p>When the command is sent to load a process for debugging, the main thread first calls the <strong>GetOpenFileName</strong> common dialog routine, validates the selected filename, and informs the MDI client to create a new child window. The MDI client then creates the new child window, allowing it to perform its own window initialization. </p>
- <p>The following initialization is performed during the WM_CREATE message of the debugger window:
- </p><ol>
- <li>The child window creates an edit control, used for recording debug information for this debug process, that completely fills its client area. </li>
- <li>The child window allocates a segment of global memory for storing the array of wait event object handles.</li>
- <li>The child window calls the <strong>StartDebugger</strong> function to create the debug thread and the process for debugging.</li>
- </ol>
- <p>The segment of global memory is passed as a parameter and returned with the array filled with valid event handles. The <strong>StartDebugger</strong> function also returns a pointer to the serialized heap for this debugger. Both of these pointers are then placed in window extra bytes for this window. The new child window then returns—eventually back to the frame window where the command to load the process for debugging was originally sent—permitting the main thread to continue executing in support of the graphical user interface. </p>
- <p>All subsequent file-loading commands work in exactly the same way, permitting the user to load simultaneously as many processes for debugging as the system can accommodate, given the amount of resources available. Other menu commands are distributed as appropriate by the frame window. Some of the commands are handled by the MDI client window, while others are processed only by the frame window. Still other commands, like <strong>View Thread</strong> and <strong>View Process</strong>, are intended for the debug window that is currently active. The frame distributes these messages directly to the active debugger window.</p>
- <p>Most commands intended for a specific debugger window involve communication between that window and the corresponding debug thread. In these cases, the debugger window signals a wait event for the debug thread. The debug thread can then act upon that event the next time it waits for it. Once the event has been signaled, the main thread simply returns back to the message loop for the next user command. Since the debug thread has access to the window handle of the debug window in its <strong>DBGPROCESS</strong> data structure, it is able to submit data to the edit control directly. This permits the user free access to commands without having to wait for any prolonged processing on the part of the debug thread.</p>
- <h2 class="dtH1">Responding to User Commands in Debug Threads</h2>
- <p>Besides handling debug events in the process being debugged, the debug thread also handles all user commands once they have been signaled as wait events in the debug window. To accommodate user command events from the main thread and still be able to debug the process, the debug thread implements a multiple-object wait loop.</p>
- <p><strong>DEBUG.C</strong></p>
- <div id="code-snippet-9" class="codeSnippetContainer" xmlns="http://www.w3.org/1999/xhtml">
- <div class="codeSnippetContainerTabs">
- <div class="codeSnippetContainerTab codeSnippetContainerTabActive" dir="ltr">
- <a></a>
- </div>
- </div>
- <div class="codeSnippetContainerCodeContainer">
- <div class="codeSnippetToolBar"></div>
- <div class="codeSnippetContainerCode" dir="ltr">
- <div style="color:Black;"><pre>while (TRUE)
- {
- int nIndex;
- /* Wait for debugger active. */
- switch (nIndex = WaitForMultipleObjects (nDEBUGEVENTS,
- hDbgEvent,
- FALSE,
- INFINITE))
- {
- case CLOSEDEBUGGER:
- {
- int i;
- /* Terminate process being debugged. */
- TerminateProcess (lpDbgProcess->hProcess, 0);
- /* Signal close command acknowledged event. */
- LoadString (GetModuleHandle (NULL),
- IDS_DBGEVNTCLOSEACK,
- szEvent,
- MAX_PATH);
- hEvent = OpenEvent (EVENT_ALL_ACCESS,
- FALSE,
- szEvent);
- SetEvent (hEvent);
- /* Close all debug events. */
- for (i=0; i<nDEBUGEVENTS; i++)
- CloseHandle (hDbgEvent[i]);
- CloseHandle (hEvent);
- /* Exit debugger now. */
- return TRUE;
- }
- break;
- case SUSPENDDEBUGGER:
- SuspendDebuggeeProcess (lpDbgProcess);
- ResetEvent (hDbgEvent[DEBUGACTIVE]);
- ResetEvent (hDbgEvent[SUSPENDDEBUGGER]);
- break;
- case RESUMEDEBUGGER:
- ResumeDebuggeeProcess (lpDbgProcess);
- SetEvent (hDbgEvent[DEBUGACTIVE]);
- ResetEvent (hDbgEvent[RESUMEDEBUGGER]);
- break;
- case DEBUGACTIVE:
- /* If debug active */
- if ((WaitForDebugEvent (&de, (DWORD)100)))
- {
- if (de.dwProcessId == lpDbgProcess->dwProcessID)
- {
- switch (de.dwDebugEventCode)
- {
- case EXCEPTION_DEBUG_EVENT:
- ProcessExceptionEvent (&de);
- break;
- case CREATE_PROCESS_DEBUG_EVENT:
- ProcessCreateProcessDebugEvent (&de);
- break;
- .
- .
- .
- default:
- ProcessDefaultDebugEvent (&de);
- break;
- }
- }
- else
- /* Notify of sibling process debug event. */
- AppendEditText (lpDbgProcess->hWnd,
- de.dwDebugEventCode +
- IDS_SIBLING,
- NULL);
- ContinueDebugEvent (de.dwProcessId,
- de.dwThreadId,
- DBG_CONTINUE);
- }
- break;
- }
- }
- </pre></div>
- </div>
- </div>
- </div>
- <p>In the example above, the debug thread begins a loop and immediately calls <strong>WaitForMultipleObjects</strong> to await the signaling of any debugger event. The debugger events are described below:
- </p><ul>
- <li>CLOSEDEBUGGER signals the debug thread to abort debugging the current process. Highest priority event.</li>
- <li>SUSPENDDEBUGGER signals the debugger to suspend debugging the current process.</li>
- <li>RESUMEDEBUGGER signals the debugger to resume debugging the process.</li>
- <li>DEBUGACTIVE signals the debug thread to debug the process because there is nothing else to do. Lowest priority event.</li>
- </ul>
- <p>The debug thread remains suspended upon this call until an event becomes signaled. Then, the <strong>WaitForMultipleObjects</strong> function returns the index of the event that was signaled. If more than one debugger event is signaled at a time, the one with the highest priority is returned. Events are assigned priorities according to how they are ordered in the array of event handles, where the lower the array position the higher the priority. The array of handles is passed as an argument to the <strong>WaitForMultipleObjects</strong> function. DEBUGAPP.EXE places the highest priority on exiting the debugger and the lowest priority on actual debugging. That means that debugging is performed only when the debug thread has nothing else to do. Really this means that the debugger is able to respond immediately to commands that do not occur frequently—such as exit.</p>
- <p>Also, debug events are separate events from the events that are signaled by the main thread in a debug window. Consequently, another wait loop is embedded within the first for handling debug events alone. However, the debug thread must break from the debug event loop periodically to wait for debugger events. To facilitate this requirement, a time-out is used on the debug event loop to allow the debug thread a way of breaking out of the debug event loop when no debug events are occurring. When the debugger is no longer debugging, as it were, it is able to check for other events that may have become signaled in the interim. While doing so, the debugger does not need to suspend the process being debugged. Any debug events that occur while the debugger is not waiting for them are queued until the debugger resumes its call to <strong>WaitForDebugEvent</strong>.</p>
- <p>Wait events, as used by the debugger, can be either automatic or manual reset types. DebugApp uses manual reset events for more control over when the events become acknowledged. This is necessary because, while the debugger is handling (or waiting for) debug events, more than one debugger event command might have become signaled. When the debugger returns to handle the events, it must handle them one at a time. Two automatic wait events would automatically become reset as soon as the debugger returned from the <strong>WaitForMultipleObjects</strong>. Yet the debugger prioritizes itself so that it responds only to the signaled event with lowest priority. When complete, it returns to handle any others that are still signaled. While handling each one, it resets the event manually to acknowledge the completion of the task for that event. This prevents events from slipping through the cracks while other events are being processed.</p>
- <h2 class="dtH1">Controlling the Threads of a Process Being Debugged</h2>
- <p>In preemptive, multithreaded operating systems, a mechanism often referred to as the <em>system scheduler</em> exists for scheduling each thread in the system. The system scheduler assigns each thread a rank or priority that it uses to determine how much processing to attribute to a thread before switching to the next thread. Specifically in Windows, each thread has a base priority in the range 1–31, where the higher the priority, the more processing time is attributed to the thread. Windows establishes the base priority by combining the specific thread priority and the priority class of its process, as shown in the diagram in Figure 3.</p>
- <p class="fig"><code><img id="debug_3" alt="ms809754.debug_3(en-us,MSDN.10).gif" src="./Windows Kernel Development Articles (2016-03-30)_files/IC147612.gif" title="ms809754.debug_3(en-us,MSDN.10).gif" xmlns=""></code></p>
- <p class="label"><strong>Figure 3. Base thread priorities for each of the process priority classes.</strong></p>
- <p>Windows provides processes with the capability of determining and adjusting their threads' base priorities. Windows provides this feature through the <strong>SetPriorityClass</strong>, <strong>GetPriorityClass</strong>, <strong>SetThreadPriority</strong>, and <strong>GetThreadPriority</strong> functions. Using these functions, processes can adjust their threads' base priority values. To adjust the base priority of threads belonging to a process other than itself, a process needs special access rights.</p>
- <p>By default, a debugger process has PROCESS_SET_INFORMATION access to the process it is debugging and THREAD_SET_INFORMATION access to all threads in that process. These accesses permit the debugger process to change both the priority class of the process being debugged and the thread priority value for each thread in the process. In addition, unlike debug events, any thread in the debugger process can adjust both the process priority class and thread priority values of the process it is debugging. This means that the main debugger thread is able to perform these functions directly without having to synchronize the procedure with the appropriate debug thread.</p>
- <p>Because of this, the GUI thread of the debugger can perform execution control for all processes being debugged. In DEBUGAPP.EXE, execution control is handled by a single dialog box, Thread Execution Control. When the dialog box is invoked, the process being debugged is suspended until the dialog box is dismissed by the user. In the interim, the user is able to modify the priority value for each thread and the priority class for the process being debugged. The dialog box lists each of the threads in the process being debugged, showing their base priorities for comparison. After adjusting priorities for the threads and process, the user exits the dialog box by clicking either OK or Cancel. Clicking OK changes the priorities in the process being debugged and resumes its execution. Clicking Cancel simply causes the process being debugged to resume with the priorities left unchanged.</p>
- <p>In addition to adjusting the base priority of threads, the debugger process can also suspend and terminate the threads of the process being debugged. Specifically, suspending and resuming threads is only available to processes with THREAD_SUSPEND_RESUME access and termination to processes with THREAD_TERMINATE access, but again a debugger process has these access rights by default. The aforementioned Thread Execution Control dialog box in DEBUGAPP.EXE provides support for suspending and resuming threads, but not for terminating threads. Windows provides support for controlling threads through the <strong>SuspendThread</strong>, <strong>ResumeThread</strong>, and <strong>TerminateThread</strong> functions.</p>
- <h3 class="dtH1">Accessing Thread Context Information from Threads of a Process Being Debugged</h3>
- <p>By default, a debugger can change the context of any thread in the process being debugged by virtue of the fact that it has access to the handle for each thread of that process. In DEBUGAPP.EXE, the thread handles of the process being debugged are saved as the thread is created in the linked-list structure described earlier in "Representing Information About a Process Being Debugged." To change the context of a thread in the process being debugged, the debugger calls the <strong>SetThreadContext</strong> function. The arguments to this function are simply a handle to the thread to be affected and a pointer to a <strong>CONTEXT</strong> structure filled with information describing how the thread context will exist after making the call. Similarly, to view the state of a thread's context, the debugger calls <strong>GetThreadContext</strong>. Any process can call <strong>Set/GetThreadContext</strong> for any other thread, providing that it has a valid handle to that thread.</p>
- <blockquote class="dtBlock"><div>
- <strong>Note</strong><div class="tt"> </div>A thread context is implementation-specific, differing from one hardware architecture to another. The fields of the <strong>CONTEXT</strong> structure vary, depending on whether you're running on an Intel platform or a MIPS platform. For details on implementing the <strong>CONTEXT</strong> structure for a specific platform, refer to the specific header file where the structure is defined.</div></blockquote>
- <h3 class="dtH1">Terminating and Exiting a Process Being Debugged</h3>
- <p>There is more than one way to end a process. Windows provides support for terminating a process, given the handle to that process, in the <strong>TerminateProcess</strong> function. Yet, using this function prevents the process from having the opportunity to clean up volatile data. <strong>TerminateProcess</strong> ends the process immediately without calling the <strong>DllEntryPoint</strong> function of any dynamic-link libraries (DLLs) that the application may have loaded. <strong>TerminateProcess</strong> does not send any last messages to window procedures (like WM_DESTROY); it simply terminates. Windows, however, is robust enough to clean up all system resources owned by the process and associated DLLs. Unlike Windows version 3.1, a process does not leave the system in an unstable state solely by calling this function.</p>
- <p>Terminating a process from the debugger may, in fact, be the appropriate way to end a process being debugged. If at any time a user of the debugger commands the process being debugged to exit from the debugger, it is understood that the process is closing abnormally. If the user wants to gracefully exit the process, the user can simply exit it normally directly from the application interface. In fact, abruptly exiting a process—but only after it's allowed to save its changes—is, in itself, a contradiction.</p>
- <p>Another method of exiting a process is to have a process call <strong>ExitProcess</strong> itself. This method is considered a "graceful" exit because all associated DLLs get a chance to clean up before being detached. In this case, the <strong>DllEntryPoint</strong> function gets called for each thread as it terminates and once for when the process goes away. This function permits the process to save volatile data before exiting. Yet, since <strong>DllEntryPoint</strong> does not include a parameter for a process handle, it cannot be called by one process in the hope of exiting another process. So, the debugger cannot command the process being debugged to exit gracefully by calling this function.</p>
- <p>The final technique a debugger process could employ to command the process being debugged to exit gracefully does not use a straightforward API call. Instead, it involves manipulating the context information of a thread in the process being debugged. Because <strong>ExitProcess</strong> can only be called from the process that intends to exit, the debugger can change the context information of the main thread in the process being debugged so that the next instruction it executes is a call to <strong>ExitProcess</strong>. </p>
- <p>To do this, the debugger must:
- </p><ol>
- <li>Suspend the process being debugged.</li>
- <li>Get the context information of a thread in the process being debugged. (It can be any thread in the process, as long as it is not a suspended thread.)</li>
- <li>Replace the instruction-pointer contents with the address of the <strong>ExitProcess</strong> function as referenced by the process being debugged.</li>
- <li>Set the altered context information structure back into the thread of the process being debugged.</li>
- <li>Resume execution of the process.</li>
- </ol>
- <p>The process being debugged behaves as though it made a call to <strong>ExitProcess</strong> itself. (Actually that is exactly what it does.) The following function illustrates this technique.</p>
- <p><strong>DEBUG.C</strong></p>
- <div id="code-snippet-10" class="codeSnippetContainer" xmlns="http://www.w3.org/1999/xhtml">
- <div class="codeSnippetContainerTabs">
- <div class="codeSnippetContainerTab codeSnippetContainerTabActive" dir="ltr">
- <a></a>
- </div>
- </div>
- <div class="codeSnippetContainerCodeContainer">
- <div class="codeSnippetToolBar"></div>
- <div class="codeSnippetContainerCode" dir="ltr">
- <div style="color:Black;"><pre>void ExitDebuggee (
- DBGPROCESS *lppr)
- {
- CONTEXT thContext;
- GetThreadContext (((DBGTHREAD *)lppr->lpThreads)->hThread,
- &thContext);
- thContext.Eip = lppr->ExitProcess;
- SetThreadContext (((DBGTHREAD *)lppr->lpThreads)->hThread,
- &thContext);
- }
- </pre></div>
- </div>
- </div>
- </div>
- <p>Obtaining the address of the <strong>ExitProcess</strong> function is problematic in the above procedure. While it is relatively easy to determine the whereabouts of the function in a process that is executing (it is a member of the system DLL, KERNEL32.DLL), finding the exact address of that function in the process being debugged is more difficult. Each application maps all of the DLLs it uses into its own address space, based mostly on the order in which the DLLs are loaded. This means that, while more than one application may use a given DLL, two processes may or may not have loaded the same system DLL into the same location in their respective address spaces. Consequently, the same function called from a common DLL might be located at different virtual addresses in the two applications. It is tempting to draw the conclusion that system DLLs are loaded into the same base address in every application, for that would make this problem simply go away. <strong>This conclusion, however, is invalid. It may work in some cases, but it cannot be considered a fail-safe assumption. Developers are wise not to draw this conclusion about the system.</strong></p>
- <p>So, to make the <strong>ExitDebuggee</strong> function work properly (see code fragment above), the address of the <strong>ExitProcess</strong> function must be known in the context of the address space of the process being debugged.</p>
- <h4 class="dtH1">Determining the location of ExitProcess</h4>
- <p>One safe assumption to make is that the location of a function in a DLL is always at the same offset from the DLL's base address. This assumption provides the necessary information to develop a technique that is fail-safe. The debugger is already notified when the process being debugged loads each of its DLLs, and at that time the base address of the DLL is provided to the debugger. All the debugger needs to do at this point is determine which DLL being loaded contains the <strong>ExitProcess</strong> function and the offset of that function within the DLL.</p>
- <p>To determine the offset of the function in the DLL, call <strong>GetProcAddress</strong> with the handle to the appropriate DLL and a string identifying the <strong>ExitProcess</strong> function. This can be done within the context of the debugger process since the offset is consistent across processes. The handle to this DLL can be obtained by making a call to <strong>LoadLibrary</strong>, specifying KERNEL32.DLL by name. Then, subtract the base address of the DLL from the address returned from <strong>GetProcAddress</strong>. The difference is the offset into the DLL. The base address of KERNEL32.DLL can be determined by calling the <strong>VirtualQuery</strong> function, supplying the address of the <strong>ExitProcess</strong> function as the base address for the region of memory. <strong>VirtualQuery</strong> returns a filled-out <strong>MEMORY_BASIC_INFORMATION</strong> structure. One field of that structure is the base address for the region of memory. In this case, that will be the base address of the DLL code region.</p>
- <p>Even more difficult is the task of determining which DLL is being loaded in the process being debugged when LOAD_DLL_DEBUG_EVENT occurs. During this debug event, the debugger receives the base address for the DLL being loaded, but only a module file handle with which to identify the DLL. Fortunately, the file handle can be used to read information about the file. To identify the file as the correct DLL, the debugger must determine the name of the DLL by extracting the filename, assigned by the linker, from the executable image. The name is found after tracing through a maze of offsets and tables of data embedded within the executable file. </p>
- <p>A limitation, though, exists in this technique. Since the name of the executable is embedded in the file during the link process, there is no way of knowing whether a user renamed the file after linking. Unfortunately, there is no way around this limitation. No other way exists to determine the name of the DLL that is being loaded in the debugger—yet, one can always hope that this will be a feature included in a future release of Windows.</p>
- <p>Once the name is extracted, it can be compared to see if, in fact, the DLL is the KERNEL32.DLL file. If so, the debugger saves this base address in the process structure for use in the <strong>ExitDebuggee</strong> function as shown in the code fragment in the previous section.</p>
- <h2 class="dtH1">Debug Functions a Process Being Debugged Can Call</h2>
- <p>A few functions are provided as part of the Windows API for applications that are being debugged. Each of these functions generates a debug event in the debugger process:
- </p><ul>
- <li><strong>DebugBreak</strong> is provided simply to insert a break point in an application. This function generates the EXCEPTION_DEBUG_EVENT event and with it an <strong>EXCEPTION_DEBUG_INFO</strong> structure that includes an <strong>EXCEPTION_RECORD</strong> structure, which includes an EXCEPTION_BREAKPOINT exception code for this event.</li>
- <li><strong>OutputDebugString</strong> provides the opportunity for the process being debugged to pass a string to the debugger application. This function can be extremely useful in a custom debugger application because it provides a mechanism for the process being debugged to pass information to the debugger. The debugger can then log these strings when they occur or respond according to their content. This function generates the OUTPUT_DEBUG_STRING_DEBUG_EVENT event and is accompanied by an <strong>OUTPUT_DEBUG_STRING_INFO</strong> structure. This structure contains the address and length of the string in the process being debugged and a Unicode® flag, indicating the type of string it is. The debugger can access the string by calling <strong>ReadProcessMemory</strong> and indicating the length and address of the string to read along with the process handle.</li>
- <li><strong>FatalExit</strong> and <strong>FatalAppExit</strong> are functions provided for an application to exit immediately but pass control to the debugger before going away.</li>
- </ul>
- <p>The debugger handles each of the above calls as any application calling them would when encountering any other debug event. The only distinction is the type of event itself. If it is desirable to have the debugger execute special processing after one of these types of events, the debugger simply treats each of these debug events uniquely. The debug event loop is already prepared to handle this eventuality.</p>
- <h2 class="dtH1">Expanding on This Debugger Model</h2>
- <p>The debugger presented in this article falls short of a full-fledged, source-level debugger in several ways. It does not provide any source-level functionality, like single-step execution and break points. It also lacks any symbolic information support. Many features could easily be added to this debugger—many without too much effort and some that would require considerable effort. The purpose of DEBUGAPP.EXE is to provide a base upon which a complete debugging environment could be built while at the same time introducing the debugging API. To that extent, this debugger is a solid debugging foundation, and it demonstrates extensive use of the debugging API. Don't be surprised to see future samples and technical articles based on this debugging sample!</p>
-
- </div>
- </div>
-
- </div>
- </div>
- <div class="clear"></div>
-
- <input name="__RequestVerificationToken" type="hidden" value="fKVhUw50W0Cx1RcGSOB-78qntfCbfSRGZuY25Ly7GH3ufsIslCsWQ4GgYSPSZKo4zmIPsqfjZRz084JLaqsNnCW7xhk1">
- <input id="ratingValueSubmitUrl" type="hidden" value="https://msdn.microsoft.com/en-us/library/feedback/rate/ms809754(d=printer).aspx">
- <input id="ratingAdditionalSubmitUrl" type="hidden" value="https://msdn.microsoft.com/en-us/library/feedback/additional/ms809754(d=printer).aspx">
- <input id="isTopicRated" type="hidden" value="false">
- <div id="lib-footer" ms.pgarea="body">
-
-
- <link type="text/css" rel="stylesheet">
-
- <div id="ux-footer" class="" style="" dir="ltr">
-
- <div id="footerSock" class="librarySock both">
- <div id="footerSockInner">
- <a name="feedback"></a>
- <div class="rating">
- <div id="ratingSection1">
- <div class="title">
- Was this page helpful?
- </div>
- <div class="description">
- Your feedback about this content is important.<br>Let us know what you think.
- </div>
- <div class="buttons">
- <button class="button" id="ratingYes" aria-label="Yes, this page was helpful">Yes</button>
- <button class="button" id="ratingNo" aria-label="No, this page was not helpful">No</button>
- </div>
- <input id="ratingValue" type="hidden" value="">
- </div>
- <div id="ratingSection2">
- <div class="title left">
- Additional feedback?
- </div>
- <textarea id="ratingText" rows="6" cols="" maxlength="1500"></textarea>
- <div class="right">
- <div class="counter">
- <span id="feedbackTextCounter">1500</span> characters remaining
- </div>
- <div class="buttons">
- <button class="button" id="ratingSubmit" aria-label="Submit my additional feedback">Submit</button>
- <button class="button" id="ratingSkipThis" aria-label="Skip additional feedback">Skip this</button>
- </div>
- </div>
- </div>
- <div id="ratingSection3">
- <div class="title">
- Thank you!
- </div>
- <div class="description">
- We appreciate your feedback.
- </div>
- </div>
-
-
- <div id="contentFeedbackQAContainer" style="display: none;"></div>
- </div>
-
- <div class="userVoice">
- <div class="title">
- Help us improve MSDN.
- </div>
- <div class="description">
- Visit our UserVoice Page to submit and vote on ideas!
- </div>
- <div class="buttons">
- <a class="button" id="userVoiceButton" href="http://feedback.msdn.com/forums/257782-msdn-feature-suggestions/category/83975" target="_blank">Make a suggestion</a>
- </div>
- </div>
- <div class="clear"></div>
- </div>
- </div>
- <footer class="top">
- <div data-fragmentname="LeftLinks" id="Fragment_LeftLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Dev centers</div>
- <ul class="links">
- <li>
- <a href="https://dev.windows.com/" id="LeftLinks_2148_1" class="windowsBlue" xmlns="http://www.w3.org/1999/xhtml">Windows</a>
- </li>
- <li>
- <a href="http://dev.office.com/" id="LeftLinks_2148_3" class="office" xmlns="http://www.w3.org/1999/xhtml">Office</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/vstudio" id="LeftLinks_2148_4" class="visualStudio" xmlns="http://www.w3.org/1999/xhtml">Visual Studio</a>
- </li>
- <li>
- <a href="http://azure.microsoft.com/en-us/documentation/" target="_blank" id="LeftLinks_2148_12" xmlns="http://www.w3.org/1999/xhtml">Microsoft Azure</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/developer-centers-msdn" id="LeftLinks_2148_5" xmlns="http://www.w3.org/1999/xhtml">More...</a>
- </li>
- </ul>
- </div>
- </div>
- <div id="rightLinks">
- <div data-fragmentname="CenterLinks1" id="Fragment_CenterLinks1" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Learning resources</div>
- <ul class="links">
- <li>
- <a href="http://www.microsoftvirtualacademy.com/" id="CenterLinks1_2151_4" xmlns="http://www.w3.org/1999/xhtml">Microsoft Virtual Academy</a>
- </li>
- <li>
- <a href="http://channel9.msdn.com/" id="CenterLinks1_2151_5" xmlns="http://www.w3.org/1999/xhtml">Channel 9</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/magazine/" id="CenterLinks1_2151_7" xmlns="http://www.w3.org/1999/xhtml">MSDN Magazine</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks2" id="Fragment_CenterLinks2" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Community</div>
- <ul class="links">
- <li>
- <a href="https://social.msdn.microsoft.com/forums/en-us/home" id="CenterLinks2_2151_8" xmlns="http://www.w3.org/1999/xhtml">Forums</a>
- </li>
- <li>
- <a href="http://blogs.msdn.com/b/developer-tools/" id="CenterLinks2_2151_9" xmlns="http://www.w3.org/1999/xhtml">Blogs</a>
- </li>
- <li>
- <a href="http://www.codeplex.com/" id="CenterLinks2_2151_10" xmlns="http://www.w3.org/1999/xhtml">Codeplex</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks3" id="Fragment_CenterLinks3" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Support</div>
- <ul class="links">
- <li>
- <a href="https://msdn.microsoft.com/hh361695" id="CenterLinks3_2151_11" xmlns="http://www.w3.org/1999/xhtml">Self support</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks4" id="Fragment_CenterLinks4" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Programs</div>
- <ul class="links">
- <li>
- <a href="https://www.microsoft.com/bizspark/" id="CenterLinks4_2151_13" xmlns="http://www.w3.org/1999/xhtml">BizSpark (for startups)</a>
- </li>
- <li>
- <a href="https://www.dreamspark.com/" id="CenterLinks4_2151_14" xmlns="http://www.w3.org/1999/xhtml">DreamSpark</a>
- </li>
- <li>
- <a href="http://www.imaginecup.com/" id="CenterLinks4_2151_17" xmlns="http://www.w3.org/1999/xhtml">Imagine Cup</a>
- </li>
- </ul>
- </div>
- </div>
- </div>
- </footer>
- <footer class="bottom">
- <span class="localeContainer">
-
- <form class="selectLocale" id="selectLocaleForm" action="https://msdn.microsoft.com/en-us/selectlocale-dmc">
- <input type="hidden" name="fromPage" value="https%3a%2f%2fmsdn.microsoft.com%2fen-us%2flibrary%2fms809754(d%3dprinter).aspx%3flan%3dCSharp%26cc%3dn%26trm%3dtra%26view%3dbook">
- <a href="http://msdn.microsoft.com/#" onclick="$('#selectLocaleForm').submit();return false;" title="Change your language">United States (English)</a>
- </form>
- </span>
- <div data-fragmentname="BottomLinks" id="Fragment_BottomLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <ul class="links horizontal">
- <li>
- <a href="https://msdn.microsoft.com/newsletter.aspx" id="BottomLinks_2148_7" xmlns="http://www.w3.org/1999/xhtml">Newsletter</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/dn529288" id="BottomLinks_2148_8" xmlns="http://www.w3.org/1999/xhtml">Privacy & cookies</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/cc300389" id="BottomLinks_2148_9" xmlns="http://www.w3.org/1999/xhtml">Terms of use</a>
- </li>
- <li>
- <a href="https://www.microsoft.com/en-us/legal/intellectualproperty/Trademarks/EN-US.aspx" id="BottomLinks_2148_10" xmlns="http://www.w3.org/1999/xhtml">Trademarks</a>
- </li>
- </ul>
- </div>
- </div>
- <span class="logoLegal">
- <span class="logo"></span>
- <span class="copyright">© 2016 Microsoft</span>
- </span>
- </footer>
- </div>
-
- </div>
- <div class="footerPrintView">
- <div class="footerCopyrightPrintView">© 2016 Microsoft</div>
- </div>
-
-
-
-
- <input id="tocPaddingPerLevel" type="hidden" value="17">
- <input id="MtpsDevice" type="hidden" value="Printer">
- <!--[CDATA[ Third party scripts and code linked to or referenced from this website are licensed to you by the parties that own such code, not by Microsoft. See ASP.NET Ajax CDN Terms of Use – http://www.asp.net/ajaxlibrary/CDN.ashx. ]]-->
-
-
-
-
-
- <noscript><div><img alt="DCSIMG" id="Img1" width="1" height="1" src="https://m.webtrends.com/dcsmgru7m99k7mqmgrhudo0k8_8c6m/njs.gif?dcsuri=/nojavascript&amp;WT.js=No" /></div></noscript>
- <div id="globalRequestVerification">
- <input name="__RequestVerificationToken" type="hidden" value="S3eQxysIg4Cc2ZKrGI8zjPRQw8ypyUeRW6zTqVyxkTpZXnjoyuffdFT9yIXmrTIjwCL4n-pBNpmElwobS4LZMHdD7Kw1">
- </div>
- </div>
-
-
-
-
-
-
- <script type="text/javascript" class="mtps-injected">
- /*<![CDATA[*/
- (function(window,document){"use strict";function preload(scripts){for(var result=[],script,e,i=0;i<scripts.length;i++)script=scripts[i],script.hasOwnProperty("url")&&(e=document.createElement("script"),e.src=script.url,script.throwaway=e),result.push(script);return result}function inject(scripts,index){var script,elem;if(index>=scripts.length){delete mtps.injectScripts;return}script=scripts[index];elem=document.createElement("script");elem.className="mtps-injected";elem.async=!1;var isLoaded=!1,timeoutId=0,injectNextFnName="",injectNext=elem.onerror=function(){isLoaded||(isLoaded=!0,inject(scripts,index+1),window.clearTimeout(timeoutId),elem.onload=elem.onerror=elem.onreadystatechange=null,injectNextFnName&&delete mtps[injectNextFnName],elem.removeEventListener&&elem.removeEventListener("load",injectNext,!1))};elem.addEventListener?elem.addEventListener("load",injectNext,!1):elem.readyState==="uninitialized"?elem.onreadystatechange=function(){(this.readyState==="loaded"||this.readyState==="complete")&&injectNext()}:elem.onload=injectNext;script.hasOwnProperty("url")?(timeoutId=window.setTimeout(injectNext,12e4),elem.src=script.url):(injectNextFnName="_injectNextScript_"+index,mtps[injectNextFnName]=injectNext,timeoutId=window.setTimeout(injectNext,2e3),elem.text="try {\n"+script.txt+"\n} finally { MTPS."+injectNextFnName+" && MTPS."+injectNextFnName+"(); }");parent.appendChild(elem)}var mtps=window.MTPS||(window.MTPS={}),parent=document.getElementsByTagName("head")[0];mtps.injectScripts=function(scripts){inject(preload(scripts),0)}})(window,document);
- MTPS.injectScripts([
- { txt: "/**/\r\n(window.MTPS || (window.MTPS = {})).cdnDomains || (window.MTPS.cdnDomains = { \r\n\t\"image\": \"https://i-msdn.sec.s-msft.com\", \r\n\t\"js\": \"https://i2-msdn.sec.s-msft.com\", \r\n\t\"css\": \"https://i-msdn.sec.s-msft.com\", \r\n\t\"ttf\": \"https://i-msdn.sec.s-msft.com\"\r\n});\r\n/**/" },
- { txt: "//\n var literalNormalizedUrl = \u0027/en-us/library/ms809754(d=printer,l=en-us,v=msdn.10).aspx\u0027;\n var wt_nvr_ru = \u0027WT_NVR_RU\u0027;\n var wt_fpcdom = \u0027.microsoft.com\u0027;\n var wt_domlist = \u0027msdn.microsoft.com\u0027;\n var wt_pathlist = \u0027\u0027;\n var wt_paramlist = \u0027DCSext.mtps_devcenter\u0027;\n var wt_siteid = \u0027MSDN\u0027;\n var gDomain = \u0027m.webtrends.com\u0027;\n var gDcsId = \u0027dcsmgru7m99k7mqmgrhudo0k8_8c6m\u0027;\n var gFpc = \u0027WT_FPC\u0027;\n\n\n\n if (document.cookie.indexOf(gFpc + \"=\") == -1) {\n var wtidJs = document.createElement(\"script\");\n wtidJs.src = \"//\" + gDomain + \"/\" + gDcsId + \"/wtid.js\";\n document.getElementsByTagName(\"head\")[0].appendChild(wtidJs);\n }\n\n\n\n var detectedLocale = \u0027en-us\u0027;\n var wtsp = \u0027msdnlib_w32_com\u0027;\n var gTrackEvents = \u00270\u0027;\n/**/" },
- { txt: "//\n\n window.appInsightsId = \u00275eb1b2eb-c47a-497a-a7ac-a1c230b2882f\u0027;\n //" },
- { url: "https://i2-msdn.sec.s-msft.com/Combined.js?resources=0:Utilities,1:Layout,2:Header,1:Rating,2:Footer,0:Topic,3:PabTopic,4:webtrendsscript,0:AppInsightsPerf,0:ABTestControl,5:WEDCS,3:CmpgrpForHeader,0:livefyre,0:Comment,1:SearchBox;/Areas/Epx/Content/Scripts:0,/Areas/Epx/Themes/Base/Content:1,/Areas/Centers/Themes/StandardDevCenter/Content:2,/Areas/Library/Content:3,/Areas/Global/Content/Webtrends/resources:4,/Areas/Library/Themes/Base/Content:5\u0026amp;hashKey=30CEE944AABFEA2C5A338BDB9E000732\u0026amp;v=AE608271C0243AAA0449D3BC0FAD8EB4" },
- { url: "https://i1.services.social.microsoft.com/search/Widgets/SearchBox.jss?boxid=HeaderSearchTextBox\u0026btnid=HeaderSearchButton\u0026pgArea=header\u0026brand=Msdn\u0026loc=en-us\u0026focusOnInit=false\u0026emptyWatermark=true\u0026searchButtonTooltip=Search MSDN" },
- { url: "https://i2-msdn.sec.s-msft.com/Combined.js?resources=0:PrintExportButton,1:Toc_Fixed,1:CodeSnippet,1:TopicNotInScope,1:CollapsibleArea,1:VersionSelector,1:SurveyBroker;/Areas/Library/Themes/Base/Content:0,/Areas/Epx/Content/Scripts:1\u0026amp;hashKey=80F30894E3FB8A3295C923AEC7019CFE\u0026amp;v=AE608271C0243AAA0449D3BC0FAD8EB4" },
- { txt: "$(document).ready(function() {\n try {\n var token = $(\"#globalRequestVerification input[name=\u0027__RequestVerificationToken\u0027]\").clone();\n $(\"#siteFeedbackForm\").append(token);\n } catch(err) {\n \n }\n });" }
- ]);
- /*]]>*/
- </script>
- <link rel="stylesheet" type="text/css" href="./Windows Kernel Development Articles (2016-03-30)_files/Combined(4).css">
- <div id="page">
-
-
-
-
- <link type="text/css" rel="stylesheet">
-
- <input type="hidden" id="isHeaderBleeding" value="true">
- <div id="ux-header" dir="ltr" class="ltr msdn">
-
- <header>
- <span id="singleCol"></span>
- <span id="doubleCol"></span>
- <span id="isMobile"></span>
- <div>
- <div class="row topRow">
- <div class="top">
- <div class="left">
- <a class="msdnLogoImg" href="https://msdn.microsoft.com/en-us" title="MSDN home">
- <div id="msft-logo" class="msft-logo"></div>
- </a>
- <div class="GrayPipe"></div>
- <a class="DevCenterFullNameNonMegaBlade" href="https://msdn.microsoft.com/en-us">Developer Network</a>
- <a class="DevCenterFullName" href="https://msdn.microsoft.com/en-us">Developer Network</a>
- <a class="DevCenterShortName" href="https://msdn.microsoft.com/en-us">Developer</a>
- </div>
- <div class="right">
- <div id="signIn">
- <div class="profileImage"></div>
- <a class="scarabLink" href="https://login.live.com/login.srf?wa=wsignin1.0&rpsnv=12&ct=1459376396&rver=6.0.5276.0&wp=mcmbi&wlcxt=msdn%24msdn%24msdn&wreply=https%3a%2f%2fmsdn.microsoft.com%2fen-us%2flibrary%2fdn655038%2528d%3dprinter%2529.aspx%3flan%3dcsharp%26cc%3dn%26trm%3dtra%26view%3dbook&lc=1033&id=254354&mkt=en-us" title="Sign in">Sign in</a></div>
- <div class="auxNav">
- <div>
- <div data-fragmentname="Subscriptions" id="Fragment_Subscriptions" xmlns="http://www.w3.org/1999/xhtml">
- <a href="https://msdn.microsoft.com/subscriptions/manage/hh442900" id="Subscriptions_2153_1" xmlns="http://www.w3.org/1999/xhtml">MSDN subscriptions</a>
- </div>
- <div data-fragmentname="GetTools" id="Fragment_GetTools" xmlns="http://www.w3.org/1999/xhtml">
- <a href="http://go.microsoft.com/fwlink/?LinkId=309297&clcid=0x409&slcid=0x409&campaign=o~msft~msdn~gettools-header~dn308572" id="GetTools_2153_3" xmlns="http://www.w3.org/1999/xhtml">Get tools</a>
- </div>
- </div>
- <div>
- <div data-fragmentname="SocialLinks" id="Fragment_SocialLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <ul class="links horizontal">
- <li>
- <a href="http://www.facebook.com/microsoftdeveloper" target="_blank" id="SocialLinks_2152_4" class="facebook" xmlns="http://www.w3.org/1999/xhtml">http://www.facebook.com/microsoftdeveloper</a>
- </li>
- <li>
- <a href="https://twitter.com/msdev" target="_blank" id="SocialLinks_2152_5" class="twitter" xmlns="http://www.w3.org/1999/xhtml">https://twitter.com/msdev</a>
- </li>
- <li>
- <a href="http://plus.google.com/111221966647232053570/" target="_blank" id="SocialLinks_2152_6" class="googlePlus" xmlns="http://www.w3.org/1999/xhtml">http://plus.google.com/111221966647232053570/</a>
- </li>
- </ul>
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- <div class="row middleRow">
- <div class="expandTop">
- <div class="left"></div>
- <div class="right"></div>
- </div>
- </div>
- </div>
- <div id="buttomRowWrapper" class="bg_default">
- <div class="row buttomRow bg_default">
- <div class="bottom">
- <div class="left">
- <a id="grip" class="menu-icon" href="javascript:void(0)"></a>
-
- <div id="drawer">
- <div class="toc">
-
- <nav>
- <ul class="navL1">
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Technologies">Technologies</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/cloud-app-development-msdn" title="Cloud">Cloud</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/app-development-msdn" title="App Development">App Development</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/web-app-development-msdn" title="Web">Web</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/big-data-development-msdn" title="Data">Data</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/games-development-msdn" title="Gaming">Gaming</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/internetofthings" title="Internet of Things">Internet of Things</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Downloads">Downloads</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://www.visualstudio.com/downloads/download-visual-studio-vs" title="Visual Studio">Visual Studio</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/subscriptions" title="MSDN subscription access">MSDN subscription access</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/microsoft-sdks-msdn" title="SDKs">SDKs</a>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Trial software">Trial software</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/evalcenter" title="Free downloads">Free downloads</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/officeevaluationresources" title="Office resources">Office resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/sharepoint2013resources" title="SharePoint Server 2013 resources">SharePoint Server 2013 resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/sqlserver2014expressresources" title="SQL Server 2014 Express resources">SQL Server 2014 Express resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/windowsserver2012r2resources" title="Windows Server 2012 resources">Windows Server 2012 resources</a>
- </li>
- </ul>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Programs">Programs</a>
- <ul class="navL2">
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Visual Studio subscriptions">Visual Studio subscriptions</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/msdn-subscriptions-overview" title="Overview">Overview</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/benefits-overview" title="Benefits">Benefits</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/msdn-subscriptions-administration" title="Administrators">Administrators</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Students">Students</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/imagine/imagine-home" title="Microsoft Imagine">Microsoft Imagine</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/microsoftstudentpartners" title="Microsoft Student Partners">Microsoft Student Partners</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Architects">Architects</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-overview-msdn" title="Overview">Overview</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-case-studies-msdn" title="Case studies">Case studies</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-blueprints-msdn" title="Blueprints">Blueprints</a>
- </li>
- <li class="inactive">
- <a href="http://blogs.msdn.com/b/msarchitecture/" title="Blog">Blog</a>
- </li>
- <li class="inactive">
- <a href="http://social.msdn.microsoft.com/forums/en-us/home?brandignore=true&sort=relevancedesc&searchterm=architecture+or+architect" title="Forums">Forums</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/applicationbuilder" title="ISV">ISV</a>
-
- </li>
- <li class="inactive">
- <a href="https://www.microsoft.com/bizspark" title="Startups">Startups</a>
-
- </li>
- <li class="inactive">
- <a href="https://rewards.msdn.microsoft.com/" title="TechRewards">TechRewards</a>
-
- </li>
- <li class="inactive">
- <a href="http://events.msdn.microsoft.com/" title="Events">Events</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Community">Community</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/magazine/dd767791" title="Magazine">Magazine</a>
-
- </li>
- <li class="inactive">
- <a href="https://social.msdn.microsoft.com/forums/" title="Forums">Forums</a>
-
- </li>
- <li class="inactive">
- <a href="http://blogs.msdn.com/b/developer-tools/" title="Blogs">Blogs</a>
-
- </li>
- <li class="inactive">
- <a href="http://tech-advisors.msdn.microsoft.com/en-us" title="Tech Advisors">Tech Advisors</a>
-
- </li>
- <li class="inactive">
- <a href="http://channel9.msdn.com/" title="Channel 9">Channel 9</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive current toggle">
- <a href="javascript:void(0)" title="Documentation">Documentation</a>
- <ul class="navL2">
- <li class="inactive current">
- <a href="https://msdn.microsoft.com/library" title="APIs and reference">APIs and reference</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/developer-centers-msdn" title="Dev centers">Dev centers</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive">
- <a href="https://code.msdn.microsoft.com/" title="Samples">Samples</a>
- </li>
- </ul>
- </nav>
- </div>
- </div>
- </div>
- <div class="right">
- <div data-fragmentname="SearchBox" id="Fragment_SearchBox" xmlns="http://www.w3.org/1999/xhtml">
- <div class="SearchBox">
- <form id="HeaderSearchForm" name="HeaderSearchForm" method="get">
- <button id="FakeHeaderSearchButton" value="Search" type="submit" class="header-search-button">
- <div id="search-finder" class="search-finder"></div>
- </button>
- <button id="HeaderSearchButton" style="display:none"></button>
- <div id="searchSplitter"></div>
- <div id="searchCloseIcon" class="search-clear-x"></div>
- <div id="searchTextContainer" style="width: 0;">
- <input id="HeaderSearchTextBox" name="query" type="text" maxlength="200" onfocus="Epx.Controls.SearchBox.watermarkFocus(event, this.title)" onblur="Epx.Controls.SearchBox.watermarkBlur(event, this.title)">
- </div>
- </form>
-
-
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- </header>
- </div>
-
-
-
- <div class="printExportMenus ltr">
- <a id="isd_printABook" href="http://msdn.microsoft.com/en-us/library/export/help/(d=printer)?returnurl=%2fen-us%2flibrary%2fdn655038(d%3dprinter).aspx%3flan%3dcsharp%26cc%3dn%26trm%3dtra%26view%3dbook">
- Export (<span class="count">0</span>)
- </a>
- <a id="isd_print" href="https://msdn.microsoft.com/en-us/library/dn655038(d=printer).aspx?lan=csharp&cc=n&trm=tra&view=book" rel="nofollow">
- Print
- </a>
- <a id="isd_archiveControl" style="display:none;" data-include-archive="Include Previous Version" data-exclude-archive="Exclude Previous Version">
- </a>
- </div>
-
- <div class="printExportMenus ltr">
- <a id="expandCollapseAll" accesskey="e" href="javascript:void(0)" title="Expand/Collapse all sections by pressing Ctrl + Shift + e">Expand All</a>
- </div>
-
- <div id="body" ms.pgarea="body">
- <span id="tabletView_large"></span>
- <span id="tabletView_small"></span>
- <span id="mobileView"></span>
-
- <div id="content" class="content">
- <input type="hidden" id="printForPab" value="true">
-
- <div xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="topic">
- <h1 class="title">/CGTHREADS (Compiler Threads)</h1>
-
- <div class="lw_vs">
- <div id="curversion">
- <strong>
- Visual Studio 2015
- </strong>
- </div>
- <div id="versionclick">
- <div id="vsseperator" class="cl_lw_vs_seperator"></div>
- <div>
- <div>
- <a id="vsLink" href="javascript:;">
- Other Versions
- </a>
- </div>
- <div class="cl_vs_arrow clip10x10">
- <img class="cl_lw_vs_arrow" id="vsArrow" alt="" src="./Windows Kernel Development Articles (2016-03-30)_files/ImageSprite.png">
- </div>
- </div>
- <ul id="vsPanel">
- <li class="">
- <a href="http://msdn.microsoft.com/en-us/library/dn655038(d=printer,v=vs.120).aspx">Visual Studio 2013 </a>
- </li>
- <li id="vsExpand">
- <span class="breadcrumbEllipsis">
- <a href="http://msdn.microsoft.com/#"></a>
- </span>
- </li>
- </ul>
- </div>
- </div>
- <div style="clear:both;"></div>
- <div id="mainSection">
- <div id="mainBody"> <div class="introduction"><p>Sets the number of cl.exe threads to use for optimization and code generation when link-time code generation is specified.</p></div><div><h2 class="LW_CollapsibleArea_TitleDiv"><div><a href="javascript:void(0)" class="LW_CollapsibleArea_TitleAhref" title="Collapse" role="button"><span class="cl_CollapsibleArea_expanding LW_CollapsibleArea_Img"></span><span class="LW_CollapsibleArea_Title">Syntax</span></a><div id="Anchor_0" class="LW_CollapsibleArea_Anchor_Div"><a href="http://msdn.microsoft.com/en-us/library/dn655038(d=printer).aspx?lan=csharp&cc=n&trm=tra&view=book#Anchor_0" class="LW_CollapsibleArea_Anchor_Img" title="Right-click to copy and share the link for this section"></a></div><div class="LW_CollapsibleArea_HrDiv"><hr class="LW_CollapsibleArea_Hr"></div></div></h2><div class="sectionblock">
- <div id="code-snippet-1" class="codeSnippetContainer" xmlns="http://www.w3.org/1999/xhtml">
- <div class="codeSnippetContainerTabs">
- <div class="codeSnippetContainerTab codeSnippetContainerTabActive" dir="ltr">
- <a></a>
- </div>
- </div>
- <div class="codeSnippetContainerCodeContainer">
- <div class="codeSnippetToolBar"></div>
- <div class="codeSnippetContainerCode" dir="ltr">
- <div style="color:Black;"><pre>/CGTHREADS:[1-8]
- </pre></div>
- </div>
- </div>
- </div>
- </div></div><div><h2 class="LW_CollapsibleArea_TitleDiv"><div><a href="javascript:void(0)" class="LW_CollapsibleArea_TitleAhref" title="Collapse" role="button"><span class="cl_CollapsibleArea_expanding LW_CollapsibleArea_Img"></span><span class="LW_CollapsibleArea_Title">Arguments</span></a><div id="Anchor_1" class="LW_CollapsibleArea_Anchor_Div"><a href="http://msdn.microsoft.com/en-us/library/dn655038(d=printer).aspx?lan=csharp&cc=n&trm=tra&view=book#Anchor_1" class="LW_CollapsibleArea_Anchor_Img" title="Right-click to copy and share the link for this section"></a></div><div class="LW_CollapsibleArea_HrDiv"><hr class="LW_CollapsibleArea_Hr"></div></div></h2><div class="sectionblock"><div class="section"><dl class="definitionTable"><dt>number</dt><dd><p>The maximum number of threads for cl.exe to use, in the range 1 to 8.</p></dd></dl></div></div></div><div><h2 class="LW_CollapsibleArea_TitleDiv"><div><a href="javascript:void(0)" class="LW_CollapsibleArea_TitleAhref" title="Collapse" role="button"><span class="cl_CollapsibleArea_expanding LW_CollapsibleArea_Img"></span><span class="LW_CollapsibleArea_Title">Remarks</span></a><div id="Anchor_2" class="LW_CollapsibleArea_Anchor_Div"><a href="http://msdn.microsoft.com/en-us/library/dn655038(d=printer).aspx?lan=csharp&cc=n&trm=tra&view=book#Anchor_2" class="LW_CollapsibleArea_Anchor_Img" title="Right-click to copy and share the link for this section"></a></div><div class="LW_CollapsibleArea_HrDiv"><hr class="LW_CollapsibleArea_Hr"></div></div></h2><div class="sectionblock"><div class="section"><p>The <strong>/CGTHREADS</strong> option specifies the maximum number of threads cl.exe uses in parallel for the optimization and code-generation phases of compilation when link-time code generation (<a href="https://msdn.microsoft.com/en-us/library/xbf3tbeh.aspx">/LTCG</a>) is specified. By default, cl.exe uses four threads, as if <strong>/CGTHREADS:4</strong> were specified. If more processor cores are available, a larger <em>number</em> value can improve build times. </p><p>Multiple levels of parallelism can be specified for a build. The msbuild.exe switch <strong>/maxcpucount</strong> specifies the number of MSBuild processes that can be run in parallel. The <a href="https://msdn.microsoft.com/en-us/library/bb385193.aspx">/MP (Build with Multiple Processes)</a> compiler flag specifies the number of cl.exe processes that simultaneously compile the source files. The <a href="https://msdn.microsoft.com/en-us/library/dn631956.aspx">/cgthreads</a> compiler option specifies the number of threads used by each cl.exe process. Because the processor can only run as many threads at the same time as there are processor cores, it's not useful to specify larger values for all of these options at the same time, and it can be counterproductive. For more information about how to build projects in parallel, see <a href="https://msdn.microsoft.com/en-us/library/bb651793.aspx">Building Multiple Projects in Parallel with MSBuild</a>.</p><div class="section" bookmarktitle="To set this linker option in the Visual Studio development environment"><h2 class="heading" xmlns:html="http://www.w3.org/1999/xhtml" xmlns:xlink="http://www.w3.org/1999/xlink">To set this linker option in the Visual Studio development environment</h2><ol class="steps"><li class="step"><div class="section"><p>Open the project's <strong>Property Pages</strong> dialog box. For details, see <a href="https://msdn.microsoft.com/en-us/library/669zx6zc.aspx">Working with Project Properties</a>. </p></div></li><li class="step"><div class="section"><p>Select the <strong>Configuration Properties</strong>, <strong>Linker</strong> folder.</p></div></li><li class="step"><div class="section"><p>Select the <strong>Command Line</strong> property page.</p></div></li><li class="step"><div class="section"><p>Modify the <strong>Additional Options</strong> property to include <strong>/CGTHREADS:</strong><em>number</em>, where <em>number</em> is a value from 1 to 8, and then choose <strong>OK</strong>.</p></div></li></ol></div><div class="section" bookmarktitle="To set this linker option programmatically"><h2 class="heading" xmlns:html="http://www.w3.org/1999/xhtml" xmlns:xlink="http://www.w3.org/1999/xlink">To set this linker option programmatically</h2><ul class="steps"><li class="step"><div class="section"><p>See <a href="https://msdn.microsoft.com/en-us/library/microsoft.visualstudio.vcprojectengine.vclinkertool.additionaloptions.aspx"><span xmlns="">AdditionalOptions</span></a>.</p></div></li></ul></div></div></div></div><div><h2 class="LW_CollapsibleArea_TitleDiv"><div><a href="javascript:void(0)" class="LW_CollapsibleArea_TitleAhref" title="Collapse" role="button"><span class="cl_CollapsibleArea_expanding LW_CollapsibleArea_Img"></span><span class="LW_CollapsibleArea_Title">See Also</span></a><div id="Anchor_3" class="LW_CollapsibleArea_Anchor_Div"><a href="http://msdn.microsoft.com/en-us/library/dn655038(d=printer).aspx?lan=csharp&cc=n&trm=tra&view=book#Anchor_3" class="LW_CollapsibleArea_Anchor_Img" title="Right-click to copy and share the link for this section"></a></div><div class="LW_CollapsibleArea_HrDiv"><hr class="LW_CollapsibleArea_Hr"></div></div></h2><div class="sectionblock"><p><a href="https://msdn.microsoft.com/en-us/library/y0zzbyt4.aspx">Linker Options</a><br><a href="https://msdn.microsoft.com/en-us/library/wk97ab1b.aspx">Setting Linker Options</a><br></p></div></div></div>
- </div>
- </div>
- </div>
-
- </div>
- </div>
- <div class="clear"></div>
-
- <input name="__RequestVerificationToken" type="hidden" value="DAizjTLHhhX_0EXGZkZw0UnlZOLlUsHTrS3ZIPTE5VLjjXcJlNGD7dbPEsPSckXxd3U64syDsRImRx8pCO14LDMvLr81">
- <input id="ratingValueSubmitUrl" type="hidden" value="https://msdn.microsoft.com/en-us/library/feedback/rate/dn655038(d=printer).aspx">
- <input id="ratingAdditionalSubmitUrl" type="hidden" value="https://msdn.microsoft.com/en-us/library/feedback/additional/dn655038(d=printer).aspx">
- <input id="isTopicRated" type="hidden" value="false">
- <div id="lib-footer" ms.pgarea="body">
-
-
- <link type="text/css" rel="stylesheet">
-
- <div id="ux-footer" class="" style="" dir="ltr">
-
- <div id="footerSock" class="librarySock both">
- <div id="footerSockInner">
- <a name="feedback"></a>
- <div class="rating">
- <div id="ratingSection1">
- <div class="title">
- Was this page helpful?
- </div>
- <div class="description">
- Your feedback about this content is important.<br>Let us know what you think.
- </div>
- <div class="buttons">
- <button class="button" id="ratingYes" aria-label="Yes, this page was helpful">Yes</button>
- <button class="button" id="ratingNo" aria-label="No, this page was not helpful">No</button>
- </div>
- <input id="ratingValue" type="hidden" value="">
- </div>
- <div id="ratingSection2">
- <div class="title left">
- Additional feedback?
- </div>
- <textarea id="ratingText" rows="6" cols="" maxlength="1500"></textarea>
- <div class="right">
- <div class="counter">
- <span id="feedbackTextCounter">1500</span> characters remaining
- </div>
- <div class="buttons">
- <button class="button" id="ratingSubmit" aria-label="Submit my additional feedback">Submit</button>
- <button class="button" id="ratingSkipThis" aria-label="Skip additional feedback">Skip this</button>
- </div>
- </div>
- </div>
- <div id="ratingSection3">
- <div class="title">
- Thank you!
- </div>
- <div class="description">
- We appreciate your feedback.
- </div>
- </div>
-
-
- <div id="contentFeedbackQAContainer" style="display: none;"></div>
- </div>
-
- <div class="userVoice">
- <div class="title">
- Help us improve MSDN.
- </div>
- <div class="description">
- Visit our UserVoice Page to submit and vote on ideas!
- </div>
- <div class="buttons">
- <a class="button" id="userVoiceButton" href="http://feedback.msdn.com/forums/257782-msdn-feature-suggestions/category/83975" target="_blank">Make a suggestion</a>
- </div>
- </div>
- <div class="clear"></div>
- </div>
- </div>
- <footer class="top">
- <div data-fragmentname="LeftLinks" id="Fragment_LeftLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Dev centers</div>
- <ul class="links">
- <li>
- <a href="https://dev.windows.com/" id="LeftLinks_2148_1" class="windowsBlue" xmlns="http://www.w3.org/1999/xhtml">Windows</a>
- </li>
- <li>
- <a href="http://dev.office.com/" id="LeftLinks_2148_3" class="office" xmlns="http://www.w3.org/1999/xhtml">Office</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/vstudio" id="LeftLinks_2148_4" class="visualStudio" xmlns="http://www.w3.org/1999/xhtml">Visual Studio</a>
- </li>
- <li>
- <a href="http://azure.microsoft.com/en-us/documentation/" target="_blank" id="LeftLinks_2148_12" xmlns="http://www.w3.org/1999/xhtml">Microsoft Azure</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/developer-centers-msdn" id="LeftLinks_2148_5" xmlns="http://www.w3.org/1999/xhtml">More...</a>
- </li>
- </ul>
- </div>
- </div>
- <div id="rightLinks">
- <div data-fragmentname="CenterLinks1" id="Fragment_CenterLinks1" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Learning resources</div>
- <ul class="links">
- <li>
- <a href="http://www.microsoftvirtualacademy.com/" id="CenterLinks1_2151_4" xmlns="http://www.w3.org/1999/xhtml">Microsoft Virtual Academy</a>
- </li>
- <li>
- <a href="http://channel9.msdn.com/" id="CenterLinks1_2151_5" xmlns="http://www.w3.org/1999/xhtml">Channel 9</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/magazine/" id="CenterLinks1_2151_7" xmlns="http://www.w3.org/1999/xhtml">MSDN Magazine</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks2" id="Fragment_CenterLinks2" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Community</div>
- <ul class="links">
- <li>
- <a href="https://social.msdn.microsoft.com/forums/en-us/home" id="CenterLinks2_2151_8" xmlns="http://www.w3.org/1999/xhtml">Forums</a>
- </li>
- <li>
- <a href="http://blogs.msdn.com/b/developer-tools/" id="CenterLinks2_2151_9" xmlns="http://www.w3.org/1999/xhtml">Blogs</a>
- </li>
- <li>
- <a href="http://www.codeplex.com/" id="CenterLinks2_2151_10" xmlns="http://www.w3.org/1999/xhtml">Codeplex</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks3" id="Fragment_CenterLinks3" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Support</div>
- <ul class="links">
- <li>
- <a href="https://msdn.microsoft.com/hh361695" id="CenterLinks3_2151_11" xmlns="http://www.w3.org/1999/xhtml">Self support</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks4" id="Fragment_CenterLinks4" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Programs</div>
- <ul class="links">
- <li>
- <a href="https://www.microsoft.com/bizspark/" id="CenterLinks4_2151_13" xmlns="http://www.w3.org/1999/xhtml">BizSpark (for startups)</a>
- </li>
- <li>
- <a href="https://www.dreamspark.com/" id="CenterLinks4_2151_14" xmlns="http://www.w3.org/1999/xhtml">DreamSpark</a>
- </li>
- <li>
- <a href="http://www.imaginecup.com/" id="CenterLinks4_2151_17" xmlns="http://www.w3.org/1999/xhtml">Imagine Cup</a>
- </li>
- </ul>
- </div>
- </div>
- </div>
- </footer>
- <footer class="bottom">
- <span class="localeContainer">
-
- <form class="selectLocale" id="selectLocaleForm" action="https://msdn.microsoft.com/en-us/selectlocale-dmc">
- <input type="hidden" name="fromPage" value="https%3a%2f%2fmsdn.microsoft.com%2fen-us%2flibrary%2fdn655038(d%3dprinter).aspx%3flan%3dCSharp%26cc%3dn%26trm%3dtra%26view%3dbook">
- <a href="http://msdn.microsoft.com/#" onclick="$('#selectLocaleForm').submit();return false;" title="Change your language">United States (English)</a>
- </form>
- </span>
- <div data-fragmentname="BottomLinks" id="Fragment_BottomLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <ul class="links horizontal">
- <li>
- <a href="https://msdn.microsoft.com/newsletter.aspx" id="BottomLinks_2148_7" xmlns="http://www.w3.org/1999/xhtml">Newsletter</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/dn529288" id="BottomLinks_2148_8" xmlns="http://www.w3.org/1999/xhtml">Privacy & cookies</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/cc300389" id="BottomLinks_2148_9" xmlns="http://www.w3.org/1999/xhtml">Terms of use</a>
- </li>
- <li>
- <a href="https://www.microsoft.com/en-us/legal/intellectualproperty/Trademarks/EN-US.aspx" id="BottomLinks_2148_10" xmlns="http://www.w3.org/1999/xhtml">Trademarks</a>
- </li>
- </ul>
- </div>
- </div>
- <span class="logoLegal">
- <span class="logo"></span>
- <span class="copyright">© 2016 Microsoft</span>
- </span>
- </footer>
- </div>
-
- </div>
- <div class="footerPrintView">
- <div class="footerCopyrightPrintView">© 2016 Microsoft</div>
- </div>
-
-
-
-
- <input id="tocPaddingPerLevel" type="hidden" value="17">
- <input id="MtpsDevice" type="hidden" value="Printer">
- <!--[CDATA[ Third party scripts and code linked to or referenced from this website are licensed to you by the parties that own such code, not by Microsoft. See ASP.NET Ajax CDN Terms of Use – http://www.asp.net/ajaxlibrary/CDN.ashx. ]]-->
-
-
-
-
-
- <noscript><div><img alt="DCSIMG" id="Img1" width="1" height="1" src="https://m.webtrends.com/dcsmgru7m99k7mqmgrhudo0k8_8c6m/njs.gif?dcsuri=/nojavascript&amp;WT.js=No" /></div></noscript>
- <div id="globalRequestVerification">
- <input name="__RequestVerificationToken" type="hidden" value="uI0WDaf-NkEGnJveLLErvIEF5WuLpQI0UXDaMrMC_8-dFZ3tiFi_R459UGQ1Hc5rVD_VTV31rRJvSvxWYmMYSg6fXx81">
- </div>
- </div>
-
-
-
-
-
-
- <script type="text/javascript" class="mtps-injected">
- /*<![CDATA[*/
- (function(window,document){"use strict";function preload(scripts){for(var result=[],script,e,i=0;i<scripts.length;i++)script=scripts[i],script.hasOwnProperty("url")&&(e=document.createElement("script"),e.src=script.url,script.throwaway=e),result.push(script);return result}function inject(scripts,index){var script,elem;if(index>=scripts.length){delete mtps.injectScripts;return}script=scripts[index];elem=document.createElement("script");elem.className="mtps-injected";elem.async=!1;var isLoaded=!1,timeoutId=0,injectNextFnName="",injectNext=elem.onerror=function(){isLoaded||(isLoaded=!0,inject(scripts,index+1),window.clearTimeout(timeoutId),elem.onload=elem.onerror=elem.onreadystatechange=null,injectNextFnName&&delete mtps[injectNextFnName],elem.removeEventListener&&elem.removeEventListener("load",injectNext,!1))};elem.addEventListener?elem.addEventListener("load",injectNext,!1):elem.readyState==="uninitialized"?elem.onreadystatechange=function(){(this.readyState==="loaded"||this.readyState==="complete")&&injectNext()}:elem.onload=injectNext;script.hasOwnProperty("url")?(timeoutId=window.setTimeout(injectNext,12e4),elem.src=script.url):(injectNextFnName="_injectNextScript_"+index,mtps[injectNextFnName]=injectNext,timeoutId=window.setTimeout(injectNext,2e3),elem.text="try {\n"+script.txt+"\n} finally { MTPS."+injectNextFnName+" && MTPS."+injectNextFnName+"(); }");parent.appendChild(elem)}var mtps=window.MTPS||(window.MTPS={}),parent=document.getElementsByTagName("head")[0];mtps.injectScripts=function(scripts){inject(preload(scripts),0)}})(window,document);
- MTPS.injectScripts([
- { txt: "/**/\r\n(window.MTPS || (window.MTPS = {})).cdnDomains || (window.MTPS.cdnDomains = { \r\n\t\"image\": \"https://i-msdn.sec.s-msft.com\", \r\n\t\"js\": \"https://i2-msdn.sec.s-msft.com\", \r\n\t\"css\": \"https://i-msdn.sec.s-msft.com\", \r\n\t\"ttf\": \"https://i-msdn.sec.s-msft.com\"\r\n});\r\n/**/" },
- { txt: "//\n var literalNormalizedUrl = \u0027/en-us/library/dn655038(d=printer,l=en-us,v=vs.140).aspx\u0027;\n var wt_nvr_ru = \u0027WT_NVR_RU\u0027;\n var wt_fpcdom = \u0027.microsoft.com\u0027;\n var wt_domlist = \u0027msdn.microsoft.com\u0027;\n var wt_pathlist = \u0027\u0027;\n var wt_paramlist = \u0027DCSext.mtps_devcenter\u0027;\n var wt_siteid = \u0027MSDN\u0027;\n var gDomain = \u0027m.webtrends.com\u0027;\n var gDcsId = \u0027dcsmgru7m99k7mqmgrhudo0k8_8c6m\u0027;\n var gFpc = \u0027WT_FPC\u0027;\n\n\n\n if (document.cookie.indexOf(gFpc + \"=\") == -1) {\n var wtidJs = document.createElement(\"script\");\n wtidJs.src = \"//\" + gDomain + \"/\" + gDcsId + \"/wtid.js\";\n document.getElementsByTagName(\"head\")[0].appendChild(wtidJs);\n }\n\n\n\n var detectedLocale = \u0027en-us\u0027;\n var wtsp = \u0027msdnlib_devtools_lang\u0027;\n var gTrackEvents = \u00270\u0027;\n/**/" },
- { txt: "//\n\n window.appInsightsId = \u00275eb1b2eb-c47a-497a-a7ac-a1c230b2882f\u0027;\n //" },
- { url: "https://i2-msdn.sec.s-msft.com/Combined.js?resources=0:Utilities,1:Layout,2:Header,1:Rating,2:Footer,0:Topic,3:PabTopic,4:webtrendsscript,0:AppInsightsPerf,0:ABTestControl,5:WEDCS,3:CmpgrpForHeader,0:livefyre,0:Comment,1:SearchBox;/Areas/Epx/Content/Scripts:0,/Areas/Epx/Themes/Base/Content:1,/Areas/Centers/Themes/StandardDevCenter/Content:2,/Areas/Library/Content:3,/Areas/Global/Content/Webtrends/resources:4,/Areas/Library/Themes/Base/Content:5\u0026amp;hashKey=30CEE944AABFEA2C5A338BDB9E000732\u0026amp;v=F664E7A9238E1F224D24BE082A3197DF" },
- { url: "https://i1.services.social.microsoft.com/search/Widgets/SearchBox.jss?boxid=HeaderSearchTextBox\u0026btnid=HeaderSearchButton\u0026pgArea=header\u0026brand=Msdn\u0026loc=en-us\u0026focusOnInit=false\u0026emptyWatermark=true\u0026searchButtonTooltip=Search MSDN" },
- { url: "https://i2-msdn.sec.s-msft.com/Areas/Library/Themes/Base/Content/PrintExportButton.js" },
- { txt: "MTPS = window.MTPS || {}; MTPS.LocalizedStrings = window.MTPS.LocalizedStrings || {}; MTPS.LocalizedStrings.ExpandButtonTooltip = \u0027Expand\u0027; MTPS.LocalizedStrings.CollapseButtonTooltip = \u0027Collapse\u0027; MTPS.LocalizedStrings.EnhancedExpandTooltip = \u0027Click to expand. Double-click to expand all.\u0027; MTPS.LocalizedStrings.EnhancedCollapseTooltip = \u0027Click to collapse. Double-click to collapse all.\u0027; MTPS.LocalizedStrings.ExpandAllButtonTooltip = \u0027Expand All\u0027; MTPS.LocalizedStrings.CollapseAllButtonTooltip = \u0027Collapse All\u0027;" },
- { url: "https://i2-msdn.sec.s-msft.com/Combined.js?resources=0:Toc_Fixed,0:CodeSnippet,0:TopicNotInScope,0:CollapsibleArea,0:VersionSelector,0:SurveyBroker;/Areas/Epx/Content/Scripts:0\u0026amp;hashKey=8DC15B34541884CA29DF06F58B5CA754\u0026amp;v=F664E7A9238E1F224D24BE082A3197DF" },
- { txt: "$(document).ready(function() {\n try {\n var token = $(\"#globalRequestVerification input[name=\u0027__RequestVerificationToken\u0027]\").clone();\n $(\"#siteFeedbackForm\").append(token);\n } catch(err) {\n \n }\n });" }
- ]);
- /*]]>*/
- </script>
- <link rel="stylesheet" type="text/css" href="./Windows Kernel Development Articles (2016-03-30)_files/Combined(4).css">
- <div id="page">
-
-
-
-
- <link type="text/css" rel="stylesheet">
-
- <input type="hidden" id="isHeaderBleeding" value="true">
- <div id="ux-header" dir="ltr" class="ltr msdn">
-
- <header>
- <span id="singleCol"></span>
- <span id="doubleCol"></span>
- <span id="isMobile"></span>
- <div>
- <div class="row topRow">
- <div class="top">
- <div class="left">
- <a class="msdnLogoImg" href="https://msdn.microsoft.com/en-us" title="MSDN home">
- <div id="msft-logo" class="msft-logo"></div>
- </a>
- <div class="GrayPipe"></div>
- <a class="DevCenterFullNameNonMegaBlade" href="https://msdn.microsoft.com/en-us">Developer Network</a>
- <a class="DevCenterFullName" href="https://msdn.microsoft.com/en-us">Developer Network</a>
- <a class="DevCenterShortName" href="https://msdn.microsoft.com/en-us">Developer</a>
- </div>
- <div class="right">
- <div id="signIn">
- <div class="profileImage"></div>
- <a class="scarabLink" href="https://login.live.com/login.srf?wa=wsignin1.0&rpsnv=12&ct=1459376399&rver=6.0.5276.0&wp=mcmbi&wlcxt=msdn%24msdn%24msdn&wreply=https%3a%2f%2fmsdn.microsoft.com%2fen-us%2flibrary%2ft6tay6cz%2528d%3dprinter%2529.aspx%3flan%3dcsharp%26cc%3dn%26trm%3dtra%26view%3dbook&lc=1033&id=254354&mkt=en-us" title="Sign in">Sign in</a></div>
- <div class="auxNav">
- <div>
- <div data-fragmentname="Subscriptions" id="Fragment_Subscriptions" xmlns="http://www.w3.org/1999/xhtml">
- <a href="https://msdn.microsoft.com/subscriptions/manage/hh442900" id="Subscriptions_2153_1" xmlns="http://www.w3.org/1999/xhtml">MSDN subscriptions</a>
- </div>
- <div data-fragmentname="GetTools" id="Fragment_GetTools" xmlns="http://www.w3.org/1999/xhtml">
- <a href="http://go.microsoft.com/fwlink/?LinkId=309297&clcid=0x409&slcid=0x409&campaign=o~msft~msdn~gettools-header~dn308572" id="GetTools_2153_3" xmlns="http://www.w3.org/1999/xhtml">Get tools</a>
- </div>
- </div>
- <div>
- <div data-fragmentname="SocialLinks" id="Fragment_SocialLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <ul class="links horizontal">
- <li>
- <a href="http://www.facebook.com/microsoftdeveloper" target="_blank" id="SocialLinks_2152_4" class="facebook" xmlns="http://www.w3.org/1999/xhtml">http://www.facebook.com/microsoftdeveloper</a>
- </li>
- <li>
- <a href="https://twitter.com/msdev" target="_blank" id="SocialLinks_2152_5" class="twitter" xmlns="http://www.w3.org/1999/xhtml">https://twitter.com/msdev</a>
- </li>
- <li>
- <a href="http://plus.google.com/111221966647232053570/" target="_blank" id="SocialLinks_2152_6" class="googlePlus" xmlns="http://www.w3.org/1999/xhtml">http://plus.google.com/111221966647232053570/</a>
- </li>
- </ul>
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- <div class="row middleRow">
- <div class="expandTop">
- <div class="left"></div>
- <div class="right"></div>
- </div>
- </div>
- </div>
- <div id="buttomRowWrapper" class="bg_default">
- <div class="row buttomRow bg_default">
- <div class="bottom">
- <div class="left">
- <a id="grip" class="menu-icon" href="javascript:void(0)"></a>
-
- <div id="drawer">
- <div class="toc">
-
- <nav>
- <ul class="navL1">
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Technologies">Technologies</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/cloud-app-development-msdn" title="Cloud">Cloud</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/app-development-msdn" title="App Development">App Development</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/web-app-development-msdn" title="Web">Web</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/big-data-development-msdn" title="Data">Data</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/games-development-msdn" title="Gaming">Gaming</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/internetofthings" title="Internet of Things">Internet of Things</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Downloads">Downloads</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://www.visualstudio.com/downloads/download-visual-studio-vs" title="Visual Studio">Visual Studio</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/subscriptions" title="MSDN subscription access">MSDN subscription access</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/microsoft-sdks-msdn" title="SDKs">SDKs</a>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Trial software">Trial software</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/evalcenter" title="Free downloads">Free downloads</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/officeevaluationresources" title="Office resources">Office resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/sharepoint2013resources" title="SharePoint Server 2013 resources">SharePoint Server 2013 resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/sqlserver2014expressresources" title="SQL Server 2014 Express resources">SQL Server 2014 Express resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/windowsserver2012r2resources" title="Windows Server 2012 resources">Windows Server 2012 resources</a>
- </li>
- </ul>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Programs">Programs</a>
- <ul class="navL2">
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Visual Studio subscriptions">Visual Studio subscriptions</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/msdn-subscriptions-overview" title="Overview">Overview</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/benefits-overview" title="Benefits">Benefits</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/msdn-subscriptions-administration" title="Administrators">Administrators</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Students">Students</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/imagine/imagine-home" title="Microsoft Imagine">Microsoft Imagine</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/microsoftstudentpartners" title="Microsoft Student Partners">Microsoft Student Partners</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Architects">Architects</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-overview-msdn" title="Overview">Overview</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-case-studies-msdn" title="Case studies">Case studies</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-blueprints-msdn" title="Blueprints">Blueprints</a>
- </li>
- <li class="inactive">
- <a href="http://blogs.msdn.com/b/msarchitecture/" title="Blog">Blog</a>
- </li>
- <li class="inactive">
- <a href="http://social.msdn.microsoft.com/forums/en-us/home?brandignore=true&sort=relevancedesc&searchterm=architecture+or+architect" title="Forums">Forums</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/applicationbuilder" title="ISV">ISV</a>
-
- </li>
- <li class="inactive">
- <a href="https://www.microsoft.com/bizspark" title="Startups">Startups</a>
-
- </li>
- <li class="inactive">
- <a href="https://rewards.msdn.microsoft.com/" title="TechRewards">TechRewards</a>
-
- </li>
- <li class="inactive">
- <a href="http://events.msdn.microsoft.com/" title="Events">Events</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Community">Community</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/magazine/dd767791" title="Magazine">Magazine</a>
-
- </li>
- <li class="inactive">
- <a href="https://social.msdn.microsoft.com/forums/" title="Forums">Forums</a>
-
- </li>
- <li class="inactive">
- <a href="http://blogs.msdn.com/b/developer-tools/" title="Blogs">Blogs</a>
-
- </li>
- <li class="inactive">
- <a href="http://tech-advisors.msdn.microsoft.com/en-us" title="Tech Advisors">Tech Advisors</a>
-
- </li>
- <li class="inactive">
- <a href="http://channel9.msdn.com/" title="Channel 9">Channel 9</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive current toggle">
- <a href="javascript:void(0)" title="Documentation">Documentation</a>
- <ul class="navL2">
- <li class="inactive current">
- <a href="https://msdn.microsoft.com/library" title="APIs and reference">APIs and reference</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/developer-centers-msdn" title="Dev centers">Dev centers</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive">
- <a href="https://code.msdn.microsoft.com/" title="Samples">Samples</a>
- </li>
- </ul>
- </nav>
- </div>
- </div>
- </div>
- <div class="right">
- <div data-fragmentname="SearchBox" id="Fragment_SearchBox" xmlns="http://www.w3.org/1999/xhtml">
- <div class="SearchBox">
- <form id="HeaderSearchForm" name="HeaderSearchForm" method="get">
- <button id="FakeHeaderSearchButton" value="Search" type="submit" class="header-search-button">
- <div id="search-finder" class="search-finder"></div>
- </button>
- <button id="HeaderSearchButton" style="display:none"></button>
- <div id="searchSplitter"></div>
- <div id="searchCloseIcon" class="search-clear-x"></div>
- <div id="searchTextContainer" style="width: 0;">
- <input id="HeaderSearchTextBox" name="query" type="text" maxlength="200" onfocus="Epx.Controls.SearchBox.watermarkFocus(event, this.title)" onblur="Epx.Controls.SearchBox.watermarkBlur(event, this.title)">
- </div>
- </form>
-
-
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- </header>
- </div>
-
-
-
- <div class="printExportMenus ltr">
- <a id="isd_printABook" href="http://msdn.microsoft.com/en-us/library/export/help/(d=printer)?returnurl=%2fen-us%2flibrary%2ft6tay6cz(d%3dprinter).aspx%3flan%3dcsharp%26cc%3dn%26trm%3dtra%26view%3dbook">
- Export (<span class="count">0</span>)
- </a>
- <a id="isd_print" href="https://msdn.microsoft.com/en-us/library/t6tay6cz(d=printer).aspx?lan=csharp&cc=n&trm=tra&view=book" rel="nofollow">
- Print
- </a>
- <a id="isd_archiveControl" style="display:none;" data-include-archive="Include Previous Version" data-exclude-archive="Exclude Previous Version">
- </a>
- </div>
-
- <div class="printExportMenus ltr">
- <a id="expandCollapseAll" accesskey="e" href="javascript:void(0)" title="Expand/Collapse all sections by pressing Ctrl + Shift + e">Expand All</a>
- </div>
-
- <div id="body" ms.pgarea="body">
- <span id="tabletView_large"></span>
- <span id="tabletView_small"></span>
- <span id="mobileView"></span>
-
- <div id="content" class="content">
- <input type="hidden" id="printForPab" value="true">
-
- <div xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="topic">
- <h1 class="title">Getting Started (Debug Interface Access SDK)</h1>
-
- <div class="lw_vs">
- <div id="curversion">
- <strong>
- Visual Studio 2015
- </strong>
- </div>
- <div id="versionclick">
- <div id="vsseperator" class="cl_lw_vs_seperator"></div>
- <div>
- <div>
- <a id="vsLink" href="javascript:;">
- Other Versions
- </a>
- </div>
- <div class="cl_vs_arrow clip10x10">
- <img class="cl_lw_vs_arrow" id="vsArrow" alt="" src="./Windows Kernel Development Articles (2016-03-30)_files/ImageSprite.png">
- </div>
- </div>
- <ul id="vsPanel">
- <li class="">
- <a href="http://msdn.microsoft.com/en-us/library/t6tay6cz(d=printer,v=vs.120).aspx">Visual Studio 2013 </a>
- </li>
- <li class="">
- <a href="http://msdn.microsoft.com/en-us/library/t6tay6cz(d=printer,v=vs.110).aspx">Visual Studio 2012</a>
- </li>
- <li class="">
- <a href="http://msdn.microsoft.com/en-us/library/t6tay6cz(d=printer,v=vs.100).aspx">Visual Studio 2010</a>
- </li>
- <li class="archived">
- <a href="http://msdn.microsoft.com/en-us/library/t6tay6cz(d=printer,v=vs.90).aspx">Visual Studio 2008</a>
- </li>
- <li class="archived">
- <a href="http://msdn.microsoft.com/en-us/library/t6tay6cz(d=printer,v=vs.80).aspx">Visual Studio 2005</a>
- </li>
- <li class="archived">
- <a href="http://msdn.microsoft.com/en-us/library/t6tay6cz(d=printer,v=vs.71).aspx">Visual Studio .NET 2003</a>
- </li>
- <li id="vsExpand">
- <span class="breadcrumbEllipsis">
- <a href="http://msdn.microsoft.com/#"></a>
- </span>
- </li>
- </ul>
- </div>
- </div>
- <div style="clear:both;"></div>
- <div id="mainSection">
- <div id="mainBody"> <div class="introduction"><p>The Debug Interface Access (DIA) SDK supplies you with instructional documentation and a sample that illustrates how to use the DIA API. Use the interfaces and methods in the DIA SDK to develop custom applications that open the .pdb and .dbg files and search their content for symbols, values, attributes, addresses, and other debugging information. This SDK also provides reference tables for the properties associated with symbols found in C++ applications.</p><p>To best use the DIA SDK, you should be familiar with the following: </p><ul class="unordered"><li><p>C++ programming language</p></li><li><p>COM programming</p></li><li><p>Visual Studio integrated development environment (IDE) for compiling the samples</p></li></ul><p>The DIA SDK is normally installed with Visual Studio and its default location is <em>[drive]</em>\Program Files\Microsoft Visual Studio 9.0\DIA SDK. As part of the installation, the msdia90.dll, which implements the DIA SDK, is automatically registered so all that you need to do to use it is to include <span class="code">dia2.h</span> in your program and link to <span class="code">diaguids.lib</span>.</p><p>Header: include\dia2.h</p><p>Library: lib\diaguids.lib</p><p>DLL: bin\msdia80.dll</p><p>IDL: idl\dia2.idl</p></div><div><h2 class="LW_CollapsibleArea_TitleDiv"><div><a href="javascript:void(0)" class="LW_CollapsibleArea_TitleAhref" title="Collapse" role="button"><span class="cl_CollapsibleArea_expanding LW_CollapsibleArea_Img"></span><span class="LW_CollapsibleArea_Title">In This Section</span></a><div id="Anchor_0" class="LW_CollapsibleArea_Anchor_Div"><a href="http://msdn.microsoft.com/en-us/library/t6tay6cz(d=printer).aspx?lan=csharp&cc=n&trm=tra&view=book#Anchor_0" class="LW_CollapsibleArea_Anchor_Img" title="Right-click to copy and share the link for this section"></a></div><div class="LW_CollapsibleArea_HrDiv"><hr class="LW_CollapsibleArea_Hr"></div></div></h2><div class="sectionblock"><div class="section"><dl class="definitionTable"><dt><a href="https://msdn.microsoft.com/en-us/library/dkx24d4d.aspx">Overview (Debug Interface Access SDK)</a></dt><dd><p>Reviews the basic architecture of DIA.</p></dd><dt><a href="https://msdn.microsoft.com/en-us/library/eee38t3h.aspx">Querying the .Pdb File</a></dt><dd><p>Provides step-by-step instructions on how to use the DIA API to query a .pdb file.</p></dd></dl></div></div></div><div><h2 class="LW_CollapsibleArea_TitleDiv"><div><a href="javascript:void(0)" class="LW_CollapsibleArea_TitleAhref" title="Collapse" role="button"><span class="cl_CollapsibleArea_expanding LW_CollapsibleArea_Img"></span><span class="LW_CollapsibleArea_Title">See Also</span></a><div id="Anchor_1" class="LW_CollapsibleArea_Anchor_Div"><a href="http://msdn.microsoft.com/en-us/library/t6tay6cz(d=printer).aspx?lan=csharp&cc=n&trm=tra&view=book#Anchor_1" class="LW_CollapsibleArea_Anchor_Img" title="Right-click to copy and share the link for this section"></a></div><div class="LW_CollapsibleArea_HrDiv"><hr class="LW_CollapsibleArea_Hr"></div></div></h2><div class="sectionblock"><p><a href="https://msdn.microsoft.com/en-us/library/x93ctkx8.aspx">Debug Interface Access SDK</a><br></p></div></div></div>
- </div>
- </div>
- </div>
-
- </div>
- </div>
- <div class="clear"></div>
-
- <input name="__RequestVerificationToken" type="hidden" value="fC5irECx0_9LBUGAQFUsV3BZh0ogC461uz755VhjPUWni-F__CXnBpmm4K4gxHF0e64Ojkr8wg-Rk0KvNk5qaSSBH_k1">
- <input id="ratingValueSubmitUrl" type="hidden" value="https://msdn.microsoft.com/en-us/library/feedback/rate/t6tay6cz(d=printer).aspx">
- <input id="ratingAdditionalSubmitUrl" type="hidden" value="https://msdn.microsoft.com/en-us/library/feedback/additional/t6tay6cz(d=printer).aspx">
- <input id="isTopicRated" type="hidden" value="false">
- <div id="lib-footer" ms.pgarea="body">
-
-
- <link type="text/css" rel="stylesheet">
-
- <div id="ux-footer" class="" style="" dir="ltr">
-
- <div id="footerSock" class="librarySock both">
- <div id="footerSockInner">
- <a name="feedback"></a>
- <div class="rating">
- <div id="ratingSection1">
- <div class="title">
- Was this page helpful?
- </div>
- <div class="description">
- Your feedback about this content is important.<br>Let us know what you think.
- </div>
- <div class="buttons">
- <button class="button" id="ratingYes" aria-label="Yes, this page was helpful">Yes</button>
- <button class="button" id="ratingNo" aria-label="No, this page was not helpful">No</button>
- </div>
- <input id="ratingValue" type="hidden" value="">
- </div>
- <div id="ratingSection2">
- <div class="title left">
- Additional feedback?
- </div>
- <textarea id="ratingText" rows="6" cols="" maxlength="1500"></textarea>
- <div class="right">
- <div class="counter">
- <span id="feedbackTextCounter">1500</span> characters remaining
- </div>
- <div class="buttons">
- <button class="button" id="ratingSubmit" aria-label="Submit my additional feedback">Submit</button>
- <button class="button" id="ratingSkipThis" aria-label="Skip additional feedback">Skip this</button>
- </div>
- </div>
- </div>
- <div id="ratingSection3">
- <div class="title">
- Thank you!
- </div>
- <div class="description">
- We appreciate your feedback.
- </div>
- </div>
-
-
- <div id="contentFeedbackQAContainer" style="display: none;"></div>
- </div>
-
- <div class="userVoice">
- <div class="title">
- Help us improve MSDN.
- </div>
- <div class="description">
- Visit our UserVoice Page to submit and vote on ideas!
- </div>
- <div class="buttons">
- <a class="button" id="userVoiceButton" href="http://feedback.msdn.com/forums/257782-msdn-feature-suggestions/category/83975" target="_blank">Make a suggestion</a>
- </div>
- </div>
- <div class="clear"></div>
- </div>
- </div>
- <footer class="top">
- <div data-fragmentname="LeftLinks" id="Fragment_LeftLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Dev centers</div>
- <ul class="links">
- <li>
- <a href="https://dev.windows.com/" id="LeftLinks_2148_1" class="windowsBlue" xmlns="http://www.w3.org/1999/xhtml">Windows</a>
- </li>
- <li>
- <a href="http://dev.office.com/" id="LeftLinks_2148_3" class="office" xmlns="http://www.w3.org/1999/xhtml">Office</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/vstudio" id="LeftLinks_2148_4" class="visualStudio" xmlns="http://www.w3.org/1999/xhtml">Visual Studio</a>
- </li>
- <li>
- <a href="http://azure.microsoft.com/en-us/documentation/" target="_blank" id="LeftLinks_2148_12" xmlns="http://www.w3.org/1999/xhtml">Microsoft Azure</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/developer-centers-msdn" id="LeftLinks_2148_5" xmlns="http://www.w3.org/1999/xhtml">More...</a>
- </li>
- </ul>
- </div>
- </div>
- <div id="rightLinks">
- <div data-fragmentname="CenterLinks1" id="Fragment_CenterLinks1" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Learning resources</div>
- <ul class="links">
- <li>
- <a href="http://www.microsoftvirtualacademy.com/" id="CenterLinks1_2151_4" xmlns="http://www.w3.org/1999/xhtml">Microsoft Virtual Academy</a>
- </li>
- <li>
- <a href="http://channel9.msdn.com/" id="CenterLinks1_2151_5" xmlns="http://www.w3.org/1999/xhtml">Channel 9</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/magazine/" id="CenterLinks1_2151_7" xmlns="http://www.w3.org/1999/xhtml">MSDN Magazine</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks2" id="Fragment_CenterLinks2" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Community</div>
- <ul class="links">
- <li>
- <a href="https://social.msdn.microsoft.com/forums/en-us/home" id="CenterLinks2_2151_8" xmlns="http://www.w3.org/1999/xhtml">Forums</a>
- </li>
- <li>
- <a href="http://blogs.msdn.com/b/developer-tools/" id="CenterLinks2_2151_9" xmlns="http://www.w3.org/1999/xhtml">Blogs</a>
- </li>
- <li>
- <a href="http://www.codeplex.com/" id="CenterLinks2_2151_10" xmlns="http://www.w3.org/1999/xhtml">Codeplex</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks3" id="Fragment_CenterLinks3" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Support</div>
- <ul class="links">
- <li>
- <a href="https://msdn.microsoft.com/hh361695" id="CenterLinks3_2151_11" xmlns="http://www.w3.org/1999/xhtml">Self support</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks4" id="Fragment_CenterLinks4" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Programs</div>
- <ul class="links">
- <li>
- <a href="https://www.microsoft.com/bizspark/" id="CenterLinks4_2151_13" xmlns="http://www.w3.org/1999/xhtml">BizSpark (for startups)</a>
- </li>
- <li>
- <a href="https://www.dreamspark.com/" id="CenterLinks4_2151_14" xmlns="http://www.w3.org/1999/xhtml">DreamSpark</a>
- </li>
- <li>
- <a href="http://www.imaginecup.com/" id="CenterLinks4_2151_17" xmlns="http://www.w3.org/1999/xhtml">Imagine Cup</a>
- </li>
- </ul>
- </div>
- </div>
- </div>
- </footer>
- <footer class="bottom">
- <span class="localeContainer">
-
- <form class="selectLocale" id="selectLocaleForm" action="https://msdn.microsoft.com/en-us/selectlocale-dmc">
- <input type="hidden" name="fromPage" value="https%3a%2f%2fmsdn.microsoft.com%2fen-us%2flibrary%2ft6tay6cz(d%3dprinter).aspx%3flan%3dCSharp%26cc%3dn%26trm%3dtra%26view%3dbook">
- <a href="http://msdn.microsoft.com/#" onclick="$('#selectLocaleForm').submit();return false;" title="Change your language">United States (English)</a>
- </form>
- </span>
- <div data-fragmentname="BottomLinks" id="Fragment_BottomLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <ul class="links horizontal">
- <li>
- <a href="https://msdn.microsoft.com/newsletter.aspx" id="BottomLinks_2148_7" xmlns="http://www.w3.org/1999/xhtml">Newsletter</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/dn529288" id="BottomLinks_2148_8" xmlns="http://www.w3.org/1999/xhtml">Privacy & cookies</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/cc300389" id="BottomLinks_2148_9" xmlns="http://www.w3.org/1999/xhtml">Terms of use</a>
- </li>
- <li>
- <a href="https://www.microsoft.com/en-us/legal/intellectualproperty/Trademarks/EN-US.aspx" id="BottomLinks_2148_10" xmlns="http://www.w3.org/1999/xhtml">Trademarks</a>
- </li>
- </ul>
- </div>
- </div>
- <span class="logoLegal">
- <span class="logo"></span>
- <span class="copyright">© 2016 Microsoft</span>
- </span>
- </footer>
- </div>
-
- </div>
- <div class="footerPrintView">
- <div class="footerCopyrightPrintView">© 2016 Microsoft</div>
- </div>
-
-
-
-
- <input id="tocPaddingPerLevel" type="hidden" value="17">
- <input id="MtpsDevice" type="hidden" value="Printer">
- <!--[CDATA[ Third party scripts and code linked to or referenced from this website are licensed to you by the parties that own such code, not by Microsoft. See ASP.NET Ajax CDN Terms of Use – http://www.asp.net/ajaxlibrary/CDN.ashx. ]]-->
-
-
-
-
-
- <noscript><div><img alt="DCSIMG" id="Img1" width="1" height="1" src="https://m.webtrends.com/dcsmgru7m99k7mqmgrhudo0k8_8c6m/njs.gif?dcsuri=/nojavascript&amp;WT.js=No" /></div></noscript>
- <div id="globalRequestVerification">
- <input name="__RequestVerificationToken" type="hidden" value="UJW6uluSJzJMbANdA-5ZQj5mmW0SbNy_FeT0JzRkocBaC3eMRwF_Vbomc7i8wzOu9_hQYcHq682nphcgnQZ6VAca0V01">
- </div>
- </div>
-
-
-
-
-
-
- <script type="text/javascript" class="mtps-injected">
- /*<![CDATA[*/
- (function(window,document){"use strict";function preload(scripts){for(var result=[],script,e,i=0;i<scripts.length;i++)script=scripts[i],script.hasOwnProperty("url")&&(e=document.createElement("script"),e.src=script.url,script.throwaway=e),result.push(script);return result}function inject(scripts,index){var script,elem;if(index>=scripts.length){delete mtps.injectScripts;return}script=scripts[index];elem=document.createElement("script");elem.className="mtps-injected";elem.async=!1;var isLoaded=!1,timeoutId=0,injectNextFnName="",injectNext=elem.onerror=function(){isLoaded||(isLoaded=!0,inject(scripts,index+1),window.clearTimeout(timeoutId),elem.onload=elem.onerror=elem.onreadystatechange=null,injectNextFnName&&delete mtps[injectNextFnName],elem.removeEventListener&&elem.removeEventListener("load",injectNext,!1))};elem.addEventListener?elem.addEventListener("load",injectNext,!1):elem.readyState==="uninitialized"?elem.onreadystatechange=function(){(this.readyState==="loaded"||this.readyState==="complete")&&injectNext()}:elem.onload=injectNext;script.hasOwnProperty("url")?(timeoutId=window.setTimeout(injectNext,12e4),elem.src=script.url):(injectNextFnName="_injectNextScript_"+index,mtps[injectNextFnName]=injectNext,timeoutId=window.setTimeout(injectNext,2e3),elem.text="try {\n"+script.txt+"\n} finally { MTPS."+injectNextFnName+" && MTPS."+injectNextFnName+"(); }");parent.appendChild(elem)}var mtps=window.MTPS||(window.MTPS={}),parent=document.getElementsByTagName("head")[0];mtps.injectScripts=function(scripts){inject(preload(scripts),0)}})(window,document);
- MTPS.injectScripts([
- { txt: "/**/\r\n(window.MTPS || (window.MTPS = {})).cdnDomains || (window.MTPS.cdnDomains = { \r\n\t\"image\": \"https://i-msdn.sec.s-msft.com\", \r\n\t\"js\": \"https://i2-msdn.sec.s-msft.com\", \r\n\t\"css\": \"https://i-msdn.sec.s-msft.com\", \r\n\t\"ttf\": \"https://i-msdn.sec.s-msft.com\"\r\n});\r\n/**/" },
- { txt: "//\n var literalNormalizedUrl = \u0027/en-us/library/t6tay6cz(d=printer,l=en-us,v=vs.140).aspx\u0027;\n var wt_nvr_ru = \u0027WT_NVR_RU\u0027;\n var wt_fpcdom = \u0027.microsoft.com\u0027;\n var wt_domlist = \u0027msdn.microsoft.com\u0027;\n var wt_pathlist = \u0027\u0027;\n var wt_paramlist = \u0027DCSext.mtps_devcenter\u0027;\n var wt_siteid = \u0027MSDN\u0027;\n var gDomain = \u0027m.webtrends.com\u0027;\n var gDcsId = \u0027dcsmgru7m99k7mqmgrhudo0k8_8c6m\u0027;\n var gFpc = \u0027WT_FPC\u0027;\n\n\n\n if (document.cookie.indexOf(gFpc + \"=\") == -1) {\n var wtidJs = document.createElement(\"script\");\n wtidJs.src = \"//\" + gDomain + \"/\" + gDcsId + \"/wtid.js\";\n document.getElementsByTagName(\"head\")[0].appendChild(wtidJs);\n }\n\n\n\n var detectedLocale = \u0027en-us\u0027;\n var wtsp = \u0027msdnlib_devtools_lang\u0027;\n var gTrackEvents = \u00270\u0027;\n/**/" },
- { txt: "//\n\n window.appInsightsId = \u00275eb1b2eb-c47a-497a-a7ac-a1c230b2882f\u0027;\n //" },
- { url: "https://i2-msdn.sec.s-msft.com/Combined.js?resources=0:Utilities,1:Layout,2:Header,1:Rating,2:Footer,0:Topic,3:PabTopic,4:webtrendsscript,0:AppInsightsPerf,0:ABTestControl,5:WEDCS,3:CmpgrpForHeader,0:livefyre,0:Comment,1:SearchBox;/Areas/Epx/Content/Scripts:0,/Areas/Epx/Themes/Base/Content:1,/Areas/Centers/Themes/StandardDevCenter/Content:2,/Areas/Library/Content:3,/Areas/Global/Content/Webtrends/resources:4,/Areas/Library/Themes/Base/Content:5\u0026amp;hashKey=30CEE944AABFEA2C5A338BDB9E000732\u0026amp;v=F664E7A9238E1F224D24BE082A3197DF" },
- { url: "https://i1.services.social.microsoft.com/search/Widgets/SearchBox.jss?boxid=HeaderSearchTextBox\u0026btnid=HeaderSearchButton\u0026pgArea=header\u0026brand=Msdn\u0026loc=en-us\u0026focusOnInit=false\u0026emptyWatermark=true\u0026searchButtonTooltip=Search MSDN" },
- { url: "https://i2-msdn.sec.s-msft.com/Areas/Library/Themes/Base/Content/PrintExportButton.js" },
- { txt: "MTPS = window.MTPS || {}; MTPS.LocalizedStrings = window.MTPS.LocalizedStrings || {}; MTPS.LocalizedStrings.ExpandButtonTooltip = \u0027Expand\u0027; MTPS.LocalizedStrings.CollapseButtonTooltip = \u0027Collapse\u0027; MTPS.LocalizedStrings.EnhancedExpandTooltip = \u0027Click to expand. Double-click to expand all.\u0027; MTPS.LocalizedStrings.EnhancedCollapseTooltip = \u0027Click to collapse. Double-click to collapse all.\u0027; MTPS.LocalizedStrings.ExpandAllButtonTooltip = \u0027Expand All\u0027; MTPS.LocalizedStrings.CollapseAllButtonTooltip = \u0027Collapse All\u0027;" },
- { url: "https://i2-msdn.sec.s-msft.com/Combined.js?resources=0:Toc_Fixed,0:CodeSnippet,0:TopicNotInScope,0:CollapsibleArea,0:VersionSelector,0:SurveyBroker;/Areas/Epx/Content/Scripts:0\u0026amp;hashKey=8DC15B34541884CA29DF06F58B5CA754\u0026amp;v=F664E7A9238E1F224D24BE082A3197DF" },
- { txt: "$(document).ready(function() {\n try {\n var token = $(\"#globalRequestVerification input[name=\u0027__RequestVerificationToken\u0027]\").clone();\n $(\"#siteFeedbackForm\").append(token);\n } catch(err) {\n \n }\n });" }
- ]);
- /*]]>*/
- </script>
- <link rel="stylesheet" type="text/css" href="./Windows Kernel Development Articles (2016-03-30)_files/Combined.css">
- <div id="page">
-
-
-
-
- <link type="text/css" rel="stylesheet">
-
- <input type="hidden" id="isHeaderBleeding" value="true">
- <div id="ux-header" dir="ltr" class="ltr msdn">
-
- <header>
- <span id="singleCol"></span>
- <span id="doubleCol"></span>
- <span id="isMobile"></span>
- <div>
- <div class="row topRow">
- <div class="top">
- <div class="left">
- <a class="msdnLogoImg" href="https://msdn.microsoft.com/en-us" title="MSDN home">
- <div id="msft-logo" class="msft-logo"></div>
- </a>
- <div class="GrayPipe"></div>
- <a class="DevCenterFullNameNonMegaBlade" href="https://msdn.microsoft.com/en-us">Developer Network</a>
- <a class="DevCenterFullName" href="https://msdn.microsoft.com/en-us">Developer Network</a>
- <a class="DevCenterShortName" href="https://msdn.microsoft.com/en-us">Developer</a>
- </div>
- <div class="right">
- <div id="signIn">
- <div class="profileImage"></div>
- <a class="scarabLink" href="https://login.live.com/login.srf?wa=wsignin1.0&rpsnv=12&ct=1459376401&rver=6.0.5276.0&wp=mcmbi&wlcxt=msdn%24msdn%24msdn&wreply=https%3a%2f%2fmsdn.microsoft.com%2fen-us%2flibrary%2fff554731%2528d%3dprinter%2cv%3dvs.85%2529.aspx%3flan%3dcsharp%26cc%3dn%26trm%3dtra%26view%3dbook&lc=1033&id=254354&mkt=en-us" title="Sign in">Sign in</a></div>
- <div class="auxNav">
- <div>
- <div data-fragmentname="Subscriptions" id="Fragment_Subscriptions" xmlns="http://www.w3.org/1999/xhtml">
- <a href="https://msdn.microsoft.com/subscriptions/manage/hh442900" id="Subscriptions_2153_1" xmlns="http://www.w3.org/1999/xhtml">MSDN subscriptions</a>
- </div>
- <div data-fragmentname="GetTools" id="Fragment_GetTools" xmlns="http://www.w3.org/1999/xhtml">
- <a href="http://go.microsoft.com/fwlink/?LinkId=309297&clcid=0x409&slcid=0x409&campaign=o~msft~msdn~gettools-header~dn308572" id="GetTools_2153_3" xmlns="http://www.w3.org/1999/xhtml">Get tools</a>
- </div>
- </div>
- <div>
- <div data-fragmentname="SocialLinks" id="Fragment_SocialLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <ul class="links horizontal">
- <li>
- <a href="http://www.facebook.com/microsoftdeveloper" target="_blank" id="SocialLinks_2152_4" class="facebook" xmlns="http://www.w3.org/1999/xhtml">http://www.facebook.com/microsoftdeveloper</a>
- </li>
- <li>
- <a href="https://twitter.com/msdev" target="_blank" id="SocialLinks_2152_5" class="twitter" xmlns="http://www.w3.org/1999/xhtml">https://twitter.com/msdev</a>
- </li>
- <li>
- <a href="http://plus.google.com/111221966647232053570/" target="_blank" id="SocialLinks_2152_6" class="googlePlus" xmlns="http://www.w3.org/1999/xhtml">http://plus.google.com/111221966647232053570/</a>
- </li>
- </ul>
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- <div class="row middleRow">
- <div class="expandTop">
- <div class="left"></div>
- <div class="right"></div>
- </div>
- </div>
- </div>
- <div id="buttomRowWrapper" class="bg_default">
- <div class="row buttomRow bg_default">
- <div class="bottom">
- <div class="left">
- <a id="grip" class="menu-icon" href="javascript:void(0)"></a>
-
- <div id="drawer">
- <div class="toc">
-
- <nav>
- <ul class="navL1">
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Technologies">Technologies</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/cloud-app-development-msdn" title="Cloud">Cloud</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/app-development-msdn" title="App Development">App Development</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/web-app-development-msdn" title="Web">Web</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/big-data-development-msdn" title="Data">Data</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/games-development-msdn" title="Gaming">Gaming</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/internetofthings" title="Internet of Things">Internet of Things</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Downloads">Downloads</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://www.visualstudio.com/downloads/download-visual-studio-vs" title="Visual Studio">Visual Studio</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/subscriptions" title="MSDN subscription access">MSDN subscription access</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/microsoft-sdks-msdn" title="SDKs">SDKs</a>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Trial software">Trial software</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/evalcenter" title="Free downloads">Free downloads</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/officeevaluationresources" title="Office resources">Office resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/sharepoint2013resources" title="SharePoint Server 2013 resources">SharePoint Server 2013 resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/sqlserver2014expressresources" title="SQL Server 2014 Express resources">SQL Server 2014 Express resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/windowsserver2012r2resources" title="Windows Server 2012 resources">Windows Server 2012 resources</a>
- </li>
- </ul>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Programs">Programs</a>
- <ul class="navL2">
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Visual Studio subscriptions">Visual Studio subscriptions</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/msdn-subscriptions-overview" title="Overview">Overview</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/benefits-overview" title="Benefits">Benefits</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/msdn-subscriptions-administration" title="Administrators">Administrators</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Students">Students</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/imagine/imagine-home" title="Microsoft Imagine">Microsoft Imagine</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/microsoftstudentpartners" title="Microsoft Student Partners">Microsoft Student Partners</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Architects">Architects</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-overview-msdn" title="Overview">Overview</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-case-studies-msdn" title="Case studies">Case studies</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-blueprints-msdn" title="Blueprints">Blueprints</a>
- </li>
- <li class="inactive">
- <a href="http://blogs.msdn.com/b/msarchitecture/" title="Blog">Blog</a>
- </li>
- <li class="inactive">
- <a href="http://social.msdn.microsoft.com/forums/en-us/home?brandignore=true&sort=relevancedesc&searchterm=architecture+or+architect" title="Forums">Forums</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/applicationbuilder" title="ISV">ISV</a>
-
- </li>
- <li class="inactive">
- <a href="https://www.microsoft.com/bizspark" title="Startups">Startups</a>
-
- </li>
- <li class="inactive">
- <a href="https://rewards.msdn.microsoft.com/" title="TechRewards">TechRewards</a>
-
- </li>
- <li class="inactive">
- <a href="http://events.msdn.microsoft.com/" title="Events">Events</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Community">Community</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/magazine/dd767791" title="Magazine">Magazine</a>
-
- </li>
- <li class="inactive">
- <a href="https://social.msdn.microsoft.com/forums/" title="Forums">Forums</a>
-
- </li>
- <li class="inactive">
- <a href="http://blogs.msdn.com/b/developer-tools/" title="Blogs">Blogs</a>
-
- </li>
- <li class="inactive">
- <a href="http://tech-advisors.msdn.microsoft.com/en-us" title="Tech Advisors">Tech Advisors</a>
-
- </li>
- <li class="inactive">
- <a href="http://channel9.msdn.com/" title="Channel 9">Channel 9</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive current toggle">
- <a href="javascript:void(0)" title="Documentation">Documentation</a>
- <ul class="navL2">
- <li class="inactive current">
- <a href="https://msdn.microsoft.com/library" title="APIs and reference">APIs and reference</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/developer-centers-msdn" title="Dev centers">Dev centers</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive">
- <a href="https://code.msdn.microsoft.com/" title="Samples">Samples</a>
- </li>
- </ul>
- </nav>
- </div>
- </div>
- </div>
- <div class="right">
- <div data-fragmentname="SearchBox" id="Fragment_SearchBox" xmlns="http://www.w3.org/1999/xhtml">
- <div class="SearchBox">
- <form id="HeaderSearchForm" name="HeaderSearchForm" method="get">
- <button id="FakeHeaderSearchButton" value="Search" type="submit" class="header-search-button">
- <div id="search-finder" class="search-finder"></div>
- </button>
- <button id="HeaderSearchButton" style="display:none"></button>
- <div id="searchSplitter"></div>
- <div id="searchCloseIcon" class="search-clear-x"></div>
- <div id="searchTextContainer" style="width: 0;">
- <input id="HeaderSearchTextBox" name="query" type="text" maxlength="200" onfocus="Epx.Controls.SearchBox.watermarkFocus(event, this.title)" onblur="Epx.Controls.SearchBox.watermarkBlur(event, this.title)">
- </div>
- </form>
-
-
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- </header>
- </div>
-
-
-
- <div class="printExportMenus ltr">
- <a id="isd_printABook" href="http://msdn.microsoft.com/en-us/library/export/help/(d=printer)?returnurl=%2fen-us%2flibrary%2fff554731(d%3dprinter,v%3dvs.85).aspx%3flan%3dcsharp%26cc%3dn%26trm%3dtra%26view%3dbook">
- Export (<span class="count">0</span>)
- </a>
- <a id="isd_print" href="https://msdn.microsoft.com/en-us/library/ff554731(d=printer,v=vs.85).aspx?lan=csharp&cc=n&trm=tra&view=book" rel="nofollow">
- Print
- </a>
- <a id="isd_archiveControl" style="display:none;" data-include-archive="Include Previous Version" data-exclude-archive="Exclude Previous Version">
- </a>
- </div>
-
- <div class="printExportMenus ltr">
- <a id="expandCollapseAll" accesskey="e" href="javascript:void(0)" title="Expand/Collapse all sections by pressing Ctrl + Shift + e">Expand All</a>
- </div>
-
- <div id="body" ms.pgarea="body">
- <span id="tabletView_large"></span>
- <span id="tabletView_small"></span>
- <span id="mobileView"></span>
-
- <div id="content" class="content">
- <input type="hidden" id="printForPab" value="true">
-
- <div class="topic" xmlns="http://www.w3.org/1999/xhtml">
- <h1 class="title">Concepts for all driver developers</h1>
-
- <div id="mainSection">
- <div class="clsServerSDKContent">
- </div>
- <p>In this section:</p>
- <ul>
- <li>
- <a href="https://msdn.microsoft.com/en-us/library/ff554836(v=vs.85).aspx">User mode and kernel mode</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/en-us/library/hh439648(v=vs.85).aspx">Virtual address spaces</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/en-us/library/ff554721(v=vs.85).aspx">Device nodes and device stacks</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/en-us/library/hh439638(v=vs.85).aspx">I/O request packets</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/en-us/library/hh439632(v=vs.85).aspx">Driver stacks</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/en-us/library/hh439643(v=vs.85).aspx">Minidrivers and driver pairs</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/en-us/library/ff554695(v=vs.85).aspx">Header files in the Windows Driver Kit</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/en-us/library/ff554887(v=vs.85).aspx">Writing drivers for different versions of Windows</a>
- </li>
- </ul>
- <p> </p>
- <p> </p>
- <p><a href="mailto:wsddocfb@microsoft.com?subject=Documentation%20feedback%20[wdkgetstart\wdkgetstart]:%20Concepts%20%20for%20all%20driver%20developers%20%20RELEASE:%20(3/4/2016)&body=%0A%0APRIVACY%20STATEMENT%0A%0AWe%20use%20your%20feedback%20to%20improve%20the%20documentation.%20We%20don%27t%20use%20your%20email%20address%20for%20any%20other%20purpose,%20and%20we%27ll%20remove%20your%20email%20address%20from%20our%20system%20after%20the%20issue%20that%20you%27re%20reporting%20is%20fixed.%20While%20we%27re%20working%20to%20fix%20this%20issue,%20we%20might%20send%20you%20an%20email%20message%20to%20ask%20for%20more%20info.%20Later,%20we%20might%20also%20send%20you%20an%20email%20message%20to%20let%20you%20know%20that%20we%27ve%20addressed%20your%20feedback.%0A%0AFor%20more%20info%20about%20Microsoft%27s%20privacy%20policy,%20see%20http://privacy.microsoft.com/en-us/default.aspx." title="Send comments about this topic to Microsoft">Send comments about this topic to Microsoft</a></p>
- </div>
- </div>
-
- </div>
- </div>
- <div class="clear"></div>
-
- <input name="__RequestVerificationToken" type="hidden" value="t76Kx9in0yOgfbe6qotdxH_Nw5Qf3MT8lt9pt9EhFOUvN8v8YOkSM6LEHVtvd99rZgIRQrA9ilOAqonMlnQKSdUP9RU1">
- <input id="ratingValueSubmitUrl" type="hidden" value="https://msdn.microsoft.com/en-us/library/feedback/rate/ff554731(d=printer,v=vs.85).aspx">
- <input id="ratingAdditionalSubmitUrl" type="hidden" value="https://msdn.microsoft.com/en-us/library/feedback/additional/ff554731(d=printer,v=vs.85).aspx">
- <input id="isTopicRated" type="hidden" value="false">
- <div id="lib-footer" ms.pgarea="body">
-
-
- <link type="text/css" rel="stylesheet">
-
- <div id="ux-footer" class="" style="" dir="ltr">
-
- <div id="footerSock" class="librarySock both">
- <div id="footerSockInner">
- <a name="feedback"></a>
- <div class="rating">
- <div id="ratingSection1">
- <div class="title">
- Was this page helpful?
- </div>
- <div class="description">
- Your feedback about this content is important.<br>Let us know what you think.
- </div>
- <div class="buttons">
- <button class="button" id="ratingYes" aria-label="Yes, this page was helpful">Yes</button>
- <button class="button" id="ratingNo" aria-label="No, this page was not helpful">No</button>
- </div>
- <input id="ratingValue" type="hidden" value="">
- </div>
- <div id="ratingSection2">
- <div class="title left">
- Additional feedback?
- </div>
- <textarea id="ratingText" rows="6" cols="" maxlength="1500"></textarea>
- <div class="right">
- <div class="counter">
- <span id="feedbackTextCounter">1500</span> characters remaining
- </div>
- <div class="buttons">
- <button class="button" id="ratingSubmit" aria-label="Submit my additional feedback">Submit</button>
- <button class="button" id="ratingSkipThis" aria-label="Skip additional feedback">Skip this</button>
- </div>
- </div>
- </div>
- <div id="ratingSection3">
- <div class="title">
- Thank you!
- </div>
- <div class="description">
- We appreciate your feedback.
- </div>
- </div>
-
-
- <div id="contentFeedbackQAContainer" style="display: none;"></div>
- </div>
-
- <div class="userVoice">
- <div class="title">
- Help us improve MSDN.
- </div>
- <div class="description">
- Visit our UserVoice Page to submit and vote on ideas!
- </div>
- <div class="buttons">
- <a class="button" id="userVoiceButton" href="http://feedback.msdn.com/forums/257782-msdn-feature-suggestions/category/83975" target="_blank">Make a suggestion</a>
- </div>
- </div>
- <div class="clear"></div>
- </div>
- </div>
- <footer class="top">
- <div data-fragmentname="LeftLinks" id="Fragment_LeftLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Dev centers</div>
- <ul class="links">
- <li>
- <a href="https://dev.windows.com/" id="LeftLinks_2148_1" class="windowsBlue" xmlns="http://www.w3.org/1999/xhtml">Windows</a>
- </li>
- <li>
- <a href="http://dev.office.com/" id="LeftLinks_2148_3" class="office" xmlns="http://www.w3.org/1999/xhtml">Office</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/vstudio" id="LeftLinks_2148_4" class="visualStudio" xmlns="http://www.w3.org/1999/xhtml">Visual Studio</a>
- </li>
- <li>
- <a href="http://azure.microsoft.com/en-us/documentation/" target="_blank" id="LeftLinks_2148_12" xmlns="http://www.w3.org/1999/xhtml">Microsoft Azure</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/developer-centers-msdn" id="LeftLinks_2148_5" xmlns="http://www.w3.org/1999/xhtml">More...</a>
- </li>
- </ul>
- </div>
- </div>
- <div id="rightLinks">
- <div data-fragmentname="CenterLinks1" id="Fragment_CenterLinks1" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Learning resources</div>
- <ul class="links">
- <li>
- <a href="http://www.microsoftvirtualacademy.com/" id="CenterLinks1_2151_4" xmlns="http://www.w3.org/1999/xhtml">Microsoft Virtual Academy</a>
- </li>
- <li>
- <a href="http://channel9.msdn.com/" id="CenterLinks1_2151_5" xmlns="http://www.w3.org/1999/xhtml">Channel 9</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/magazine/" id="CenterLinks1_2151_7" xmlns="http://www.w3.org/1999/xhtml">MSDN Magazine</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks2" id="Fragment_CenterLinks2" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Community</div>
- <ul class="links">
- <li>
- <a href="https://social.msdn.microsoft.com/forums/en-us/home" id="CenterLinks2_2151_8" xmlns="http://www.w3.org/1999/xhtml">Forums</a>
- </li>
- <li>
- <a href="http://blogs.msdn.com/b/developer-tools/" id="CenterLinks2_2151_9" xmlns="http://www.w3.org/1999/xhtml">Blogs</a>
- </li>
- <li>
- <a href="http://www.codeplex.com/" id="CenterLinks2_2151_10" xmlns="http://www.w3.org/1999/xhtml">Codeplex</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks3" id="Fragment_CenterLinks3" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Support</div>
- <ul class="links">
- <li>
- <a href="https://msdn.microsoft.com/hh361695" id="CenterLinks3_2151_11" xmlns="http://www.w3.org/1999/xhtml">Self support</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks4" id="Fragment_CenterLinks4" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Programs</div>
- <ul class="links">
- <li>
- <a href="https://www.microsoft.com/bizspark/" id="CenterLinks4_2151_13" xmlns="http://www.w3.org/1999/xhtml">BizSpark (for startups)</a>
- </li>
- <li>
- <a href="https://www.dreamspark.com/" id="CenterLinks4_2151_14" xmlns="http://www.w3.org/1999/xhtml">DreamSpark</a>
- </li>
- <li>
- <a href="http://www.imaginecup.com/" id="CenterLinks4_2151_17" xmlns="http://www.w3.org/1999/xhtml">Imagine Cup</a>
- </li>
- </ul>
- </div>
- </div>
- </div>
- </footer>
- <footer class="bottom">
- <span class="localeContainer">
-
- <form class="selectLocale" id="selectLocaleForm" action="https://msdn.microsoft.com/en-us/selectlocale-dmc">
- <input type="hidden" name="fromPage" value="https%3a%2f%2fmsdn.microsoft.com%2fen-us%2flibrary%2fff554731(d%3dprinter%2cv%3dvs.85).aspx%3flan%3dCSharp%26cc%3dn%26trm%3dtra%26view%3dbook">
- <a href="http://msdn.microsoft.com/#" onclick="$('#selectLocaleForm').submit();return false;" title="Change your language">United States (English)</a>
- </form>
- </span>
- <div data-fragmentname="BottomLinks" id="Fragment_BottomLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <ul class="links horizontal">
- <li>
- <a href="https://msdn.microsoft.com/newsletter.aspx" id="BottomLinks_2148_7" xmlns="http://www.w3.org/1999/xhtml">Newsletter</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/dn529288" id="BottomLinks_2148_8" xmlns="http://www.w3.org/1999/xhtml">Privacy & cookies</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/cc300389" id="BottomLinks_2148_9" xmlns="http://www.w3.org/1999/xhtml">Terms of use</a>
- </li>
- <li>
- <a href="https://www.microsoft.com/en-us/legal/intellectualproperty/Trademarks/EN-US.aspx" id="BottomLinks_2148_10" xmlns="http://www.w3.org/1999/xhtml">Trademarks</a>
- </li>
- </ul>
- </div>
- </div>
- <span class="logoLegal">
- <span class="logo"></span>
- <span class="copyright">© 2016 Microsoft</span>
- </span>
- </footer>
- </div>
-
- </div>
- <div class="footerPrintView">
- <div class="footerCopyrightPrintView">© 2016 Microsoft</div>
- </div>
-
-
-
-
- <input id="tocPaddingPerLevel" type="hidden" value="17">
- <input id="MtpsDevice" type="hidden" value="Printer">
- <!--[CDATA[ Third party scripts and code linked to or referenced from this website are licensed to you by the parties that own such code, not by Microsoft. See ASP.NET Ajax CDN Terms of Use – http://www.asp.net/ajaxlibrary/CDN.ashx. ]]-->
-
-
-
-
-
- <noscript><div><img alt="DCSIMG" id="Img1" width="1" height="1" src="https://m.webtrends.com/dcsmgru7m99k7mqmgrhudo0k8_8c6m/njs.gif?dcsuri=/nojavascript&amp;WT.js=No" /></div></noscript>
- <div id="globalRequestVerification">
- <input name="__RequestVerificationToken" type="hidden" value="q0uOrQwQMQm251YKk2G9L-mMFZTvnfY2fez-znh11k_hjzxk06dyZhtbgB9cGL9H5NLfbp0TovGTftXRNPg2pP0eKUw1">
- </div>
- </div>
-
-
-
-
-
-
- <script type="text/javascript" class="mtps-injected">
- /*<![CDATA[*/
- (function(window,document){"use strict";function preload(scripts){for(var result=[],script,e,i=0;i<scripts.length;i++)script=scripts[i],script.hasOwnProperty("url")&&(e=document.createElement("script"),e.src=script.url,script.throwaway=e),result.push(script);return result}function inject(scripts,index){var script,elem;if(index>=scripts.length){delete mtps.injectScripts;return}script=scripts[index];elem=document.createElement("script");elem.className="mtps-injected";elem.async=!1;var isLoaded=!1,timeoutId=0,injectNextFnName="",injectNext=elem.onerror=function(){isLoaded||(isLoaded=!0,inject(scripts,index+1),window.clearTimeout(timeoutId),elem.onload=elem.onerror=elem.onreadystatechange=null,injectNextFnName&&delete mtps[injectNextFnName],elem.removeEventListener&&elem.removeEventListener("load",injectNext,!1))};elem.addEventListener?elem.addEventListener("load",injectNext,!1):elem.readyState==="uninitialized"?elem.onreadystatechange=function(){(this.readyState==="loaded"||this.readyState==="complete")&&injectNext()}:elem.onload=injectNext;script.hasOwnProperty("url")?(timeoutId=window.setTimeout(injectNext,12e4),elem.src=script.url):(injectNextFnName="_injectNextScript_"+index,mtps[injectNextFnName]=injectNext,timeoutId=window.setTimeout(injectNext,2e3),elem.text="try {\n"+script.txt+"\n} finally { MTPS."+injectNextFnName+" && MTPS."+injectNextFnName+"(); }");parent.appendChild(elem)}var mtps=window.MTPS||(window.MTPS={}),parent=document.getElementsByTagName("head")[0];mtps.injectScripts=function(scripts){inject(preload(scripts),0)}})(window,document);
- MTPS.injectScripts([
- { txt: "/**/\r\n(window.MTPS || (window.MTPS = {})).cdnDomains || (window.MTPS.cdnDomains = { \r\n\t\"image\": \"https://i-msdn.sec.s-msft.com\", \r\n\t\"js\": \"https://i2-msdn.sec.s-msft.com\", \r\n\t\"css\": \"https://i-msdn.sec.s-msft.com\", \r\n\t\"ttf\": \"https://i-msdn.sec.s-msft.com\"\r\n});\r\n/**/" },
- { txt: "//\n var literalNormalizedUrl = \u0027/en-us/library/ff554731(d=printer,l=en-us,v=vs.85).aspx\u0027;\n var wt_nvr_ru = \u0027WT_NVR_RU\u0027;\n var wt_fpcdom = \u0027.microsoft.com\u0027;\n var wt_domlist = \u0027msdn.microsoft.com\u0027;\n var wt_pathlist = \u0027\u0027;\n var wt_paramlist = \u0027DCSext.mtps_devcenter\u0027;\n var wt_siteid = \u0027MSDN\u0027;\n var gDomain = \u0027m.webtrends.com\u0027;\n var gDcsId = \u0027dcsmgru7m99k7mqmgrhudo0k8_8c6m\u0027;\n var gFpc = \u0027WT_FPC\u0027;\n\n\n\n if (document.cookie.indexOf(gFpc + \"=\") == -1) {\n var wtidJs = document.createElement(\"script\");\n wtidJs.src = \"//\" + gDomain + \"/\" + gDcsId + \"/wtid.js\";\n document.getElementsByTagName(\"head\")[0].appendChild(wtidJs);\n }\n\n\n\n var detectedLocale = \u0027en-us\u0027;\n var wtsp = \u0027msdnlib_w32_com\u0027;\n var gTrackEvents = \u00270\u0027;\n/**/" },
- { txt: "//\n\n window.appInsightsId = \u00275eb1b2eb-c47a-497a-a7ac-a1c230b2882f\u0027;\n //" },
- { url: "https://i2-msdn.sec.s-msft.com/Combined.js?resources=0:Utilities,1:Layout,2:Header,1:Rating,2:Footer,0:Topic,3:PabTopic,4:webtrendsscript,0:AppInsightsPerf,0:ABTestControl,5:WEDCS,3:CmpgrpForHeader,0:livefyre,0:Comment,1:SearchBox;/Areas/Epx/Content/Scripts:0,/Areas/Epx/Themes/Base/Content:1,/Areas/Centers/Themes/StandardDevCenter/Content:2,/Areas/Library/Content:3,/Areas/Global/Content/Webtrends/resources:4,/Areas/Library/Themes/Base/Content:5\u0026amp;hashKey=30CEE944AABFEA2C5A338BDB9E000732\u0026amp;v=AE608271C0243AAA0449D3BC0FAD8EB4" },
- { url: "https://i1.services.social.microsoft.com/search/Widgets/SearchBox.jss?boxid=HeaderSearchTextBox\u0026btnid=HeaderSearchButton\u0026pgArea=header\u0026brand=Msdn\u0026loc=en-us\u0026focusOnInit=false\u0026emptyWatermark=true\u0026searchButtonTooltip=Search MSDN" },
- { url: "https://i2-msdn.sec.s-msft.com/Combined.js?resources=0:PrintExportButton,1:Toc_Fixed,1:CodeSnippet,1:TopicNotInScope,1:CollapsibleArea,1:VersionSelector,1:SurveyBroker;/Areas/Library/Themes/Base/Content:0,/Areas/Epx/Content/Scripts:1\u0026amp;hashKey=80F30894E3FB8A3295C923AEC7019CFE\u0026amp;v=AE608271C0243AAA0449D3BC0FAD8EB4" },
- { txt: "$(document).ready(function() {\n try {\n var token = $(\"#globalRequestVerification input[name=\u0027__RequestVerificationToken\u0027]\").clone();\n $(\"#siteFeedbackForm\").append(token);\n } catch(err) {\n \n }\n });" }
- ]);
- /*]]>*/
- </script>
- <link rel="stylesheet" type="text/css" href="./Windows Kernel Development Articles (2016-03-30)_files/Combined.css">
- <div id="page">
-
-
-
-
- <link type="text/css" rel="stylesheet">
-
- <input type="hidden" id="isHeaderBleeding" value="true">
- <div id="ux-header" dir="ltr" class="ltr msdn">
-
- <header>
- <span id="singleCol"></span>
- <span id="doubleCol"></span>
- <span id="isMobile"></span>
- <div>
- <div class="row topRow">
- <div class="top">
- <div class="left">
- <a class="msdnLogoImg" href="https://msdn.microsoft.com/en-us" title="MSDN home">
- <div id="msft-logo" class="msft-logo"></div>
- </a>
- <div class="GrayPipe"></div>
- <a class="DevCenterFullNameNonMegaBlade" href="https://msdn.microsoft.com/en-us">Developer Network</a>
- <a class="DevCenterFullName" href="https://msdn.microsoft.com/en-us">Developer Network</a>
- <a class="DevCenterShortName" href="https://msdn.microsoft.com/en-us">Developer</a>
- </div>
- <div class="right">
- <div id="signIn">
- <div class="profileImage"></div>
- <a class="scarabLink" href="https://login.live.com/login.srf?wa=wsignin1.0&rpsnv=12&ct=1459376402&rver=6.0.5276.0&wp=mcmbi&wlcxt=msdn%24msdn%24msdn&wreply=https%3a%2f%2fmsdn.microsoft.com%2fen-us%2flibrary%2fff554836%2528d%3dprinter%2cv%3dvs.85%2529.aspx%3flan%3dcsharp%26cc%3dn%26trm%3dtra%26view%3dbook&lc=1033&id=254354&mkt=en-us" title="Sign in">Sign in</a></div>
- <div class="auxNav">
- <div>
- <div data-fragmentname="Subscriptions" id="Fragment_Subscriptions" xmlns="http://www.w3.org/1999/xhtml">
- <a href="https://msdn.microsoft.com/subscriptions/manage/hh442900" id="Subscriptions_2153_1" xmlns="http://www.w3.org/1999/xhtml">MSDN subscriptions</a>
- </div>
- <div data-fragmentname="GetTools" id="Fragment_GetTools" xmlns="http://www.w3.org/1999/xhtml">
- <a href="http://go.microsoft.com/fwlink/?LinkId=309297&clcid=0x409&slcid=0x409&campaign=o~msft~msdn~gettools-header~dn308572" id="GetTools_2153_3" xmlns="http://www.w3.org/1999/xhtml">Get tools</a>
- </div>
- </div>
- <div>
- <div data-fragmentname="SocialLinks" id="Fragment_SocialLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <ul class="links horizontal">
- <li>
- <a href="http://www.facebook.com/microsoftdeveloper" target="_blank" id="SocialLinks_2152_4" class="facebook" xmlns="http://www.w3.org/1999/xhtml">http://www.facebook.com/microsoftdeveloper</a>
- </li>
- <li>
- <a href="https://twitter.com/msdev" target="_blank" id="SocialLinks_2152_5" class="twitter" xmlns="http://www.w3.org/1999/xhtml">https://twitter.com/msdev</a>
- </li>
- <li>
- <a href="http://plus.google.com/111221966647232053570/" target="_blank" id="SocialLinks_2152_6" class="googlePlus" xmlns="http://www.w3.org/1999/xhtml">http://plus.google.com/111221966647232053570/</a>
- </li>
- </ul>
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- <div class="row middleRow">
- <div class="expandTop">
- <div class="left"></div>
- <div class="right"></div>
- </div>
- </div>
- </div>
- <div id="buttomRowWrapper" class="bg_default">
- <div class="row buttomRow bg_default">
- <div class="bottom">
- <div class="left">
- <a id="grip" class="menu-icon" href="javascript:void(0)"></a>
-
- <div id="drawer">
- <div class="toc">
-
- <nav>
- <ul class="navL1">
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Technologies">Technologies</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/cloud-app-development-msdn" title="Cloud">Cloud</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/app-development-msdn" title="App Development">App Development</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/web-app-development-msdn" title="Web">Web</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/big-data-development-msdn" title="Data">Data</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/games-development-msdn" title="Gaming">Gaming</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/internetofthings" title="Internet of Things">Internet of Things</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Downloads">Downloads</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://www.visualstudio.com/downloads/download-visual-studio-vs" title="Visual Studio">Visual Studio</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/subscriptions" title="MSDN subscription access">MSDN subscription access</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/microsoft-sdks-msdn" title="SDKs">SDKs</a>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Trial software">Trial software</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/evalcenter" title="Free downloads">Free downloads</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/officeevaluationresources" title="Office resources">Office resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/sharepoint2013resources" title="SharePoint Server 2013 resources">SharePoint Server 2013 resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/sqlserver2014expressresources" title="SQL Server 2014 Express resources">SQL Server 2014 Express resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/windowsserver2012r2resources" title="Windows Server 2012 resources">Windows Server 2012 resources</a>
- </li>
- </ul>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Programs">Programs</a>
- <ul class="navL2">
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Visual Studio subscriptions">Visual Studio subscriptions</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/msdn-subscriptions-overview" title="Overview">Overview</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/benefits-overview" title="Benefits">Benefits</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/msdn-subscriptions-administration" title="Administrators">Administrators</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Students">Students</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/imagine/imagine-home" title="Microsoft Imagine">Microsoft Imagine</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/microsoftstudentpartners" title="Microsoft Student Partners">Microsoft Student Partners</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Architects">Architects</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-overview-msdn" title="Overview">Overview</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-case-studies-msdn" title="Case studies">Case studies</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-blueprints-msdn" title="Blueprints">Blueprints</a>
- </li>
- <li class="inactive">
- <a href="http://blogs.msdn.com/b/msarchitecture/" title="Blog">Blog</a>
- </li>
- <li class="inactive">
- <a href="http://social.msdn.microsoft.com/forums/en-us/home?brandignore=true&sort=relevancedesc&searchterm=architecture+or+architect" title="Forums">Forums</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/applicationbuilder" title="ISV">ISV</a>
-
- </li>
- <li class="inactive">
- <a href="https://www.microsoft.com/bizspark" title="Startups">Startups</a>
-
- </li>
- <li class="inactive">
- <a href="https://rewards.msdn.microsoft.com/" title="TechRewards">TechRewards</a>
-
- </li>
- <li class="inactive">
- <a href="http://events.msdn.microsoft.com/" title="Events">Events</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Community">Community</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/magazine/dd767791" title="Magazine">Magazine</a>
-
- </li>
- <li class="inactive">
- <a href="https://social.msdn.microsoft.com/forums/" title="Forums">Forums</a>
-
- </li>
- <li class="inactive">
- <a href="http://blogs.msdn.com/b/developer-tools/" title="Blogs">Blogs</a>
-
- </li>
- <li class="inactive">
- <a href="http://tech-advisors.msdn.microsoft.com/en-us" title="Tech Advisors">Tech Advisors</a>
-
- </li>
- <li class="inactive">
- <a href="http://channel9.msdn.com/" title="Channel 9">Channel 9</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive current toggle">
- <a href="javascript:void(0)" title="Documentation">Documentation</a>
- <ul class="navL2">
- <li class="inactive current">
- <a href="https://msdn.microsoft.com/library" title="APIs and reference">APIs and reference</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/developer-centers-msdn" title="Dev centers">Dev centers</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive">
- <a href="https://code.msdn.microsoft.com/" title="Samples">Samples</a>
- </li>
- </ul>
- </nav>
- </div>
- </div>
- </div>
- <div class="right">
- <div data-fragmentname="SearchBox" id="Fragment_SearchBox" xmlns="http://www.w3.org/1999/xhtml">
- <div class="SearchBox">
- <form id="HeaderSearchForm" name="HeaderSearchForm" method="get">
- <button id="FakeHeaderSearchButton" value="Search" type="submit" class="header-search-button">
- <div id="search-finder" class="search-finder"></div>
- </button>
- <button id="HeaderSearchButton" style="display:none"></button>
- <div id="searchSplitter"></div>
- <div id="searchCloseIcon" class="search-clear-x"></div>
- <div id="searchTextContainer" style="width: 0;">
- <input id="HeaderSearchTextBox" name="query" type="text" maxlength="200" onfocus="Epx.Controls.SearchBox.watermarkFocus(event, this.title)" onblur="Epx.Controls.SearchBox.watermarkBlur(event, this.title)">
- </div>
- </form>
-
-
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- </header>
- </div>
-
-
-
- <div class="printExportMenus ltr">
- <a id="isd_printABook" href="http://msdn.microsoft.com/en-us/library/export/help/(d=printer)?returnurl=%2fen-us%2flibrary%2fff554836(d%3dprinter,v%3dvs.85).aspx%3flan%3dcsharp%26cc%3dn%26trm%3dtra%26view%3dbook">
- Export (<span class="count">0</span>)
- </a>
- <a id="isd_print" href="https://msdn.microsoft.com/en-us/library/ff554836(d=printer,v=vs.85).aspx?lan=csharp&cc=n&trm=tra&view=book" rel="nofollow">
- Print
- </a>
- <a id="isd_archiveControl" style="display:none;" data-include-archive="Include Previous Version" data-exclude-archive="Exclude Previous Version">
- </a>
- </div>
-
- <div class="printExportMenus ltr">
- <a id="expandCollapseAll" accesskey="e" href="javascript:void(0)" title="Expand/Collapse all sections by pressing Ctrl + Shift + e">Expand All</a>
- </div>
-
- <div id="body" ms.pgarea="body">
- <span id="tabletView_large"></span>
- <span id="tabletView_small"></span>
- <span id="mobileView"></span>
-
- <div id="content" class="content">
- <input type="hidden" id="printForPab" value="true">
-
- <div class="topic" xmlns="http://www.w3.org/1999/xhtml">
- <h1 class="title">User mode and kernel mode</h1>
-
- <div id="mainSection">
- <div class="clsServerSDKContent">
- </div>
- <p>A processor in a computer running Windows has two different modes: <em>user mode</em> and <em>kernel mode</em>. The processor switches between the two modes depending on what type of code is running on the processor. Applications run in user mode, and core operating system components run in kernel mode. While many drivers run in kernel mode, some drivers may run in user mode.</p>
- <p>When you start a user-mode application, Windows creates a <em>process</em> for the application. The process provides the application with a private <em>virtual address space</em> and a private <em>handle table</em>. Because an application's virtual address space is private, one application cannot alter data that belongs to another application. Each application runs in isolation, and if an application crashes, the crash is limited to that one application. Other applications and the operating system are not affected by the crash.</p>
- <p>In addition to being private, the virtual address space of a user-mode application is limited. A processor running in user mode cannot access virtual addresses that are reserved for the operating system. Limiting the virtual address space of a user-mode application prevents the application from altering, and possibly damaging, critical operating system data.</p>
- <p>All code that runs in kernel mode shares a single virtual address space. This means that a kernel-mode driver is not isolated from other drivers and the operating system itself. If a kernel-mode driver accidentally writes to the wrong virtual address, data that belongs to the operating system or another driver could be compromised. If a kernel-mode driver crashes, the entire operating system crashes.</p>
- <p>This diagram illustrates communication between user-mode and kernel-mode components.</p><img id="UserAndKernelMode01" alt="Block diagram of user-mode and kernel-mode components" src="./Windows Kernel Development Articles (2016-03-30)_files/IC535109.png" title="Block diagram of user-mode and kernel-mode components" xmlns=""><h2><a id="related_topics"></a>Related topics</h2>
- <dl>
- <dt>
- <a href="https://msdn.microsoft.com/en-us/library/hh439648(v=vs.85).aspx">Virtual Address Spaces</a>
- </dt>
- </dl>
- <p> </p>
- <p> </p>
- <p><a href="mailto:wsddocfb@microsoft.com?subject=Documentation%20feedback%20[wdkgetstart\wdkgetstart]:%20User%20mode%20and%20kernel%20mode%20%20RELEASE:%20(3/4/2016)&body=%0A%0APRIVACY%20STATEMENT%0A%0AWe%20use%20your%20feedback%20to%20improve%20the%20documentation.%20We%20don%27t%20use%20your%20email%20address%20for%20any%20other%20purpose,%20and%20we%27ll%20remove%20your%20email%20address%20from%20our%20system%20after%20the%20issue%20that%20you%27re%20reporting%20is%20fixed.%20While%20we%27re%20working%20to%20fix%20this%20issue,%20we%20might%20send%20you%20an%20email%20message%20to%20ask%20for%20more%20info.%20Later,%20we%20might%20also%20send%20you%20an%20email%20message%20to%20let%20you%20know%20that%20we%27ve%20addressed%20your%20feedback.%0A%0AFor%20more%20info%20about%20Microsoft%27s%20privacy%20policy,%20see%20http://privacy.microsoft.com/en-us/default.aspx." title="Send comments about this topic to Microsoft">Send comments about this topic to Microsoft</a></p>
- </div>
- </div>
-
- </div>
- </div>
- <div class="clear"></div>
-
- <input name="__RequestVerificationToken" type="hidden" value="f479RiBDFQ9pMjoUqDZoqYnbXyhYSWyu_WRZ0a8KOwQUI1AuuUz5DX2igUpWJPsiWcZQSkDJ-jqtkkPr1rH9CCrmgcY1">
- <input id="ratingValueSubmitUrl" type="hidden" value="https://msdn.microsoft.com/en-us/library/feedback/rate/ff554836(d=printer,v=vs.85).aspx">
- <input id="ratingAdditionalSubmitUrl" type="hidden" value="https://msdn.microsoft.com/en-us/library/feedback/additional/ff554836(d=printer,v=vs.85).aspx">
- <input id="isTopicRated" type="hidden" value="false">
- <div id="lib-footer" ms.pgarea="body">
-
-
- <link type="text/css" rel="stylesheet">
-
- <div id="ux-footer" class="" style="" dir="ltr">
-
- <div id="footerSock" class="librarySock both">
- <div id="footerSockInner">
- <a name="feedback"></a>
- <div class="rating">
- <div id="ratingSection1">
- <div class="title">
- Was this page helpful?
- </div>
- <div class="description">
- Your feedback about this content is important.<br>Let us know what you think.
- </div>
- <div class="buttons">
- <button class="button" id="ratingYes" aria-label="Yes, this page was helpful">Yes</button>
- <button class="button" id="ratingNo" aria-label="No, this page was not helpful">No</button>
- </div>
- <input id="ratingValue" type="hidden" value="">
- </div>
- <div id="ratingSection2">
- <div class="title left">
- Additional feedback?
- </div>
- <textarea id="ratingText" rows="6" cols="" maxlength="1500"></textarea>
- <div class="right">
- <div class="counter">
- <span id="feedbackTextCounter">1500</span> characters remaining
- </div>
- <div class="buttons">
- <button class="button" id="ratingSubmit" aria-label="Submit my additional feedback">Submit</button>
- <button class="button" id="ratingSkipThis" aria-label="Skip additional feedback">Skip this</button>
- </div>
- </div>
- </div>
- <div id="ratingSection3">
- <div class="title">
- Thank you!
- </div>
- <div class="description">
- We appreciate your feedback.
- </div>
- </div>
-
-
- <div id="contentFeedbackQAContainer" style="display: none;"></div>
- </div>
-
- <div class="userVoice">
- <div class="title">
- Help us improve MSDN.
- </div>
- <div class="description">
- Visit our UserVoice Page to submit and vote on ideas!
- </div>
- <div class="buttons">
- <a class="button" id="userVoiceButton" href="http://feedback.msdn.com/forums/257782-msdn-feature-suggestions/category/83975" target="_blank">Make a suggestion</a>
- </div>
- </div>
- <div class="clear"></div>
- </div>
- </div>
- <footer class="top">
- <div data-fragmentname="LeftLinks" id="Fragment_LeftLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Dev centers</div>
- <ul class="links">
- <li>
- <a href="https://dev.windows.com/" id="LeftLinks_2148_1" class="windowsBlue" xmlns="http://www.w3.org/1999/xhtml">Windows</a>
- </li>
- <li>
- <a href="http://dev.office.com/" id="LeftLinks_2148_3" class="office" xmlns="http://www.w3.org/1999/xhtml">Office</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/vstudio" id="LeftLinks_2148_4" class="visualStudio" xmlns="http://www.w3.org/1999/xhtml">Visual Studio</a>
- </li>
- <li>
- <a href="http://azure.microsoft.com/en-us/documentation/" target="_blank" id="LeftLinks_2148_12" xmlns="http://www.w3.org/1999/xhtml">Microsoft Azure</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/developer-centers-msdn" id="LeftLinks_2148_5" xmlns="http://www.w3.org/1999/xhtml">More...</a>
- </li>
- </ul>
- </div>
- </div>
- <div id="rightLinks">
- <div data-fragmentname="CenterLinks1" id="Fragment_CenterLinks1" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Learning resources</div>
- <ul class="links">
- <li>
- <a href="http://www.microsoftvirtualacademy.com/" id="CenterLinks1_2151_4" xmlns="http://www.w3.org/1999/xhtml">Microsoft Virtual Academy</a>
- </li>
- <li>
- <a href="http://channel9.msdn.com/" id="CenterLinks1_2151_5" xmlns="http://www.w3.org/1999/xhtml">Channel 9</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/magazine/" id="CenterLinks1_2151_7" xmlns="http://www.w3.org/1999/xhtml">MSDN Magazine</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks2" id="Fragment_CenterLinks2" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Community</div>
- <ul class="links">
- <li>
- <a href="https://social.msdn.microsoft.com/forums/en-us/home" id="CenterLinks2_2151_8" xmlns="http://www.w3.org/1999/xhtml">Forums</a>
- </li>
- <li>
- <a href="http://blogs.msdn.com/b/developer-tools/" id="CenterLinks2_2151_9" xmlns="http://www.w3.org/1999/xhtml">Blogs</a>
- </li>
- <li>
- <a href="http://www.codeplex.com/" id="CenterLinks2_2151_10" xmlns="http://www.w3.org/1999/xhtml">Codeplex</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks3" id="Fragment_CenterLinks3" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Support</div>
- <ul class="links">
- <li>
- <a href="https://msdn.microsoft.com/hh361695" id="CenterLinks3_2151_11" xmlns="http://www.w3.org/1999/xhtml">Self support</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks4" id="Fragment_CenterLinks4" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Programs</div>
- <ul class="links">
- <li>
- <a href="https://www.microsoft.com/bizspark/" id="CenterLinks4_2151_13" xmlns="http://www.w3.org/1999/xhtml">BizSpark (for startups)</a>
- </li>
- <li>
- <a href="https://www.dreamspark.com/" id="CenterLinks4_2151_14" xmlns="http://www.w3.org/1999/xhtml">DreamSpark</a>
- </li>
- <li>
- <a href="http://www.imaginecup.com/" id="CenterLinks4_2151_17" xmlns="http://www.w3.org/1999/xhtml">Imagine Cup</a>
- </li>
- </ul>
- </div>
- </div>
- </div>
- </footer>
- <footer class="bottom">
- <span class="localeContainer">
-
- <form class="selectLocale" id="selectLocaleForm" action="https://msdn.microsoft.com/en-us/selectlocale-dmc">
- <input type="hidden" name="fromPage" value="https%3a%2f%2fmsdn.microsoft.com%2fen-us%2flibrary%2fff554836(d%3dprinter%2cv%3dvs.85).aspx%3flan%3dCSharp%26cc%3dn%26trm%3dtra%26view%3dbook">
- <a href="http://msdn.microsoft.com/#" onclick="$('#selectLocaleForm').submit();return false;" title="Change your language">United States (English)</a>
- </form>
- </span>
- <div data-fragmentname="BottomLinks" id="Fragment_BottomLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <ul class="links horizontal">
- <li>
- <a href="https://msdn.microsoft.com/newsletter.aspx" id="BottomLinks_2148_7" xmlns="http://www.w3.org/1999/xhtml">Newsletter</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/dn529288" id="BottomLinks_2148_8" xmlns="http://www.w3.org/1999/xhtml">Privacy & cookies</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/cc300389" id="BottomLinks_2148_9" xmlns="http://www.w3.org/1999/xhtml">Terms of use</a>
- </li>
- <li>
- <a href="https://www.microsoft.com/en-us/legal/intellectualproperty/Trademarks/EN-US.aspx" id="BottomLinks_2148_10" xmlns="http://www.w3.org/1999/xhtml">Trademarks</a>
- </li>
- </ul>
- </div>
- </div>
- <span class="logoLegal">
- <span class="logo"></span>
- <span class="copyright">© 2016 Microsoft</span>
- </span>
- </footer>
- </div>
-
- </div>
- <div class="footerPrintView">
- <div class="footerCopyrightPrintView">© 2016 Microsoft</div>
- </div>
-
-
-
-
- <input id="tocPaddingPerLevel" type="hidden" value="17">
- <input id="MtpsDevice" type="hidden" value="Printer">
- <!--[CDATA[ Third party scripts and code linked to or referenced from this website are licensed to you by the parties that own such code, not by Microsoft. See ASP.NET Ajax CDN Terms of Use – http://www.asp.net/ajaxlibrary/CDN.ashx. ]]-->
-
-
-
-
-
- <noscript><div><img alt="DCSIMG" id="Img1" width="1" height="1" src="https://m.webtrends.com/dcsmgru7m99k7mqmgrhudo0k8_8c6m/njs.gif?dcsuri=/nojavascript&amp;WT.js=No" /></div></noscript>
- <div id="globalRequestVerification">
- <input name="__RequestVerificationToken" type="hidden" value="6k8g70Z0LcG5CGNyQxheMXiaImIWx_X6S7EuuaPiRPvAXPtBQVy1V0XDGIa2N1jbRv3ntTVA9VG46UnmJ4K6osO_NtI1">
- </div>
- </div>
-
-
-
-
-
-
- <script type="text/javascript" class="mtps-injected">
- /*<![CDATA[*/
- (function(window,document){"use strict";function preload(scripts){for(var result=[],script,e,i=0;i<scripts.length;i++)script=scripts[i],script.hasOwnProperty("url")&&(e=document.createElement("script"),e.src=script.url,script.throwaway=e),result.push(script);return result}function inject(scripts,index){var script,elem;if(index>=scripts.length){delete mtps.injectScripts;return}script=scripts[index];elem=document.createElement("script");elem.className="mtps-injected";elem.async=!1;var isLoaded=!1,timeoutId=0,injectNextFnName="",injectNext=elem.onerror=function(){isLoaded||(isLoaded=!0,inject(scripts,index+1),window.clearTimeout(timeoutId),elem.onload=elem.onerror=elem.onreadystatechange=null,injectNextFnName&&delete mtps[injectNextFnName],elem.removeEventListener&&elem.removeEventListener("load",injectNext,!1))};elem.addEventListener?elem.addEventListener("load",injectNext,!1):elem.readyState==="uninitialized"?elem.onreadystatechange=function(){(this.readyState==="loaded"||this.readyState==="complete")&&injectNext()}:elem.onload=injectNext;script.hasOwnProperty("url")?(timeoutId=window.setTimeout(injectNext,12e4),elem.src=script.url):(injectNextFnName="_injectNextScript_"+index,mtps[injectNextFnName]=injectNext,timeoutId=window.setTimeout(injectNext,2e3),elem.text="try {\n"+script.txt+"\n} finally { MTPS."+injectNextFnName+" && MTPS."+injectNextFnName+"(); }");parent.appendChild(elem)}var mtps=window.MTPS||(window.MTPS={}),parent=document.getElementsByTagName("head")[0];mtps.injectScripts=function(scripts){inject(preload(scripts),0)}})(window,document);
- MTPS.injectScripts([
- { txt: "/**/\r\n(window.MTPS || (window.MTPS = {})).cdnDomains || (window.MTPS.cdnDomains = { \r\n\t\"image\": \"https://i-msdn.sec.s-msft.com\", \r\n\t\"js\": \"https://i2-msdn.sec.s-msft.com\", \r\n\t\"css\": \"https://i-msdn.sec.s-msft.com\", \r\n\t\"ttf\": \"https://i-msdn.sec.s-msft.com\"\r\n});\r\n/**/" },
- { txt: "//\n var literalNormalizedUrl = \u0027/en-us/library/ff554836(d=printer,l=en-us,v=vs.85).aspx\u0027;\n var wt_nvr_ru = \u0027WT_NVR_RU\u0027;\n var wt_fpcdom = \u0027.microsoft.com\u0027;\n var wt_domlist = \u0027msdn.microsoft.com\u0027;\n var wt_pathlist = \u0027\u0027;\n var wt_paramlist = \u0027DCSext.mtps_devcenter\u0027;\n var wt_siteid = \u0027MSDN\u0027;\n var gDomain = \u0027m.webtrends.com\u0027;\n var gDcsId = \u0027dcsmgru7m99k7mqmgrhudo0k8_8c6m\u0027;\n var gFpc = \u0027WT_FPC\u0027;\n\n\n\n if (document.cookie.indexOf(gFpc + \"=\") == -1) {\n var wtidJs = document.createElement(\"script\");\n wtidJs.src = \"//\" + gDomain + \"/\" + gDcsId + \"/wtid.js\";\n document.getElementsByTagName(\"head\")[0].appendChild(wtidJs);\n }\n\n\n\n var detectedLocale = \u0027en-us\u0027;\n var wtsp = \u0027msdnlib_w32_com\u0027;\n var gTrackEvents = \u00270\u0027;\n/**/" },
- { txt: "//\n\n window.appInsightsId = \u00275eb1b2eb-c47a-497a-a7ac-a1c230b2882f\u0027;\n //" },
- { url: "https://i2-msdn.sec.s-msft.com/Combined.js?resources=0:Utilities,1:Layout,2:Header,1:Rating,2:Footer,0:Topic,3:PabTopic,4:webtrendsscript,0:AppInsightsPerf,0:ABTestControl,5:WEDCS,3:CmpgrpForHeader,0:livefyre,0:Comment,1:SearchBox;/Areas/Epx/Content/Scripts:0,/Areas/Epx/Themes/Base/Content:1,/Areas/Centers/Themes/StandardDevCenter/Content:2,/Areas/Library/Content:3,/Areas/Global/Content/Webtrends/resources:4,/Areas/Library/Themes/Base/Content:5\u0026amp;hashKey=30CEE944AABFEA2C5A338BDB9E000732\u0026amp;v=AE608271C0243AAA0449D3BC0FAD8EB4" },
- { url: "https://i1.services.social.microsoft.com/search/Widgets/SearchBox.jss?boxid=HeaderSearchTextBox\u0026btnid=HeaderSearchButton\u0026pgArea=header\u0026brand=Msdn\u0026loc=en-us\u0026focusOnInit=false\u0026emptyWatermark=true\u0026searchButtonTooltip=Search MSDN" },
- { url: "https://i2-msdn.sec.s-msft.com/Combined.js?resources=0:PrintExportButton,1:Toc_Fixed,1:CodeSnippet,1:TopicNotInScope,1:CollapsibleArea,1:VersionSelector,1:SurveyBroker;/Areas/Library/Themes/Base/Content:0,/Areas/Epx/Content/Scripts:1\u0026amp;hashKey=80F30894E3FB8A3295C923AEC7019CFE\u0026amp;v=AE608271C0243AAA0449D3BC0FAD8EB4" },
- { txt: "$(document).ready(function() {\n try {\n var token = $(\"#globalRequestVerification input[name=\u0027__RequestVerificationToken\u0027]\").clone();\n $(\"#siteFeedbackForm\").append(token);\n } catch(err) {\n \n }\n });" }
- ]);
- /*]]>*/
- </script>
- <link rel="stylesheet" type="text/css" href="./Windows Kernel Development Articles (2016-03-30)_files/Combined.css">
- <div id="page">
-
-
-
-
- <link type="text/css" rel="stylesheet">
-
- <input type="hidden" id="isHeaderBleeding" value="true">
- <div id="ux-header" dir="ltr" class="ltr msdn">
-
- <header>
- <span id="singleCol"></span>
- <span id="doubleCol"></span>
- <span id="isMobile"></span>
- <div>
- <div class="row topRow">
- <div class="top">
- <div class="left">
- <a class="msdnLogoImg" href="https://msdn.microsoft.com/en-us" title="MSDN home">
- <div id="msft-logo" class="msft-logo"></div>
- </a>
- <div class="GrayPipe"></div>
- <a class="DevCenterFullNameNonMegaBlade" href="https://msdn.microsoft.com/en-us">Developer Network</a>
- <a class="DevCenterFullName" href="https://msdn.microsoft.com/en-us">Developer Network</a>
- <a class="DevCenterShortName" href="https://msdn.microsoft.com/en-us">Developer</a>
- </div>
- <div class="right">
- <div id="signIn">
- <div class="profileImage"></div>
- <a class="scarabLink" href="https://login.live.com/login.srf?wa=wsignin1.0&rpsnv=12&ct=1459376404&rver=6.0.5276.0&wp=mcmbi&wlcxt=msdn%24msdn%24msdn&wreply=https%3a%2f%2fmsdn.microsoft.com%2fen-us%2flibrary%2fhh439648%2528d%3dprinter%2cv%3dvs.85%2529.aspx%3flan%3dcsharp%26cc%3dn%26trm%3dtra%26view%3dbook&lc=1033&id=254354&mkt=en-us" title="Sign in">Sign in</a></div>
- <div class="auxNav">
- <div>
- <div data-fragmentname="Subscriptions" id="Fragment_Subscriptions" xmlns="http://www.w3.org/1999/xhtml">
- <a href="https://msdn.microsoft.com/subscriptions/manage/hh442900" id="Subscriptions_2153_1" xmlns="http://www.w3.org/1999/xhtml">MSDN subscriptions</a>
- </div>
- <div data-fragmentname="GetTools" id="Fragment_GetTools" xmlns="http://www.w3.org/1999/xhtml">
- <a href="http://go.microsoft.com/fwlink/?LinkId=309297&clcid=0x409&slcid=0x409&campaign=o~msft~msdn~gettools-header~dn308572" id="GetTools_2153_3" xmlns="http://www.w3.org/1999/xhtml">Get tools</a>
- </div>
- </div>
- <div>
- <div data-fragmentname="SocialLinks" id="Fragment_SocialLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <ul class="links horizontal">
- <li>
- <a href="http://www.facebook.com/microsoftdeveloper" target="_blank" id="SocialLinks_2152_4" class="facebook" xmlns="http://www.w3.org/1999/xhtml">http://www.facebook.com/microsoftdeveloper</a>
- </li>
- <li>
- <a href="https://twitter.com/msdev" target="_blank" id="SocialLinks_2152_5" class="twitter" xmlns="http://www.w3.org/1999/xhtml">https://twitter.com/msdev</a>
- </li>
- <li>
- <a href="http://plus.google.com/111221966647232053570/" target="_blank" id="SocialLinks_2152_6" class="googlePlus" xmlns="http://www.w3.org/1999/xhtml">http://plus.google.com/111221966647232053570/</a>
- </li>
- </ul>
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- <div class="row middleRow">
- <div class="expandTop">
- <div class="left"></div>
- <div class="right"></div>
- </div>
- </div>
- </div>
- <div id="buttomRowWrapper" class="bg_default">
- <div class="row buttomRow bg_default">
- <div class="bottom">
- <div class="left">
- <a id="grip" class="menu-icon" href="javascript:void(0)"></a>
-
- <div id="drawer">
- <div class="toc">
-
- <nav>
- <ul class="navL1">
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Technologies">Technologies</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/cloud-app-development-msdn" title="Cloud">Cloud</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/app-development-msdn" title="App Development">App Development</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/web-app-development-msdn" title="Web">Web</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/big-data-development-msdn" title="Data">Data</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/games-development-msdn" title="Gaming">Gaming</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/internetofthings" title="Internet of Things">Internet of Things</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Downloads">Downloads</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://www.visualstudio.com/downloads/download-visual-studio-vs" title="Visual Studio">Visual Studio</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/subscriptions" title="MSDN subscription access">MSDN subscription access</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/microsoft-sdks-msdn" title="SDKs">SDKs</a>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Trial software">Trial software</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/evalcenter" title="Free downloads">Free downloads</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/officeevaluationresources" title="Office resources">Office resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/sharepoint2013resources" title="SharePoint Server 2013 resources">SharePoint Server 2013 resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/sqlserver2014expressresources" title="SQL Server 2014 Express resources">SQL Server 2014 Express resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/windowsserver2012r2resources" title="Windows Server 2012 resources">Windows Server 2012 resources</a>
- </li>
- </ul>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Programs">Programs</a>
- <ul class="navL2">
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Visual Studio subscriptions">Visual Studio subscriptions</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/msdn-subscriptions-overview" title="Overview">Overview</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/benefits-overview" title="Benefits">Benefits</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/msdn-subscriptions-administration" title="Administrators">Administrators</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Students">Students</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/imagine/imagine-home" title="Microsoft Imagine">Microsoft Imagine</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/microsoftstudentpartners" title="Microsoft Student Partners">Microsoft Student Partners</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Architects">Architects</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-overview-msdn" title="Overview">Overview</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-case-studies-msdn" title="Case studies">Case studies</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-blueprints-msdn" title="Blueprints">Blueprints</a>
- </li>
- <li class="inactive">
- <a href="http://blogs.msdn.com/b/msarchitecture/" title="Blog">Blog</a>
- </li>
- <li class="inactive">
- <a href="http://social.msdn.microsoft.com/forums/en-us/home?brandignore=true&sort=relevancedesc&searchterm=architecture+or+architect" title="Forums">Forums</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/applicationbuilder" title="ISV">ISV</a>
-
- </li>
- <li class="inactive">
- <a href="https://www.microsoft.com/bizspark" title="Startups">Startups</a>
-
- </li>
- <li class="inactive">
- <a href="https://rewards.msdn.microsoft.com/" title="TechRewards">TechRewards</a>
-
- </li>
- <li class="inactive">
- <a href="http://events.msdn.microsoft.com/" title="Events">Events</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Community">Community</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/magazine/dd767791" title="Magazine">Magazine</a>
-
- </li>
- <li class="inactive">
- <a href="https://social.msdn.microsoft.com/forums/" title="Forums">Forums</a>
-
- </li>
- <li class="inactive">
- <a href="http://blogs.msdn.com/b/developer-tools/" title="Blogs">Blogs</a>
-
- </li>
- <li class="inactive">
- <a href="http://tech-advisors.msdn.microsoft.com/en-us" title="Tech Advisors">Tech Advisors</a>
-
- </li>
- <li class="inactive">
- <a href="http://channel9.msdn.com/" title="Channel 9">Channel 9</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive current toggle">
- <a href="javascript:void(0)" title="Documentation">Documentation</a>
- <ul class="navL2">
- <li class="inactive current">
- <a href="https://msdn.microsoft.com/library" title="APIs and reference">APIs and reference</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/developer-centers-msdn" title="Dev centers">Dev centers</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive">
- <a href="https://code.msdn.microsoft.com/" title="Samples">Samples</a>
- </li>
- </ul>
- </nav>
- </div>
- </div>
- </div>
- <div class="right">
- <div data-fragmentname="SearchBox" id="Fragment_SearchBox" xmlns="http://www.w3.org/1999/xhtml">
- <div class="SearchBox">
- <form id="HeaderSearchForm" name="HeaderSearchForm" method="get">
- <button id="FakeHeaderSearchButton" value="Search" type="submit" class="header-search-button">
- <div id="search-finder" class="search-finder"></div>
- </button>
- <button id="HeaderSearchButton" style="display:none"></button>
- <div id="searchSplitter"></div>
- <div id="searchCloseIcon" class="search-clear-x"></div>
- <div id="searchTextContainer" style="width: 0;">
- <input id="HeaderSearchTextBox" name="query" type="text" maxlength="200" onfocus="Epx.Controls.SearchBox.watermarkFocus(event, this.title)" onblur="Epx.Controls.SearchBox.watermarkBlur(event, this.title)">
- </div>
- </form>
-
-
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- </header>
- </div>
-
-
-
- <div class="printExportMenus ltr">
- <a id="isd_printABook" href="http://msdn.microsoft.com/en-us/library/export/help/(d=printer)?returnurl=%2fen-us%2flibrary%2fhh439648(d%3dprinter,v%3dvs.85).aspx%3flan%3dcsharp%26cc%3dn%26trm%3dtra%26view%3dbook">
- Export (<span class="count">0</span>)
- </a>
- <a id="isd_print" href="https://msdn.microsoft.com/en-us/library/hh439648(d=printer,v=vs.85).aspx?lan=csharp&cc=n&trm=tra&view=book" rel="nofollow">
- Print
- </a>
- <a id="isd_archiveControl" style="display:none;" data-include-archive="Include Previous Version" data-exclude-archive="Exclude Previous Version">
- </a>
- </div>
-
- <div class="printExportMenus ltr">
- <a id="expandCollapseAll" accesskey="e" href="javascript:void(0)" title="Expand/Collapse all sections by pressing Ctrl + Shift + e">Expand All</a>
- </div>
-
- <div id="body" ms.pgarea="body">
- <span id="tabletView_large"></span>
- <span id="tabletView_small"></span>
- <span id="mobileView"></span>
-
- <div id="content" class="content">
- <input type="hidden" id="printForPab" value="true">
-
- <div class="topic" xmlns="http://www.w3.org/1999/xhtml">
- <h1 class="title">Virtual address spaces</h1>
-
- <div id="mainSection">
- <div class="clsServerSDKContent">
- </div>
- <p>When a processor reads or writes to a memory location, it uses a virtual address. As part of the read or write operation, the processor translates the virtual address to a physical address. Accessing memory through a virtual address has these advantages:</p>
- <ul>
- <li>
- <p>A program can use a contiguous range of virtual addresses to access a large memory buffer that is not contiguous in physical memory.</p>
- </li>
- <li>
- <p> A program can use a range of virtual addresses to access a memory buffer that is larger than the available physical memory. As the supply of physical memory becomes small, the memory manager saves pages of physical memory (typically 4 kilobytes in size) to a disk file. Pages of data or code are moved between physical memory and the disk as needed.</p>
- </li>
- <li>
- <p>The virtual addresses used by different processes are isolated from each other. The code in one process cannot alter the physical memory that is being used by another process or the operating system.</p>
- </li>
- </ul>
- <p>The range of virtual addresses that is available to a process is called the <em>virtual address space</em> for the process. Each user-mode process has its own private virtual address space.
- For a 32-bit process, the virtual address space is usually the 2-gigabyte range 0x00000000 through 0x7FFFFFFF. For a 64-bit process, the virtual address space is the 8-terabyte range 0x000'00000000 through 0x7FF'FFFFFFFF. A range of virtual addresses is sometimes called a range of <em>virtual memory</em>.</p>
- <p>This diagram illustrates some of the key features of virtual address spaces.</p><img id="virtualaddressspace01" alt="Diagram of virtual address spaces for two processes" src="./Windows Kernel Development Articles (2016-03-30)_files/IC535110.png" title="Diagram of virtual address spaces for two processes" xmlns=""><p>The diagram shows the virtual address spaces for two 64-bit processes: Notepad.exe and MyApp.exe. Each process has its own virtual address space that goes from 0x000'0000000 through 0x7FF'FFFFFFFF. Each shaded block represents one page (4 kilobytes in size) of virtual or physical memory. Notice that the Notepad process uses three contiguous pages of virtual addresses, starting at 0x7F7'93950000. But those three contiguous pages of virtual addresses are mapped to noncontiguous pages in physical memory. Also notice that both processes use a page of virtual memory beginning at 0x7F7'93950000, but those virtual pages are mapped to different pages of physical memory.</p>
- <h2><a id="User_space_and_system_space"></a><a id="user_space_and_system_space"></a><a id="USER_SPACE_AND_SYSTEM_SPACE"></a>User space and system space</h2>
- <p>Processes like Notepad.exe and MyApp.exe run in user mode. Core operating system components and many drivers run in the more privileged kernel mode. For more information about processor modes, see <a href="https://msdn.microsoft.com/en-us/library/ff554836(v=vs.85).aspx">User mode and kernel mode</a>. Each user-mode process has its own private virtual address space, but all code that runs in kernel mode shares a single virtual address space called <em>system space</em>. The virtual address space for the current user-mode process is called <em>user space</em>.</p>
- <p>In 32-bit Windows, the total available virtual address space is 2^32 bytes (4 gigabytes). Usually the lower 2 gigabytes are used for user space, and the upper 2 gigabytes are used for system space.</p><img id="VirtualAddressSpace02" alt="Diagram of system space" src="./Windows Kernel Development Articles (2016-03-30)_files/IC535111.png" title="Diagram of system space" xmlns=""><p>In 32-bit Windows, you have the option of specifying (at boot time) that more than 2 gigabytes are available for user space. The consequence is that fewer virtual addresses are available for system space. You can increase the size of user space to as much as 3 gigabytes, in which case only 1 gigabyte is available for system space. To increase the size of user space, use <a href="https://msdn.microsoft.com/en-us/library/ff542202(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">BCDEdit /set increaseuserva</strong></a>.</p>
- <p>In 64-bit Windows, the theoretical amount of virtual address space is 2^64 bytes (16 exabytes), but only a small portion of the 16-exabyte range is actually used. The 8-terabyte range from 0x000'00000000 through 0x7FF'FFFFFFFF is used for user space, and portions of the 248-terabyte range from 0xFFFF0800'00000000 through 0xFFFFFFFF'FFFFFFFF are used for system space.</p><img id="VirtualAddressSpace03" alt="Diagram of paged pool and nonpaged pool" src="./Windows Kernel Development Articles (2016-03-30)_files/IC535112.png" title="Diagram of paged pool and nonpaged pool" xmlns=""><p>Code running in user mode has access to user space but does not have access to system space. This restriction prevents user-mode code from reading or altering protected operating system data structures. Code running in kernel mode has access to both user space and system space. That is, code running in kernel mode has access to system space and the virtual address space of the current user-mode process.</p>
- <p>Drivers that run in kernel mode must be very careful about directly reading from or writing to addresses in user space. This scenario illustrates why.</p>
- <ol>
- <li>
- <p>A user-mode program initiates a request to read some data from a device. The program supplies the starting address of a buffer to receive the data.</p>
- </li>
- <li>
- <p>A device driver routine, running in kernel mode, starts the read operation and returns control to its caller.</p>
- </li>
- <li>Later the device interrupts whatever thread is currently running to say that the read operation is complete. The interrupt is handled by kernel-mode driver routines running on this arbitrary thread, which belongs to an arbitrary process.</li>
- <li>At this point, the driver must not write the data to the starting address that the user-mode program supplied in Step 1. This address is in the virtual address space of the process that initiated the request, which is most likely not the same as the current process.</li>
- </ol>
- <h2><a id="Paged_pool_and_Nonpaged_pool"></a><a id="paged_pool_and_nonpaged_pool"></a><a id="PAGED_POOL_AND_NONPAGED_POOL"></a>Paged pool and Nonpaged pool</h2>
- <p>In user space, all physical memory pages can be paged out to a disk file as needed. In system space, some physical pages can be paged out and others cannot. System space has two regions for dynamically allocating memory: paged pool and nonpaged pool. In 64-bit Windows, paged pool is the 128-gigabyte range of virtual addresses that goes from 0xFFFFA800'00000000 through 0xFFFFA81F'FFFFFFFF. Nonpaged pool is the 128-gigabyte range of virtual addresses that goes from 0xFFFFAC00'00000000 through 0xFFFFAC1F'FFFFFFFF.</p>
- <p>Memory that is allocated in paged pool can be paged out to a disk file as needed. Memory that is allocated in nonpaged pool can never be paged out to a disk file.</p><img id="VirtualAddressSpace04" alt="Diagram comparing memory allocation in paged pool to that in nonpaged pool" src="./Windows Kernel Development Articles (2016-03-30)_files/IC535113.png" title="Diagram comparing memory allocation in paged pool to that in nonpaged pool" xmlns=""><h2><a id="related_topics"></a>Related topics</h2>
- <dl>
- <dt>
- <a href="https://msdn.microsoft.com/en-us/library/ff554836(v=vs.85).aspx">User mode and kernel mode</a>
- </dt>
- </dl>
- <p> </p>
- <p> </p>
- <p><a href="mailto:wsddocfb@microsoft.com?subject=Documentation%20feedback%20[wdkgetstart\wdkgetstart]:%20Virtual%20address%20spaces%20%20RELEASE:%20(3/4/2016)&body=%0A%0APRIVACY%20STATEMENT%0A%0AWe%20use%20your%20feedback%20to%20improve%20the%20documentation.%20We%20don%27t%20use%20your%20email%20address%20for%20any%20other%20purpose,%20and%20we%27ll%20remove%20your%20email%20address%20from%20our%20system%20after%20the%20issue%20that%20you%27re%20reporting%20is%20fixed.%20While%20we%27re%20working%20to%20fix%20this%20issue,%20we%20might%20send%20you%20an%20email%20message%20to%20ask%20for%20more%20info.%20Later,%20we%20might%20also%20send%20you%20an%20email%20message%20to%20let%20you%20know%20that%20we%27ve%20addressed%20your%20feedback.%0A%0AFor%20more%20info%20about%20Microsoft%27s%20privacy%20policy,%20see%20http://privacy.microsoft.com/en-us/default.aspx." title="Send comments about this topic to Microsoft">Send comments about this topic to Microsoft</a></p>
- </div>
- </div>
-
- </div>
- </div>
- <div class="clear"></div>
-
- <input name="__RequestVerificationToken" type="hidden" value="YJvB6t-X6o5K9H-mdvkogj1GnkaPMpiAWMpAgkmBGjXM917nAqNtpYQdLzwZlURUt1SxknJuYD0Jb8rX9hAicDlm9n81">
- <input id="ratingValueSubmitUrl" type="hidden" value="https://msdn.microsoft.com/en-us/library/feedback/rate/hh439648(d=printer,v=vs.85).aspx">
- <input id="ratingAdditionalSubmitUrl" type="hidden" value="https://msdn.microsoft.com/en-us/library/feedback/additional/hh439648(d=printer,v=vs.85).aspx">
- <input id="isTopicRated" type="hidden" value="false">
- <div id="lib-footer" ms.pgarea="body">
-
-
- <link type="text/css" rel="stylesheet">
-
- <div id="ux-footer" class="" style="" dir="ltr">
-
- <div id="footerSock" class="librarySock both">
- <div id="footerSockInner">
- <a name="feedback"></a>
- <div class="rating">
- <div id="ratingSection1">
- <div class="title">
- Was this page helpful?
- </div>
- <div class="description">
- Your feedback about this content is important.<br>Let us know what you think.
- </div>
- <div class="buttons">
- <button class="button" id="ratingYes" aria-label="Yes, this page was helpful">Yes</button>
- <button class="button" id="ratingNo" aria-label="No, this page was not helpful">No</button>
- </div>
- <input id="ratingValue" type="hidden" value="">
- </div>
- <div id="ratingSection2">
- <div class="title left">
- Additional feedback?
- </div>
- <textarea id="ratingText" rows="6" cols="" maxlength="1500"></textarea>
- <div class="right">
- <div class="counter">
- <span id="feedbackTextCounter">1500</span> characters remaining
- </div>
- <div class="buttons">
- <button class="button" id="ratingSubmit" aria-label="Submit my additional feedback">Submit</button>
- <button class="button" id="ratingSkipThis" aria-label="Skip additional feedback">Skip this</button>
- </div>
- </div>
- </div>
- <div id="ratingSection3">
- <div class="title">
- Thank you!
- </div>
- <div class="description">
- We appreciate your feedback.
- </div>
- </div>
-
-
- <div id="contentFeedbackQAContainer" style="display: none;"></div>
- </div>
-
- <div class="userVoice">
- <div class="title">
- Help us improve MSDN.
- </div>
- <div class="description">
- Visit our UserVoice Page to submit and vote on ideas!
- </div>
- <div class="buttons">
- <a class="button" id="userVoiceButton" href="http://feedback.msdn.com/forums/257782-msdn-feature-suggestions/category/83975" target="_blank">Make a suggestion</a>
- </div>
- </div>
- <div class="clear"></div>
- </div>
- </div>
- <footer class="top">
- <div data-fragmentname="LeftLinks" id="Fragment_LeftLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Dev centers</div>
- <ul class="links">
- <li>
- <a href="https://dev.windows.com/" id="LeftLinks_2148_1" class="windowsBlue" xmlns="http://www.w3.org/1999/xhtml">Windows</a>
- </li>
- <li>
- <a href="http://dev.office.com/" id="LeftLinks_2148_3" class="office" xmlns="http://www.w3.org/1999/xhtml">Office</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/vstudio" id="LeftLinks_2148_4" class="visualStudio" xmlns="http://www.w3.org/1999/xhtml">Visual Studio</a>
- </li>
- <li>
- <a href="http://azure.microsoft.com/en-us/documentation/" target="_blank" id="LeftLinks_2148_12" xmlns="http://www.w3.org/1999/xhtml">Microsoft Azure</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/developer-centers-msdn" id="LeftLinks_2148_5" xmlns="http://www.w3.org/1999/xhtml">More...</a>
- </li>
- </ul>
- </div>
- </div>
- <div id="rightLinks">
- <div data-fragmentname="CenterLinks1" id="Fragment_CenterLinks1" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Learning resources</div>
- <ul class="links">
- <li>
- <a href="http://www.microsoftvirtualacademy.com/" id="CenterLinks1_2151_4" xmlns="http://www.w3.org/1999/xhtml">Microsoft Virtual Academy</a>
- </li>
- <li>
- <a href="http://channel9.msdn.com/" id="CenterLinks1_2151_5" xmlns="http://www.w3.org/1999/xhtml">Channel 9</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/magazine/" id="CenterLinks1_2151_7" xmlns="http://www.w3.org/1999/xhtml">MSDN Magazine</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks2" id="Fragment_CenterLinks2" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Community</div>
- <ul class="links">
- <li>
- <a href="https://social.msdn.microsoft.com/forums/en-us/home" id="CenterLinks2_2151_8" xmlns="http://www.w3.org/1999/xhtml">Forums</a>
- </li>
- <li>
- <a href="http://blogs.msdn.com/b/developer-tools/" id="CenterLinks2_2151_9" xmlns="http://www.w3.org/1999/xhtml">Blogs</a>
- </li>
- <li>
- <a href="http://www.codeplex.com/" id="CenterLinks2_2151_10" xmlns="http://www.w3.org/1999/xhtml">Codeplex</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks3" id="Fragment_CenterLinks3" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Support</div>
- <ul class="links">
- <li>
- <a href="https://msdn.microsoft.com/hh361695" id="CenterLinks3_2151_11" xmlns="http://www.w3.org/1999/xhtml">Self support</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks4" id="Fragment_CenterLinks4" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Programs</div>
- <ul class="links">
- <li>
- <a href="https://www.microsoft.com/bizspark/" id="CenterLinks4_2151_13" xmlns="http://www.w3.org/1999/xhtml">BizSpark (for startups)</a>
- </li>
- <li>
- <a href="https://www.dreamspark.com/" id="CenterLinks4_2151_14" xmlns="http://www.w3.org/1999/xhtml">DreamSpark</a>
- </li>
- <li>
- <a href="http://www.imaginecup.com/" id="CenterLinks4_2151_17" xmlns="http://www.w3.org/1999/xhtml">Imagine Cup</a>
- </li>
- </ul>
- </div>
- </div>
- </div>
- </footer>
- <footer class="bottom">
- <span class="localeContainer">
-
- <form class="selectLocale" id="selectLocaleForm" action="https://msdn.microsoft.com/en-us/selectlocale-dmc">
- <input type="hidden" name="fromPage" value="https%3a%2f%2fmsdn.microsoft.com%2fen-us%2flibrary%2fhh439648(d%3dprinter%2cv%3dvs.85).aspx%3flan%3dCSharp%26cc%3dn%26trm%3dtra%26view%3dbook">
- <a href="http://msdn.microsoft.com/#" onclick="$('#selectLocaleForm').submit();return false;" title="Change your language">United States (English)</a>
- </form>
- </span>
- <div data-fragmentname="BottomLinks" id="Fragment_BottomLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <ul class="links horizontal">
- <li>
- <a href="https://msdn.microsoft.com/newsletter.aspx" id="BottomLinks_2148_7" xmlns="http://www.w3.org/1999/xhtml">Newsletter</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/dn529288" id="BottomLinks_2148_8" xmlns="http://www.w3.org/1999/xhtml">Privacy & cookies</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/cc300389" id="BottomLinks_2148_9" xmlns="http://www.w3.org/1999/xhtml">Terms of use</a>
- </li>
- <li>
- <a href="https://www.microsoft.com/en-us/legal/intellectualproperty/Trademarks/EN-US.aspx" id="BottomLinks_2148_10" xmlns="http://www.w3.org/1999/xhtml">Trademarks</a>
- </li>
- </ul>
- </div>
- </div>
- <span class="logoLegal">
- <span class="logo"></span>
- <span class="copyright">© 2016 Microsoft</span>
- </span>
- </footer>
- </div>
-
- </div>
- <div class="footerPrintView">
- <div class="footerCopyrightPrintView">© 2016 Microsoft</div>
- </div>
-
-
-
-
- <input id="tocPaddingPerLevel" type="hidden" value="17">
- <input id="MtpsDevice" type="hidden" value="Printer">
- <!--[CDATA[ Third party scripts and code linked to or referenced from this website are licensed to you by the parties that own such code, not by Microsoft. See ASP.NET Ajax CDN Terms of Use – http://www.asp.net/ajaxlibrary/CDN.ashx. ]]-->
-
-
-
-
-
- <noscript><div><img alt="DCSIMG" id="Img1" width="1" height="1" src="https://m.webtrends.com/dcsmgru7m99k7mqmgrhudo0k8_8c6m/njs.gif?dcsuri=/nojavascript&amp;WT.js=No" /></div></noscript>
- <div id="globalRequestVerification">
- <input name="__RequestVerificationToken" type="hidden" value="cAa61Ys8haZc-sNlfiSoESGwIaQN00zm3WZ3tipZ4A1WFduFuqMNc7DulQz41eAbl71fkqEo7sVNQS6xbbJ3rKwxn8w1">
- </div>
- </div>
-
-
-
-
-
-
- <script type="text/javascript" class="mtps-injected">
- /*<![CDATA[*/
- (function(window,document){"use strict";function preload(scripts){for(var result=[],script,e,i=0;i<scripts.length;i++)script=scripts[i],script.hasOwnProperty("url")&&(e=document.createElement("script"),e.src=script.url,script.throwaway=e),result.push(script);return result}function inject(scripts,index){var script,elem;if(index>=scripts.length){delete mtps.injectScripts;return}script=scripts[index];elem=document.createElement("script");elem.className="mtps-injected";elem.async=!1;var isLoaded=!1,timeoutId=0,injectNextFnName="",injectNext=elem.onerror=function(){isLoaded||(isLoaded=!0,inject(scripts,index+1),window.clearTimeout(timeoutId),elem.onload=elem.onerror=elem.onreadystatechange=null,injectNextFnName&&delete mtps[injectNextFnName],elem.removeEventListener&&elem.removeEventListener("load",injectNext,!1))};elem.addEventListener?elem.addEventListener("load",injectNext,!1):elem.readyState==="uninitialized"?elem.onreadystatechange=function(){(this.readyState==="loaded"||this.readyState==="complete")&&injectNext()}:elem.onload=injectNext;script.hasOwnProperty("url")?(timeoutId=window.setTimeout(injectNext,12e4),elem.src=script.url):(injectNextFnName="_injectNextScript_"+index,mtps[injectNextFnName]=injectNext,timeoutId=window.setTimeout(injectNext,2e3),elem.text="try {\n"+script.txt+"\n} finally { MTPS."+injectNextFnName+" && MTPS."+injectNextFnName+"(); }");parent.appendChild(elem)}var mtps=window.MTPS||(window.MTPS={}),parent=document.getElementsByTagName("head")[0];mtps.injectScripts=function(scripts){inject(preload(scripts),0)}})(window,document);
- MTPS.injectScripts([
- { txt: "/**/\r\n(window.MTPS || (window.MTPS = {})).cdnDomains || (window.MTPS.cdnDomains = { \r\n\t\"image\": \"https://i-msdn.sec.s-msft.com\", \r\n\t\"js\": \"https://i2-msdn.sec.s-msft.com\", \r\n\t\"css\": \"https://i-msdn.sec.s-msft.com\", \r\n\t\"ttf\": \"https://i-msdn.sec.s-msft.com\"\r\n});\r\n/**/" },
- { txt: "//\n var literalNormalizedUrl = \u0027/en-us/library/hh439648(d=printer,l=en-us,v=vs.85).aspx\u0027;\n var wt_nvr_ru = \u0027WT_NVR_RU\u0027;\n var wt_fpcdom = \u0027.microsoft.com\u0027;\n var wt_domlist = \u0027msdn.microsoft.com\u0027;\n var wt_pathlist = \u0027\u0027;\n var wt_paramlist = \u0027DCSext.mtps_devcenter\u0027;\n var wt_siteid = \u0027MSDN\u0027;\n var gDomain = \u0027m.webtrends.com\u0027;\n var gDcsId = \u0027dcsmgru7m99k7mqmgrhudo0k8_8c6m\u0027;\n var gFpc = \u0027WT_FPC\u0027;\n\n\n\n if (document.cookie.indexOf(gFpc + \"=\") == -1) {\n var wtidJs = document.createElement(\"script\");\n wtidJs.src = \"//\" + gDomain + \"/\" + gDcsId + \"/wtid.js\";\n document.getElementsByTagName(\"head\")[0].appendChild(wtidJs);\n }\n\n\n\n var detectedLocale = \u0027en-us\u0027;\n var wtsp = \u0027msdnlib_w32_com\u0027;\n var gTrackEvents = \u00270\u0027;\n/**/" },
- { txt: "//\n\n window.appInsightsId = \u00275eb1b2eb-c47a-497a-a7ac-a1c230b2882f\u0027;\n //" },
- { url: "https://i2-msdn.sec.s-msft.com/Combined.js?resources=0:Utilities,1:Layout,2:Header,1:Rating,2:Footer,0:Topic,3:PabTopic,4:webtrendsscript,0:AppInsightsPerf,0:ABTestControl,5:WEDCS,3:CmpgrpForHeader,0:livefyre,0:Comment,1:SearchBox;/Areas/Epx/Content/Scripts:0,/Areas/Epx/Themes/Base/Content:1,/Areas/Centers/Themes/StandardDevCenter/Content:2,/Areas/Library/Content:3,/Areas/Global/Content/Webtrends/resources:4,/Areas/Library/Themes/Base/Content:5\u0026amp;hashKey=30CEE944AABFEA2C5A338BDB9E000732\u0026amp;v=AE608271C0243AAA0449D3BC0FAD8EB4" },
- { url: "https://i1.services.social.microsoft.com/search/Widgets/SearchBox.jss?boxid=HeaderSearchTextBox\u0026btnid=HeaderSearchButton\u0026pgArea=header\u0026brand=Msdn\u0026loc=en-us\u0026focusOnInit=false\u0026emptyWatermark=true\u0026searchButtonTooltip=Search MSDN" },
- { url: "https://i2-msdn.sec.s-msft.com/Combined.js?resources=0:PrintExportButton,1:Toc_Fixed,1:CodeSnippet,1:TopicNotInScope,1:CollapsibleArea,1:VersionSelector,1:SurveyBroker;/Areas/Library/Themes/Base/Content:0,/Areas/Epx/Content/Scripts:1\u0026amp;hashKey=80F30894E3FB8A3295C923AEC7019CFE\u0026amp;v=AE608271C0243AAA0449D3BC0FAD8EB4" },
- { txt: "$(document).ready(function() {\n try {\n var token = $(\"#globalRequestVerification input[name=\u0027__RequestVerificationToken\u0027]\").clone();\n $(\"#siteFeedbackForm\").append(token);\n } catch(err) {\n \n }\n });" }
- ]);
- /*]]>*/
- </script>
- <link rel="stylesheet" type="text/css" href="./Windows Kernel Development Articles (2016-03-30)_files/Combined.css">
- <div id="page">
-
-
-
-
- <link type="text/css" rel="stylesheet">
-
- <input type="hidden" id="isHeaderBleeding" value="true">
- <div id="ux-header" dir="ltr" class="ltr msdn">
-
- <header>
- <span id="singleCol"></span>
- <span id="doubleCol"></span>
- <span id="isMobile"></span>
- <div>
- <div class="row topRow">
- <div class="top">
- <div class="left">
- <a class="msdnLogoImg" href="https://msdn.microsoft.com/en-us" title="MSDN home">
- <div id="msft-logo" class="msft-logo"></div>
- </a>
- <div class="GrayPipe"></div>
- <a class="DevCenterFullNameNonMegaBlade" href="https://msdn.microsoft.com/en-us">Developer Network</a>
- <a class="DevCenterFullName" href="https://msdn.microsoft.com/en-us">Developer Network</a>
- <a class="DevCenterShortName" href="https://msdn.microsoft.com/en-us">Developer</a>
- </div>
- <div class="right">
- <div id="signIn">
- <div class="profileImage"></div>
- <a class="scarabLink" href="https://login.live.com/login.srf?wa=wsignin1.0&rpsnv=12&ct=1459376405&rver=6.0.5276.0&wp=mcmbi&wlcxt=msdn%24msdn%24msdn&wreply=https%3a%2f%2fmsdn.microsoft.com%2fen-us%2flibrary%2fff554721%2528d%3dprinter%2cv%3dvs.85%2529.aspx%3flan%3dcsharp%26cc%3dn%26trm%3dtra%26view%3dbook&lc=1033&id=254354&mkt=en-us" title="Sign in">Sign in</a></div>
- <div class="auxNav">
- <div>
- <div data-fragmentname="Subscriptions" id="Fragment_Subscriptions" xmlns="http://www.w3.org/1999/xhtml">
- <a href="https://msdn.microsoft.com/subscriptions/manage/hh442900" id="Subscriptions_2153_1" xmlns="http://www.w3.org/1999/xhtml">MSDN subscriptions</a>
- </div>
- <div data-fragmentname="GetTools" id="Fragment_GetTools" xmlns="http://www.w3.org/1999/xhtml">
- <a href="http://go.microsoft.com/fwlink/?LinkId=309297&clcid=0x409&slcid=0x409&campaign=o~msft~msdn~gettools-header~dn308572" id="GetTools_2153_3" xmlns="http://www.w3.org/1999/xhtml">Get tools</a>
- </div>
- </div>
- <div>
- <div data-fragmentname="SocialLinks" id="Fragment_SocialLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <ul class="links horizontal">
- <li>
- <a href="http://www.facebook.com/microsoftdeveloper" target="_blank" id="SocialLinks_2152_4" class="facebook" xmlns="http://www.w3.org/1999/xhtml">http://www.facebook.com/microsoftdeveloper</a>
- </li>
- <li>
- <a href="https://twitter.com/msdev" target="_blank" id="SocialLinks_2152_5" class="twitter" xmlns="http://www.w3.org/1999/xhtml">https://twitter.com/msdev</a>
- </li>
- <li>
- <a href="http://plus.google.com/111221966647232053570/" target="_blank" id="SocialLinks_2152_6" class="googlePlus" xmlns="http://www.w3.org/1999/xhtml">http://plus.google.com/111221966647232053570/</a>
- </li>
- </ul>
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- <div class="row middleRow">
- <div class="expandTop">
- <div class="left"></div>
- <div class="right"></div>
- </div>
- </div>
- </div>
- <div id="buttomRowWrapper" class="bg_default">
- <div class="row buttomRow bg_default">
- <div class="bottom">
- <div class="left">
- <a id="grip" class="menu-icon" href="javascript:void(0)"></a>
-
- <div id="drawer">
- <div class="toc">
-
- <nav>
- <ul class="navL1">
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Technologies">Technologies</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/cloud-app-development-msdn" title="Cloud">Cloud</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/app-development-msdn" title="App Development">App Development</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/web-app-development-msdn" title="Web">Web</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/big-data-development-msdn" title="Data">Data</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/games-development-msdn" title="Gaming">Gaming</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/internetofthings" title="Internet of Things">Internet of Things</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Downloads">Downloads</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://www.visualstudio.com/downloads/download-visual-studio-vs" title="Visual Studio">Visual Studio</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/subscriptions" title="MSDN subscription access">MSDN subscription access</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/microsoft-sdks-msdn" title="SDKs">SDKs</a>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Trial software">Trial software</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/evalcenter" title="Free downloads">Free downloads</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/officeevaluationresources" title="Office resources">Office resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/sharepoint2013resources" title="SharePoint Server 2013 resources">SharePoint Server 2013 resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/sqlserver2014expressresources" title="SQL Server 2014 Express resources">SQL Server 2014 Express resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/windowsserver2012r2resources" title="Windows Server 2012 resources">Windows Server 2012 resources</a>
- </li>
- </ul>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Programs">Programs</a>
- <ul class="navL2">
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Visual Studio subscriptions">Visual Studio subscriptions</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/msdn-subscriptions-overview" title="Overview">Overview</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/benefits-overview" title="Benefits">Benefits</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/msdn-subscriptions-administration" title="Administrators">Administrators</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Students">Students</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/imagine/imagine-home" title="Microsoft Imagine">Microsoft Imagine</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/microsoftstudentpartners" title="Microsoft Student Partners">Microsoft Student Partners</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Architects">Architects</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-overview-msdn" title="Overview">Overview</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-case-studies-msdn" title="Case studies">Case studies</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-blueprints-msdn" title="Blueprints">Blueprints</a>
- </li>
- <li class="inactive">
- <a href="http://blogs.msdn.com/b/msarchitecture/" title="Blog">Blog</a>
- </li>
- <li class="inactive">
- <a href="http://social.msdn.microsoft.com/forums/en-us/home?brandignore=true&sort=relevancedesc&searchterm=architecture+or+architect" title="Forums">Forums</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/applicationbuilder" title="ISV">ISV</a>
-
- </li>
- <li class="inactive">
- <a href="https://www.microsoft.com/bizspark" title="Startups">Startups</a>
-
- </li>
- <li class="inactive">
- <a href="https://rewards.msdn.microsoft.com/" title="TechRewards">TechRewards</a>
-
- </li>
- <li class="inactive">
- <a href="http://events.msdn.microsoft.com/" title="Events">Events</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Community">Community</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/magazine/dd767791" title="Magazine">Magazine</a>
-
- </li>
- <li class="inactive">
- <a href="https://social.msdn.microsoft.com/forums/" title="Forums">Forums</a>
-
- </li>
- <li class="inactive">
- <a href="http://blogs.msdn.com/b/developer-tools/" title="Blogs">Blogs</a>
-
- </li>
- <li class="inactive">
- <a href="http://tech-advisors.msdn.microsoft.com/en-us" title="Tech Advisors">Tech Advisors</a>
-
- </li>
- <li class="inactive">
- <a href="http://channel9.msdn.com/" title="Channel 9">Channel 9</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive current toggle">
- <a href="javascript:void(0)" title="Documentation">Documentation</a>
- <ul class="navL2">
- <li class="inactive current">
- <a href="https://msdn.microsoft.com/library" title="APIs and reference">APIs and reference</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/developer-centers-msdn" title="Dev centers">Dev centers</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive">
- <a href="https://code.msdn.microsoft.com/" title="Samples">Samples</a>
- </li>
- </ul>
- </nav>
- </div>
- </div>
- </div>
- <div class="right">
- <div data-fragmentname="SearchBox" id="Fragment_SearchBox" xmlns="http://www.w3.org/1999/xhtml">
- <div class="SearchBox">
- <form id="HeaderSearchForm" name="HeaderSearchForm" method="get">
- <button id="FakeHeaderSearchButton" value="Search" type="submit" class="header-search-button">
- <div id="search-finder" class="search-finder"></div>
- </button>
- <button id="HeaderSearchButton" style="display:none"></button>
- <div id="searchSplitter"></div>
- <div id="searchCloseIcon" class="search-clear-x"></div>
- <div id="searchTextContainer" style="width: 0;">
- <input id="HeaderSearchTextBox" name="query" type="text" maxlength="200" onfocus="Epx.Controls.SearchBox.watermarkFocus(event, this.title)" onblur="Epx.Controls.SearchBox.watermarkBlur(event, this.title)">
- </div>
- </form>
-
-
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- </header>
- </div>
-
-
-
- <div class="printExportMenus ltr">
- <a id="isd_printABook" href="http://msdn.microsoft.com/en-us/library/export/help/(d=printer)?returnurl=%2fen-us%2flibrary%2fff554721(d%3dprinter,v%3dvs.85).aspx%3flan%3dcsharp%26cc%3dn%26trm%3dtra%26view%3dbook">
- Export (<span class="count">0</span>)
- </a>
- <a id="isd_print" href="https://msdn.microsoft.com/en-us/library/ff554721(d=printer,v=vs.85).aspx?lan=csharp&cc=n&trm=tra&view=book" rel="nofollow">
- Print
- </a>
- <a id="isd_archiveControl" style="display:none;" data-include-archive="Include Previous Version" data-exclude-archive="Exclude Previous Version">
- </a>
- </div>
-
- <div class="printExportMenus ltr">
- <a id="expandCollapseAll" accesskey="e" href="javascript:void(0)" title="Expand/Collapse all sections by pressing Ctrl + Shift + e">Expand All</a>
- </div>
-
- <div id="body" ms.pgarea="body">
- <span id="tabletView_large"></span>
- <span id="tabletView_small"></span>
- <span id="mobileView"></span>
-
- <div id="content" class="content">
- <input type="hidden" id="printForPab" value="true">
-
- <div class="topic" xmlns="http://www.w3.org/1999/xhtml">
- <h1 class="title">Device nodes and device stacks</h1>
-
- <div id="mainSection">
- <div class="clsServerSDKContent">
- </div>
- <p>
- </p><p>In Windows, devices are represented by device nodes in the Plug and Play (PnP) device tree. Typically, when an I/O request is sent to a device, several drivers help handle the request. Each of these drivers is associated with a device object, and the device objects are arranged in a stack. The sequence of device objects along with their associated drivers is called a device stack. Each device node has its own device stack.</p>
- <h2><a id="Device_nodes_and_the_Plug_and_Play_device_tree"></a><a id="device_nodes_and_the_plug_and_play_device_tree"></a><a id="DEVICE_NODES_AND_THE_PLUG_AND_PLAY_DEVICE_TREE"></a>Device nodes and the Plug and Play device tree</h2>
- <p>Windows organizes devices in a tree structure called the <em>Plug and Play device tree</em>, or simply the <em>device tree</em>. Typically, a node in the device tree represents either a device or an individual function on a composite device. However, some nodes represent software components that have no association with physical devices.</p>
- <p>A node in the device tree is called a <em>device node</em>. The root node of the device tree is called the <em>root device node</em>. By convention, the root device node is drawn at the bottom of the device tree, as shown in the following diagram. </p><img id="DeviceTree01" alt="Diagram of the device tree, showing device nodes" src="./Windows Kernel Development Articles (2016-03-30)_files/IC559043.png" title="Diagram of the device tree, showing device nodes" xmlns=""><p>The device tree illustrates the parent/child relationships that are inherent in the PnP environment. Several of the nodes in the device tree represent buses that have child devices connected to them. For example, the PCI Bus node represents the physical PCI bus on the motherboard. During startup, the PnP manager asks the PCI bus driver to enumerate the devices that are connected to the PCI bus. Those devices are represented by child nodes of the PCI Bus node. In the preceding diagram, the PCI Bus node has child nodes for several devices that are connected to the PCI bus, including USB host controllers, an audio controller, and a PCI Express port.</p>
- <p>Some of the devices connected to the PCI bus are buses themselves. The PnP manager asks each of these buses to enumerate the devices that are connected to it. In the preceding diagram, we can see that the audio controller is a bus that has an audio device connected to it. We can see that the PCI Express port is a bus that has a display adapter connected to it, and the display adapter is a bus that has one monitor connected to it.</p>
- <p>Whether you think of a node as representing a device or a bus depends on your point of view. For example, you can think of the display adapter as a device that plays a key role in preparing frames that appear on the screen. However, you can also think of the display adapter as a bus that is capable of detecting and enumerating connected monitors. </p>
- <h2><a id="Device_objects_and_device_stacks"></a><a id="device_objects_and_device_stacks"></a><a id="DEVICE_OBJECTS_AND_DEVICE_STACKS"></a>Device objects and device stacks</h2>
- <p>A <em>device object</em> is an instance of a <a href="https://msdn.microsoft.com/en-us/library/ff543147(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">DEVICE_OBJECT</strong></a> structure. Each device node in the PnP device tree has an ordered list of device objects, and each of these device objects is associated with a driver. The ordered list of device objects, along with their associated drivers, is called the <em>device stack</em> for the device node.</p>
- <p>You can think of a device stack in several ways. In the most formal sense, a device stack is an ordered list of (device object, driver) pairs. However, in certain contexts it might be useful to think of the device stack as an ordered list of device objects. In other contexts, it might be useful to think of the device stack as an ordered list of drivers.</p>
- <p>By convention, a device stack has a top and a bottom. The first device object to be created in the device stack is at the bottom, and the last device object to be created and attached to the device stack is at the top.</p>
- <p>In the following diagram, the Proseware Gizmo device node has a device stack that contains three (device object, driver) pairs. The top device object is associated with the driver AfterThought.sys, the middle device object is associated with the driver Proseware.sys, and the bottom device object is associated with the driver Pci.sys. The PCI Bus node in the center of the diagram has a device stack that contains two (device object, driver) pairs--a device object associated with Pci.sys and a device object associated with Acpi.sys.</p><img id="prosewaredevicenode01" alt="Diagram showing device objects ordered in device stacks in the Proseware Gizmo and PCI device nodes" src="./Windows Kernel Development Articles (2016-03-30)_files/IC535098.png" title="Diagram showing device objects ordered in device stacks in the Proseware Gizmo and PCI device nodes" xmlns=""><h2><a id="How_does_a_device_stack_get_constructed_"></a><a id="how_does_a_device_stack_get_constructed_"></a><a id="HOW_DOES_A_DEVICE_STACK_GET_CONSTRUCTED_"></a>How does a device stack get constructed?</h2>
- <p>During startup, the PnP manager asks the driver for each bus to enumerate child devices that are connected to the bus. For example, the PnP manager asks the PCI bus driver (Pci.sys) to enumerate the devices that are connected to the PCI bus. In response to this request, Pci.sys creates a device object for each device that is connected to the PCI bus. Each of these device objects is called a <em>physical device object</em> (PDO). Shortly after Pci.sys creates the set of PDOs, the device tree looks like the one shown in the following diagram.</p><img id="prosewaredevicenode04" alt="Diagram of PCI node and physical device objects for child devices" src="./Windows Kernel Development Articles (2016-03-30)_files/IC559044.png" title="Diagram of PCI node and physical device objects for child devices" xmlns=""><p>The PnP manager associates a device node with each newly created PDO and looks in the registry to determine which drivers need to be part of the device stack for the node. The device stack must have one (and only one) <em>function driver</em> and can optionally have one or more <em>filter drivers</em>. The function driver is the main driver for the device stack and is responsible for handling read, write, and device control requests. Filter drivers play auxiliary roles in processing read, write, and device control requests. As each function and filter driver is loaded, it creates a device object and attaches itself to the device stack. A device object created by the function driver is called a <em>functional device object</em> (FDO), and a device object created by a filter driver is called a <em>filter device object</em> (Filter DO). Now the device tree looks something like this diagram.</p><img id="prosewaredevicenode02" alt="Diagram of a device tree showing the filter, function, and physical device objects in the Proseware Gizmo device node" src="./Windows Kernel Development Articles (2016-03-30)_files/IC559045.png" title="Diagram of a device tree showing the filter, function, and physical device objects in the Proseware Gizmo device node" xmlns=""><p>In the diagram, notice that in one node, the filter driver is above the function driver, and in the other node, the filter driver is below the function driver. A filter driver that is above the function driver in a device stack is called an <em>upper filter driver</em>. A filter driver that is below the function driver is called a <em>lower filter driver</em>.</p>
- <p>The PDO is always the bottom device object in a device stack. This results from the way a device stack is constructed. The PDO is created first, and as additional device objects are attached to the stack, they are attached to the top of the existing stack.</p>
- <div class="alert"><strong>Note</strong> <p class="note">When the drivers for a device are installed, the installer uses information in an information (INF) file to determine which driver is the function driver and which drivers are filters. Typically the INF file is provided either by Microsoft or by the hardware vendor. After the drivers for a device are installed, the PnP manager can determine the function and filter drivers for the device by looking in the registry.</p>
- <p class="note"></p>
- </div>
- <div> </div>
- <h2><a id="Bus_drivers"></a><a id="bus_drivers"></a><a id="BUS_DRIVERS"></a>Bus drivers</h2>
- <p>In the preceding diagram, you can see that the driver Pci.sys plays two roles. First, Pci.sys is associated with the FDO in the PCI Bus device node. In fact, it created the FDO in the PCI Bus device node. So Pci.sys is the function driver for the PCI bus. Second, Pci.sys is associated with the PDO in each child of the PCI Bus node. Recall that it created the PDOs for the child devices. The driver that creates the PDO for a device node is called the <em>bus driver</em> for the node.</p>
- <p>If your point of reference is the PCI bus, then Pci.sys is the function driver. But if your point of reference is the Proseware Gizmo device, then Pci.sys is the bus driver. This dual role is typical in the PnP device tree. A driver that serves as function driver for a bus also serves as bus driver for a child device of the bus.</p>
- <h2><a id="User-mode_device_stacks"></a><a id="user-mode_device_stacks"></a><a id="USER-MODE_DEVICE_STACKS"></a>User-mode device stacks</h2>
- <p>So far we've been discussing kernel-mode device stacks. That is, the drivers in the stacks run in kernel mode, and the device objects are mapped into system space, which is the address space that is available only to code running in kernel mode. For information about the difference between kernel mode and user mode, see <a href="https://msdn.microsoft.com/en-us/library/ff554836(v=vs.85).aspx">User mode and kernel mode</a>.</p>
- <p>In some cases, a device has a user-mode device stack in addition to its kernel-mode device stack. User-mode drivers are often based on the User-Mode Driver Framework (UMDF), which is one of the driver models provided by the <a href="https://msdn.microsoft.com/en-us/library/ff557565(v=vs.85).aspx">Windows Driver Frameworks (WDF)</a>. In UMDF, the drivers are user-mode DLLs, and the device objects are COM objects that implement the <a href="https://msdn.microsoft.com/en-us/library/ff556917(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">IWDFDevice</strong></a> interface. A device object in a UMDF device stack is called a <em>WDF device object</em> (WDF DO).</p>
- <p>The following diagram shows the device node, kernel-mode device stack, and the user-mode device stack for a USB-FX-2 device. The drivers in both the user-mode and kernel-mode stacks participate in I/O requests that are directed at the USB-FX-2 device.</p><img id="UserAndKernelDeviceStacks01" alt="Diagram showing user-mode and kernel-mode device stacks" src="./Windows Kernel Development Articles (2016-03-30)_files/IC535101.png" title="Diagram showing user-mode and kernel-mode device stacks" xmlns=""><h2><a id="related_topics"></a>Related topics</h2>
- <dl>
- <dt>
- <a href="https://msdn.microsoft.com/en-us/library/ff554731(v=vs.85).aspx">Concepts for all driver developers</a>
- </dt>
- <dt>
- <a href="https://msdn.microsoft.com/en-us/library/hh439632(v=vs.85).aspx">Driver stacks</a>
- </dt>
- </dl>
- <p> </p>
- <p> </p>
- <p><a href="mailto:wsddocfb@microsoft.com?subject=Documentation%20feedback%20[wdkgetstart\wdkgetstart]:%20Device%20nodes%20and%20device%20stacks%20%20RELEASE:%20(3/4/2016)&body=%0A%0APRIVACY%20STATEMENT%0A%0AWe%20use%20your%20feedback%20to%20improve%20the%20documentation.%20We%20don%27t%20use%20your%20email%20address%20for%20any%20other%20purpose,%20and%20we%27ll%20remove%20your%20email%20address%20from%20our%20system%20after%20the%20issue%20that%20you%27re%20reporting%20is%20fixed.%20While%20we%27re%20working%20to%20fix%20this%20issue,%20we%20might%20send%20you%20an%20email%20message%20to%20ask%20for%20more%20info.%20Later,%20we%20might%20also%20send%20you%20an%20email%20message%20to%20let%20you%20know%20that%20we%27ve%20addressed%20your%20feedback.%0A%0AFor%20more%20info%20about%20Microsoft%27s%20privacy%20policy,%20see%20http://privacy.microsoft.com/en-us/default.aspx." title="Send comments about this topic to Microsoft">Send comments about this topic to Microsoft</a></p>
- </div>
- </div>
-
- </div>
- </div>
- <div class="clear"></div>
-
- <input name="__RequestVerificationToken" type="hidden" value="jCYMiDP681esnBmCmEL1IKtpwppIJiV6ZuB4RNW_-6CoQXhy_BPtqp_b6Vk9eP0bzYLpa3cttm-m9DDCz1WCTK3jRLE1">
- <input id="ratingValueSubmitUrl" type="hidden" value="https://msdn.microsoft.com/en-us/library/feedback/rate/ff554721(d=printer,v=vs.85).aspx">
- <input id="ratingAdditionalSubmitUrl" type="hidden" value="https://msdn.microsoft.com/en-us/library/feedback/additional/ff554721(d=printer,v=vs.85).aspx">
- <input id="isTopicRated" type="hidden" value="false">
- <div id="lib-footer" ms.pgarea="body">
-
-
- <link type="text/css" rel="stylesheet">
-
- <div id="ux-footer" class="" style="" dir="ltr">
-
- <div id="footerSock" class="librarySock both">
- <div id="footerSockInner">
- <a name="feedback"></a>
- <div class="rating">
- <div id="ratingSection1">
- <div class="title">
- Was this page helpful?
- </div>
- <div class="description">
- Your feedback about this content is important.<br>Let us know what you think.
- </div>
- <div class="buttons">
- <button class="button" id="ratingYes" aria-label="Yes, this page was helpful">Yes</button>
- <button class="button" id="ratingNo" aria-label="No, this page was not helpful">No</button>
- </div>
- <input id="ratingValue" type="hidden" value="">
- </div>
- <div id="ratingSection2">
- <div class="title left">
- Additional feedback?
- </div>
- <textarea id="ratingText" rows="6" cols="" maxlength="1500"></textarea>
- <div class="right">
- <div class="counter">
- <span id="feedbackTextCounter">1500</span> characters remaining
- </div>
- <div class="buttons">
- <button class="button" id="ratingSubmit" aria-label="Submit my additional feedback">Submit</button>
- <button class="button" id="ratingSkipThis" aria-label="Skip additional feedback">Skip this</button>
- </div>
- </div>
- </div>
- <div id="ratingSection3">
- <div class="title">
- Thank you!
- </div>
- <div class="description">
- We appreciate your feedback.
- </div>
- </div>
-
-
- <div id="contentFeedbackQAContainer" style="display: none;"></div>
- </div>
-
- <div class="userVoice">
- <div class="title">
- Help us improve MSDN.
- </div>
- <div class="description">
- Visit our UserVoice Page to submit and vote on ideas!
- </div>
- <div class="buttons">
- <a class="button" id="userVoiceButton" href="http://feedback.msdn.com/forums/257782-msdn-feature-suggestions/category/83975" target="_blank">Make a suggestion</a>
- </div>
- </div>
- <div class="clear"></div>
- </div>
- </div>
- <footer class="top">
- <div data-fragmentname="LeftLinks" id="Fragment_LeftLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Dev centers</div>
- <ul class="links">
- <li>
- <a href="https://dev.windows.com/" id="LeftLinks_2148_1" class="windowsBlue" xmlns="http://www.w3.org/1999/xhtml">Windows</a>
- </li>
- <li>
- <a href="http://dev.office.com/" id="LeftLinks_2148_3" class="office" xmlns="http://www.w3.org/1999/xhtml">Office</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/vstudio" id="LeftLinks_2148_4" class="visualStudio" xmlns="http://www.w3.org/1999/xhtml">Visual Studio</a>
- </li>
- <li>
- <a href="http://azure.microsoft.com/en-us/documentation/" target="_blank" id="LeftLinks_2148_12" xmlns="http://www.w3.org/1999/xhtml">Microsoft Azure</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/developer-centers-msdn" id="LeftLinks_2148_5" xmlns="http://www.w3.org/1999/xhtml">More...</a>
- </li>
- </ul>
- </div>
- </div>
- <div id="rightLinks">
- <div data-fragmentname="CenterLinks1" id="Fragment_CenterLinks1" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Learning resources</div>
- <ul class="links">
- <li>
- <a href="http://www.microsoftvirtualacademy.com/" id="CenterLinks1_2151_4" xmlns="http://www.w3.org/1999/xhtml">Microsoft Virtual Academy</a>
- </li>
- <li>
- <a href="http://channel9.msdn.com/" id="CenterLinks1_2151_5" xmlns="http://www.w3.org/1999/xhtml">Channel 9</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/magazine/" id="CenterLinks1_2151_7" xmlns="http://www.w3.org/1999/xhtml">MSDN Magazine</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks2" id="Fragment_CenterLinks2" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Community</div>
- <ul class="links">
- <li>
- <a href="https://social.msdn.microsoft.com/forums/en-us/home" id="CenterLinks2_2151_8" xmlns="http://www.w3.org/1999/xhtml">Forums</a>
- </li>
- <li>
- <a href="http://blogs.msdn.com/b/developer-tools/" id="CenterLinks2_2151_9" xmlns="http://www.w3.org/1999/xhtml">Blogs</a>
- </li>
- <li>
- <a href="http://www.codeplex.com/" id="CenterLinks2_2151_10" xmlns="http://www.w3.org/1999/xhtml">Codeplex</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks3" id="Fragment_CenterLinks3" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Support</div>
- <ul class="links">
- <li>
- <a href="https://msdn.microsoft.com/hh361695" id="CenterLinks3_2151_11" xmlns="http://www.w3.org/1999/xhtml">Self support</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks4" id="Fragment_CenterLinks4" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Programs</div>
- <ul class="links">
- <li>
- <a href="https://www.microsoft.com/bizspark/" id="CenterLinks4_2151_13" xmlns="http://www.w3.org/1999/xhtml">BizSpark (for startups)</a>
- </li>
- <li>
- <a href="https://www.dreamspark.com/" id="CenterLinks4_2151_14" xmlns="http://www.w3.org/1999/xhtml">DreamSpark</a>
- </li>
- <li>
- <a href="http://www.imaginecup.com/" id="CenterLinks4_2151_17" xmlns="http://www.w3.org/1999/xhtml">Imagine Cup</a>
- </li>
- </ul>
- </div>
- </div>
- </div>
- </footer>
- <footer class="bottom">
- <span class="localeContainer">
-
- <form class="selectLocale" id="selectLocaleForm" action="https://msdn.microsoft.com/en-us/selectlocale-dmc">
- <input type="hidden" name="fromPage" value="https%3a%2f%2fmsdn.microsoft.com%2fen-us%2flibrary%2fff554721(d%3dprinter%2cv%3dvs.85).aspx%3flan%3dCSharp%26cc%3dn%26trm%3dtra%26view%3dbook">
- <a href="http://msdn.microsoft.com/#" onclick="$('#selectLocaleForm').submit();return false;" title="Change your language">United States (English)</a>
- </form>
- </span>
- <div data-fragmentname="BottomLinks" id="Fragment_BottomLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <ul class="links horizontal">
- <li>
- <a href="https://msdn.microsoft.com/newsletter.aspx" id="BottomLinks_2148_7" xmlns="http://www.w3.org/1999/xhtml">Newsletter</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/dn529288" id="BottomLinks_2148_8" xmlns="http://www.w3.org/1999/xhtml">Privacy & cookies</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/cc300389" id="BottomLinks_2148_9" xmlns="http://www.w3.org/1999/xhtml">Terms of use</a>
- </li>
- <li>
- <a href="https://www.microsoft.com/en-us/legal/intellectualproperty/Trademarks/EN-US.aspx" id="BottomLinks_2148_10" xmlns="http://www.w3.org/1999/xhtml">Trademarks</a>
- </li>
- </ul>
- </div>
- </div>
- <span class="logoLegal">
- <span class="logo"></span>
- <span class="copyright">© 2016 Microsoft</span>
- </span>
- </footer>
- </div>
-
- </div>
- <div class="footerPrintView">
- <div class="footerCopyrightPrintView">© 2016 Microsoft</div>
- </div>
-
-
-
-
- <input id="tocPaddingPerLevel" type="hidden" value="17">
- <input id="MtpsDevice" type="hidden" value="Printer">
- <!--[CDATA[ Third party scripts and code linked to or referenced from this website are licensed to you by the parties that own such code, not by Microsoft. See ASP.NET Ajax CDN Terms of Use – http://www.asp.net/ajaxlibrary/CDN.ashx. ]]-->
-
-
-
-
-
- <noscript><div><img alt="DCSIMG" id="Img1" width="1" height="1" src="https://m.webtrends.com/dcsmgru7m99k7mqmgrhudo0k8_8c6m/njs.gif?dcsuri=/nojavascript&amp;WT.js=No" /></div></noscript>
- <div id="globalRequestVerification">
- <input name="__RequestVerificationToken" type="hidden" value="e9oeGUDGYoaEybG8lg054JSz--DS_hylYEiWuAdF4WTLBFkat-3Q6A-u547xm-M7PW_SKCE8HS1HKCAKYZjS99_ggZo1">
- </div>
- </div>
-
-
-
-
-
-
- <script type="text/javascript" class="mtps-injected">
- /*<![CDATA[*/
- (function(window,document){"use strict";function preload(scripts){for(var result=[],script,e,i=0;i<scripts.length;i++)script=scripts[i],script.hasOwnProperty("url")&&(e=document.createElement("script"),e.src=script.url,script.throwaway=e),result.push(script);return result}function inject(scripts,index){var script,elem;if(index>=scripts.length){delete mtps.injectScripts;return}script=scripts[index];elem=document.createElement("script");elem.className="mtps-injected";elem.async=!1;var isLoaded=!1,timeoutId=0,injectNextFnName="",injectNext=elem.onerror=function(){isLoaded||(isLoaded=!0,inject(scripts,index+1),window.clearTimeout(timeoutId),elem.onload=elem.onerror=elem.onreadystatechange=null,injectNextFnName&&delete mtps[injectNextFnName],elem.removeEventListener&&elem.removeEventListener("load",injectNext,!1))};elem.addEventListener?elem.addEventListener("load",injectNext,!1):elem.readyState==="uninitialized"?elem.onreadystatechange=function(){(this.readyState==="loaded"||this.readyState==="complete")&&injectNext()}:elem.onload=injectNext;script.hasOwnProperty("url")?(timeoutId=window.setTimeout(injectNext,12e4),elem.src=script.url):(injectNextFnName="_injectNextScript_"+index,mtps[injectNextFnName]=injectNext,timeoutId=window.setTimeout(injectNext,2e3),elem.text="try {\n"+script.txt+"\n} finally { MTPS."+injectNextFnName+" && MTPS."+injectNextFnName+"(); }");parent.appendChild(elem)}var mtps=window.MTPS||(window.MTPS={}),parent=document.getElementsByTagName("head")[0];mtps.injectScripts=function(scripts){inject(preload(scripts),0)}})(window,document);
- MTPS.injectScripts([
- { txt: "/**/\r\n(window.MTPS || (window.MTPS = {})).cdnDomains || (window.MTPS.cdnDomains = { \r\n\t\"image\": \"https://i-msdn.sec.s-msft.com\", \r\n\t\"js\": \"https://i2-msdn.sec.s-msft.com\", \r\n\t\"css\": \"https://i-msdn.sec.s-msft.com\", \r\n\t\"ttf\": \"https://i-msdn.sec.s-msft.com\"\r\n});\r\n/**/" },
- { txt: "//\n var literalNormalizedUrl = \u0027/en-us/library/ff554721(d=printer,l=en-us,v=vs.85).aspx\u0027;\n var wt_nvr_ru = \u0027WT_NVR_RU\u0027;\n var wt_fpcdom = \u0027.microsoft.com\u0027;\n var wt_domlist = \u0027msdn.microsoft.com\u0027;\n var wt_pathlist = \u0027\u0027;\n var wt_paramlist = \u0027DCSext.mtps_devcenter\u0027;\n var wt_siteid = \u0027MSDN\u0027;\n var gDomain = \u0027m.webtrends.com\u0027;\n var gDcsId = \u0027dcsmgru7m99k7mqmgrhudo0k8_8c6m\u0027;\n var gFpc = \u0027WT_FPC\u0027;\n\n\n\n if (document.cookie.indexOf(gFpc + \"=\") == -1) {\n var wtidJs = document.createElement(\"script\");\n wtidJs.src = \"//\" + gDomain + \"/\" + gDcsId + \"/wtid.js\";\n document.getElementsByTagName(\"head\")[0].appendChild(wtidJs);\n }\n\n\n\n var detectedLocale = \u0027en-us\u0027;\n var wtsp = \u0027msdnlib_w32_com\u0027;\n var gTrackEvents = \u00270\u0027;\n/**/" },
- { txt: "//\n\n window.appInsightsId = \u00275eb1b2eb-c47a-497a-a7ac-a1c230b2882f\u0027;\n //" },
- { url: "https://i2-msdn.sec.s-msft.com/Combined.js?resources=0:Utilities,1:Layout,2:Header,1:Rating,2:Footer,0:Topic,3:PabTopic,4:webtrendsscript,0:AppInsightsPerf,0:ABTestControl,5:WEDCS,3:CmpgrpForHeader,0:livefyre,0:Comment,1:SearchBox;/Areas/Epx/Content/Scripts:0,/Areas/Epx/Themes/Base/Content:1,/Areas/Centers/Themes/StandardDevCenter/Content:2,/Areas/Library/Content:3,/Areas/Global/Content/Webtrends/resources:4,/Areas/Library/Themes/Base/Content:5\u0026amp;hashKey=30CEE944AABFEA2C5A338BDB9E000732\u0026amp;v=AE608271C0243AAA0449D3BC0FAD8EB4" },
- { url: "https://i1.services.social.microsoft.com/search/Widgets/SearchBox.jss?boxid=HeaderSearchTextBox\u0026btnid=HeaderSearchButton\u0026pgArea=header\u0026brand=Msdn\u0026loc=en-us\u0026focusOnInit=false\u0026emptyWatermark=true\u0026searchButtonTooltip=Search MSDN" },
- { url: "https://i2-msdn.sec.s-msft.com/Combined.js?resources=0:PrintExportButton,1:Toc_Fixed,1:CodeSnippet,1:TopicNotInScope,1:CollapsibleArea,1:VersionSelector,1:SurveyBroker;/Areas/Library/Themes/Base/Content:0,/Areas/Epx/Content/Scripts:1\u0026amp;hashKey=80F30894E3FB8A3295C923AEC7019CFE\u0026amp;v=AE608271C0243AAA0449D3BC0FAD8EB4" },
- { txt: "$(document).ready(function() {\n try {\n var token = $(\"#globalRequestVerification input[name=\u0027__RequestVerificationToken\u0027]\").clone();\n $(\"#siteFeedbackForm\").append(token);\n } catch(err) {\n \n }\n });" }
- ]);
- /*]]>*/
- </script>
- <link rel="stylesheet" type="text/css" href="./Windows Kernel Development Articles (2016-03-30)_files/Combined.css">
- <div id="page">
-
-
-
-
- <link type="text/css" rel="stylesheet">
-
- <input type="hidden" id="isHeaderBleeding" value="true">
- <div id="ux-header" dir="ltr" class="ltr msdn">
-
- <header>
- <span id="singleCol"></span>
- <span id="doubleCol"></span>
- <span id="isMobile"></span>
- <div>
- <div class="row topRow">
- <div class="top">
- <div class="left">
- <a class="msdnLogoImg" href="https://msdn.microsoft.com/en-us" title="MSDN home">
- <div id="msft-logo" class="msft-logo"></div>
- </a>
- <div class="GrayPipe"></div>
- <a class="DevCenterFullNameNonMegaBlade" href="https://msdn.microsoft.com/en-us">Developer Network</a>
- <a class="DevCenterFullName" href="https://msdn.microsoft.com/en-us">Developer Network</a>
- <a class="DevCenterShortName" href="https://msdn.microsoft.com/en-us">Developer</a>
- </div>
- <div class="right">
- <div id="signIn">
- <div class="profileImage"></div>
- <a class="scarabLink" href="https://login.live.com/login.srf?wa=wsignin1.0&rpsnv=12&ct=1459376406&rver=6.0.5276.0&wp=mcmbi&wlcxt=msdn%24msdn%24msdn&wreply=https%3a%2f%2fmsdn.microsoft.com%2fen-us%2flibrary%2fhh439638%2528d%3dprinter%2cv%3dvs.85%2529.aspx%3flan%3dcsharp%26cc%3dn%26trm%3dtra%26view%3dbook&lc=1033&id=254354&mkt=en-us" title="Sign in">Sign in</a></div>
- <div class="auxNav">
- <div>
- <div data-fragmentname="Subscriptions" id="Fragment_Subscriptions" xmlns="http://www.w3.org/1999/xhtml">
- <a href="https://msdn.microsoft.com/subscriptions/manage/hh442900" id="Subscriptions_2153_1" xmlns="http://www.w3.org/1999/xhtml">MSDN subscriptions</a>
- </div>
- <div data-fragmentname="GetTools" id="Fragment_GetTools" xmlns="http://www.w3.org/1999/xhtml">
- <a href="http://go.microsoft.com/fwlink/?LinkId=309297&clcid=0x409&slcid=0x409&campaign=o~msft~msdn~gettools-header~dn308572" id="GetTools_2153_3" xmlns="http://www.w3.org/1999/xhtml">Get tools</a>
- </div>
- </div>
- <div>
- <div data-fragmentname="SocialLinks" id="Fragment_SocialLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <ul class="links horizontal">
- <li>
- <a href="http://www.facebook.com/microsoftdeveloper" target="_blank" id="SocialLinks_2152_4" class="facebook" xmlns="http://www.w3.org/1999/xhtml">http://www.facebook.com/microsoftdeveloper</a>
- </li>
- <li>
- <a href="https://twitter.com/msdev" target="_blank" id="SocialLinks_2152_5" class="twitter" xmlns="http://www.w3.org/1999/xhtml">https://twitter.com/msdev</a>
- </li>
- <li>
- <a href="http://plus.google.com/111221966647232053570/" target="_blank" id="SocialLinks_2152_6" class="googlePlus" xmlns="http://www.w3.org/1999/xhtml">http://plus.google.com/111221966647232053570/</a>
- </li>
- </ul>
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- <div class="row middleRow">
- <div class="expandTop">
- <div class="left"></div>
- <div class="right"></div>
- </div>
- </div>
- </div>
- <div id="buttomRowWrapper" class="bg_default">
- <div class="row buttomRow bg_default">
- <div class="bottom">
- <div class="left">
- <a id="grip" class="menu-icon" href="javascript:void(0)"></a>
-
- <div id="drawer">
- <div class="toc">
-
- <nav>
- <ul class="navL1">
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Technologies">Technologies</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/cloud-app-development-msdn" title="Cloud">Cloud</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/app-development-msdn" title="App Development">App Development</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/web-app-development-msdn" title="Web">Web</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/big-data-development-msdn" title="Data">Data</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/games-development-msdn" title="Gaming">Gaming</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/internetofthings" title="Internet of Things">Internet of Things</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Downloads">Downloads</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://www.visualstudio.com/downloads/download-visual-studio-vs" title="Visual Studio">Visual Studio</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/subscriptions" title="MSDN subscription access">MSDN subscription access</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/microsoft-sdks-msdn" title="SDKs">SDKs</a>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Trial software">Trial software</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/evalcenter" title="Free downloads">Free downloads</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/officeevaluationresources" title="Office resources">Office resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/sharepoint2013resources" title="SharePoint Server 2013 resources">SharePoint Server 2013 resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/sqlserver2014expressresources" title="SQL Server 2014 Express resources">SQL Server 2014 Express resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/windowsserver2012r2resources" title="Windows Server 2012 resources">Windows Server 2012 resources</a>
- </li>
- </ul>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Programs">Programs</a>
- <ul class="navL2">
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Visual Studio subscriptions">Visual Studio subscriptions</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/msdn-subscriptions-overview" title="Overview">Overview</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/benefits-overview" title="Benefits">Benefits</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/msdn-subscriptions-administration" title="Administrators">Administrators</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Students">Students</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/imagine/imagine-home" title="Microsoft Imagine">Microsoft Imagine</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/microsoftstudentpartners" title="Microsoft Student Partners">Microsoft Student Partners</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Architects">Architects</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-overview-msdn" title="Overview">Overview</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-case-studies-msdn" title="Case studies">Case studies</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-blueprints-msdn" title="Blueprints">Blueprints</a>
- </li>
- <li class="inactive">
- <a href="http://blogs.msdn.com/b/msarchitecture/" title="Blog">Blog</a>
- </li>
- <li class="inactive">
- <a href="http://social.msdn.microsoft.com/forums/en-us/home?brandignore=true&sort=relevancedesc&searchterm=architecture+or+architect" title="Forums">Forums</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/applicationbuilder" title="ISV">ISV</a>
-
- </li>
- <li class="inactive">
- <a href="https://www.microsoft.com/bizspark" title="Startups">Startups</a>
-
- </li>
- <li class="inactive">
- <a href="https://rewards.msdn.microsoft.com/" title="TechRewards">TechRewards</a>
-
- </li>
- <li class="inactive">
- <a href="http://events.msdn.microsoft.com/" title="Events">Events</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Community">Community</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/magazine/dd767791" title="Magazine">Magazine</a>
-
- </li>
- <li class="inactive">
- <a href="https://social.msdn.microsoft.com/forums/" title="Forums">Forums</a>
-
- </li>
- <li class="inactive">
- <a href="http://blogs.msdn.com/b/developer-tools/" title="Blogs">Blogs</a>
-
- </li>
- <li class="inactive">
- <a href="http://tech-advisors.msdn.microsoft.com/en-us" title="Tech Advisors">Tech Advisors</a>
-
- </li>
- <li class="inactive">
- <a href="http://channel9.msdn.com/" title="Channel 9">Channel 9</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive current toggle">
- <a href="javascript:void(0)" title="Documentation">Documentation</a>
- <ul class="navL2">
- <li class="inactive current">
- <a href="https://msdn.microsoft.com/library" title="APIs and reference">APIs and reference</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/developer-centers-msdn" title="Dev centers">Dev centers</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive">
- <a href="https://code.msdn.microsoft.com/" title="Samples">Samples</a>
- </li>
- </ul>
- </nav>
- </div>
- </div>
- </div>
- <div class="right">
- <div data-fragmentname="SearchBox" id="Fragment_SearchBox" xmlns="http://www.w3.org/1999/xhtml">
- <div class="SearchBox">
- <form id="HeaderSearchForm" name="HeaderSearchForm" method="get">
- <button id="FakeHeaderSearchButton" value="Search" type="submit" class="header-search-button">
- <div id="search-finder" class="search-finder"></div>
- </button>
- <button id="HeaderSearchButton" style="display:none"></button>
- <div id="searchSplitter"></div>
- <div id="searchCloseIcon" class="search-clear-x"></div>
- <div id="searchTextContainer" style="width: 0;">
- <input id="HeaderSearchTextBox" name="query" type="text" maxlength="200" onfocus="Epx.Controls.SearchBox.watermarkFocus(event, this.title)" onblur="Epx.Controls.SearchBox.watermarkBlur(event, this.title)">
- </div>
- </form>
-
-
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- </header>
- </div>
-
-
-
- <div class="printExportMenus ltr">
- <a id="isd_printABook" href="http://msdn.microsoft.com/en-us/library/export/help/(d=printer)?returnurl=%2fen-us%2flibrary%2fhh439638(d%3dprinter,v%3dvs.85).aspx%3flan%3dcsharp%26cc%3dn%26trm%3dtra%26view%3dbook">
- Export (<span class="count">0</span>)
- </a>
- <a id="isd_print" href="https://msdn.microsoft.com/en-us/library/hh439638(d=printer,v=vs.85).aspx?lan=csharp&cc=n&trm=tra&view=book" rel="nofollow">
- Print
- </a>
- <a id="isd_archiveControl" style="display:none;" data-include-archive="Include Previous Version" data-exclude-archive="Exclude Previous Version">
- </a>
- </div>
-
- <div class="printExportMenus ltr">
- <a id="expandCollapseAll" accesskey="e" href="javascript:void(0)" title="Expand/Collapse all sections by pressing Ctrl + Shift + e">Expand All</a>
- </div>
-
- <div id="body" ms.pgarea="body">
- <span id="tabletView_large"></span>
- <span id="tabletView_small"></span>
- <span id="mobileView"></span>
-
- <div id="content" class="content">
- <input type="hidden" id="printForPab" value="true">
-
- <div class="topic" xmlns="http://www.w3.org/1999/xhtml">
- <h1 class="title">I/O request packets</h1>
-
- <div id="mainSection">
- <div class="clsServerSDKContent">
- </div>
- <p>Most of the requests that are sent to device drivers are packaged in I/O request packets (<a href="https://msdn.microsoft.com/en-us/library/ff550694(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">IRP</strong></a>s). An operating system component or a driver sends an IRP to a driver by calling <a href="https://msdn.microsoft.com/en-us/library/ff548336(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">IoCallDriver</strong></a>, which has two parameters: a pointer to a <a href="https://msdn.microsoft.com/en-us/library/ff543147(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">DEVICE_OBJECT</strong></a> and a pointer to an <strong>IRP</strong>. The <strong>DEVICE_OBJECT</strong> has a pointer to an associated <a href="https://msdn.microsoft.com/en-us/library/ff544174(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">DRIVER_OBJECT</strong></a>. When a component calls <strong>IoCallDriver</strong>, we say the component <em>sends the IRP to the device object</em> or <em>sends the IRP to the driver associated with the device object</em>. Sometimes we use the phrase <em>passes the IRP</em> or <em>forwards the IRP</em> instead of <em>sends the IRP</em>.</p>
- <p>Typically an IRP is processed by several drivers that are arranged in a stack. Each driver in the stack is associated with a device object. For more information, see <a href="https://msdn.microsoft.com/en-us/library/ff554721(v=vs.85).aspx">Device nodes and device stacks</a>. When an <a href="https://msdn.microsoft.com/en-us/library/ff550694(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">IRP</strong></a> is processed by a device stack, the <strong>IRP</strong> is usually sent first to the top device object in the device stack. For example, if an <strong>IRP</strong> is processed by the device stack shown in this diagram, the IRP would be sent first to the filter device object (Filter DO) at the top of the device stack.</p><img id="ProsewareDeviceNode03" alt="Diagram of a device node and its device stack" src="./Windows Kernel Development Articles (2016-03-30)_files/IC535107.png" title="Diagram of a device node and its device stack" xmlns=""><h2><a id="Passing_an_IRP_down_the_device_stack"></a><a id="passing_an_irp_down_the_device_stack"></a><a id="PASSING_AN_IRP_DOWN_THE_DEVICE_STACK"></a>Passing an IRP down the device stack</h2>
- <p>Suppose the I/O manager sends an IRP to the Filter DO in the diagram. The driver associated with the Filter DO, AfterThought.sys, processes the IRP and then passes it to the functional device object (FDO), which is the next lower device object in the device stack. When a driver passes an IRP to the next lower device object in the device stack, we say the driver <em>passes the IRP down the device stack</em>.</p>
- <p>Some IRPs are passed all the way down the device stack to the physical device object (PDO). Other IRPs never reach the PDO because they are completed by one of the drivers above the PDO.</p>
- <h2><a id="IRPs_are_self-contained"></a><a id="irps_are_self-contained"></a><a id="IRPS_ARE_SELF-CONTAINED"></a>IRPs are self-contained</h2>
- <p>The IRP structure is self-contained in the sense that it holds all of the information that a driver needs to handle an I/0 request. Some parts of the IRP structure hold information that is common to all of the participating drivers in the stack. Other parts of the IRP hold information that is specific to a particular driver in the stack.</p>
- <p> </p>
- <p> </p>
- <p><a href="mailto:wsddocfb@microsoft.com?subject=Documentation%20feedback%20[wdkgetstart\wdkgetstart]:%20I/O%20request%20packets%20%20RELEASE:%20(3/4/2016)&body=%0A%0APRIVACY%20STATEMENT%0A%0AWe%20use%20your%20feedback%20to%20improve%20the%20documentation.%20We%20don%27t%20use%20your%20email%20address%20for%20any%20other%20purpose,%20and%20we%27ll%20remove%20your%20email%20address%20from%20our%20system%20after%20the%20issue%20that%20you%27re%20reporting%20is%20fixed.%20While%20we%27re%20working%20to%20fix%20this%20issue,%20we%20might%20send%20you%20an%20email%20message%20to%20ask%20for%20more%20info.%20Later,%20we%20might%20also%20send%20you%20an%20email%20message%20to%20let%20you%20know%20that%20we%27ve%20addressed%20your%20feedback.%0A%0AFor%20more%20info%20about%20Microsoft%27s%20privacy%20policy,%20see%20http://privacy.microsoft.com/en-us/default.aspx." title="Send comments about this topic to Microsoft">Send comments about this topic to Microsoft</a></p>
- </div>
- </div>
-
- </div>
- </div>
- <div class="clear"></div>
-
- <input name="__RequestVerificationToken" type="hidden" value="t8spR-QgGPJ3gewNcsyRxxW9z38K2-eaXb8a5wuIxHRkCpe5nqAlBs2aOAMkm7wj-MYvB8yxrWaRBCEQNyhATix7g5A1">
- <input id="ratingValueSubmitUrl" type="hidden" value="https://msdn.microsoft.com/en-us/library/feedback/rate/hh439638(d=printer,v=vs.85).aspx">
- <input id="ratingAdditionalSubmitUrl" type="hidden" value="https://msdn.microsoft.com/en-us/library/feedback/additional/hh439638(d=printer,v=vs.85).aspx">
- <input id="isTopicRated" type="hidden" value="false">
- <div id="lib-footer" ms.pgarea="body">
-
-
- <link type="text/css" rel="stylesheet">
-
- <div id="ux-footer" class="" style="" dir="ltr">
-
- <div id="footerSock" class="librarySock both">
- <div id="footerSockInner">
- <a name="feedback"></a>
- <div class="rating">
- <div id="ratingSection1">
- <div class="title">
- Was this page helpful?
- </div>
- <div class="description">
- Your feedback about this content is important.<br>Let us know what you think.
- </div>
- <div class="buttons">
- <button class="button" id="ratingYes" aria-label="Yes, this page was helpful">Yes</button>
- <button class="button" id="ratingNo" aria-label="No, this page was not helpful">No</button>
- </div>
- <input id="ratingValue" type="hidden" value="">
- </div>
- <div id="ratingSection2">
- <div class="title left">
- Additional feedback?
- </div>
- <textarea id="ratingText" rows="6" cols="" maxlength="1500"></textarea>
- <div class="right">
- <div class="counter">
- <span id="feedbackTextCounter">1500</span> characters remaining
- </div>
- <div class="buttons">
- <button class="button" id="ratingSubmit" aria-label="Submit my additional feedback">Submit</button>
- <button class="button" id="ratingSkipThis" aria-label="Skip additional feedback">Skip this</button>
- </div>
- </div>
- </div>
- <div id="ratingSection3">
- <div class="title">
- Thank you!
- </div>
- <div class="description">
- We appreciate your feedback.
- </div>
- </div>
-
-
- <div id="contentFeedbackQAContainer" style="display: none;"></div>
- </div>
-
- <div class="userVoice">
- <div class="title">
- Help us improve MSDN.
- </div>
- <div class="description">
- Visit our UserVoice Page to submit and vote on ideas!
- </div>
- <div class="buttons">
- <a class="button" id="userVoiceButton" href="http://feedback.msdn.com/forums/257782-msdn-feature-suggestions/category/83975" target="_blank">Make a suggestion</a>
- </div>
- </div>
- <div class="clear"></div>
- </div>
- </div>
- <footer class="top">
- <div data-fragmentname="LeftLinks" id="Fragment_LeftLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Dev centers</div>
- <ul class="links">
- <li>
- <a href="https://dev.windows.com/" id="LeftLinks_2148_1" class="windowsBlue" xmlns="http://www.w3.org/1999/xhtml">Windows</a>
- </li>
- <li>
- <a href="http://dev.office.com/" id="LeftLinks_2148_3" class="office" xmlns="http://www.w3.org/1999/xhtml">Office</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/vstudio" id="LeftLinks_2148_4" class="visualStudio" xmlns="http://www.w3.org/1999/xhtml">Visual Studio</a>
- </li>
- <li>
- <a href="http://azure.microsoft.com/en-us/documentation/" target="_blank" id="LeftLinks_2148_12" xmlns="http://www.w3.org/1999/xhtml">Microsoft Azure</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/developer-centers-msdn" id="LeftLinks_2148_5" xmlns="http://www.w3.org/1999/xhtml">More...</a>
- </li>
- </ul>
- </div>
- </div>
- <div id="rightLinks">
- <div data-fragmentname="CenterLinks1" id="Fragment_CenterLinks1" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Learning resources</div>
- <ul class="links">
- <li>
- <a href="http://www.microsoftvirtualacademy.com/" id="CenterLinks1_2151_4" xmlns="http://www.w3.org/1999/xhtml">Microsoft Virtual Academy</a>
- </li>
- <li>
- <a href="http://channel9.msdn.com/" id="CenterLinks1_2151_5" xmlns="http://www.w3.org/1999/xhtml">Channel 9</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/magazine/" id="CenterLinks1_2151_7" xmlns="http://www.w3.org/1999/xhtml">MSDN Magazine</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks2" id="Fragment_CenterLinks2" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Community</div>
- <ul class="links">
- <li>
- <a href="https://social.msdn.microsoft.com/forums/en-us/home" id="CenterLinks2_2151_8" xmlns="http://www.w3.org/1999/xhtml">Forums</a>
- </li>
- <li>
- <a href="http://blogs.msdn.com/b/developer-tools/" id="CenterLinks2_2151_9" xmlns="http://www.w3.org/1999/xhtml">Blogs</a>
- </li>
- <li>
- <a href="http://www.codeplex.com/" id="CenterLinks2_2151_10" xmlns="http://www.w3.org/1999/xhtml">Codeplex</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks3" id="Fragment_CenterLinks3" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Support</div>
- <ul class="links">
- <li>
- <a href="https://msdn.microsoft.com/hh361695" id="CenterLinks3_2151_11" xmlns="http://www.w3.org/1999/xhtml">Self support</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks4" id="Fragment_CenterLinks4" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Programs</div>
- <ul class="links">
- <li>
- <a href="https://www.microsoft.com/bizspark/" id="CenterLinks4_2151_13" xmlns="http://www.w3.org/1999/xhtml">BizSpark (for startups)</a>
- </li>
- <li>
- <a href="https://www.dreamspark.com/" id="CenterLinks4_2151_14" xmlns="http://www.w3.org/1999/xhtml">DreamSpark</a>
- </li>
- <li>
- <a href="http://www.imaginecup.com/" id="CenterLinks4_2151_17" xmlns="http://www.w3.org/1999/xhtml">Imagine Cup</a>
- </li>
- </ul>
- </div>
- </div>
- </div>
- </footer>
- <footer class="bottom">
- <span class="localeContainer">
-
- <form class="selectLocale" id="selectLocaleForm" action="https://msdn.microsoft.com/en-us/selectlocale-dmc">
- <input type="hidden" name="fromPage" value="https%3a%2f%2fmsdn.microsoft.com%2fen-us%2flibrary%2fhh439638(d%3dprinter%2cv%3dvs.85).aspx%3flan%3dCSharp%26cc%3dn%26trm%3dtra%26view%3dbook">
- <a href="http://msdn.microsoft.com/#" onclick="$('#selectLocaleForm').submit();return false;" title="Change your language">United States (English)</a>
- </form>
- </span>
- <div data-fragmentname="BottomLinks" id="Fragment_BottomLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <ul class="links horizontal">
- <li>
- <a href="https://msdn.microsoft.com/newsletter.aspx" id="BottomLinks_2148_7" xmlns="http://www.w3.org/1999/xhtml">Newsletter</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/dn529288" id="BottomLinks_2148_8" xmlns="http://www.w3.org/1999/xhtml">Privacy & cookies</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/cc300389" id="BottomLinks_2148_9" xmlns="http://www.w3.org/1999/xhtml">Terms of use</a>
- </li>
- <li>
- <a href="https://www.microsoft.com/en-us/legal/intellectualproperty/Trademarks/EN-US.aspx" id="BottomLinks_2148_10" xmlns="http://www.w3.org/1999/xhtml">Trademarks</a>
- </li>
- </ul>
- </div>
- </div>
- <span class="logoLegal">
- <span class="logo"></span>
- <span class="copyright">© 2016 Microsoft</span>
- </span>
- </footer>
- </div>
-
- </div>
- <div class="footerPrintView">
- <div class="footerCopyrightPrintView">© 2016 Microsoft</div>
- </div>
-
-
-
-
- <input id="tocPaddingPerLevel" type="hidden" value="17">
- <input id="MtpsDevice" type="hidden" value="Printer">
- <!--[CDATA[ Third party scripts and code linked to or referenced from this website are licensed to you by the parties that own such code, not by Microsoft. See ASP.NET Ajax CDN Terms of Use – http://www.asp.net/ajaxlibrary/CDN.ashx. ]]-->
-
-
-
-
-
- <noscript><div><img alt="DCSIMG" id="Img1" width="1" height="1" src="https://m.webtrends.com/dcsmgru7m99k7mqmgrhudo0k8_8c6m/njs.gif?dcsuri=/nojavascript&amp;WT.js=No" /></div></noscript>
- <div id="globalRequestVerification">
- <input name="__RequestVerificationToken" type="hidden" value="BMuVa0ZtcT1GmCQtSM0m-XaYu_IFOSJjUxviiFXAoQ5jMi4BOfbgf-OoH3ZyiDl6IAt59wjB3Q09DhUpZyn1aT5CdW41">
- </div>
- </div>
-
-
-
-
-
-
- <script type="text/javascript" class="mtps-injected">
- /*<![CDATA[*/
- (function(window,document){"use strict";function preload(scripts){for(var result=[],script,e,i=0;i<scripts.length;i++)script=scripts[i],script.hasOwnProperty("url")&&(e=document.createElement("script"),e.src=script.url,script.throwaway=e),result.push(script);return result}function inject(scripts,index){var script,elem;if(index>=scripts.length){delete mtps.injectScripts;return}script=scripts[index];elem=document.createElement("script");elem.className="mtps-injected";elem.async=!1;var isLoaded=!1,timeoutId=0,injectNextFnName="",injectNext=elem.onerror=function(){isLoaded||(isLoaded=!0,inject(scripts,index+1),window.clearTimeout(timeoutId),elem.onload=elem.onerror=elem.onreadystatechange=null,injectNextFnName&&delete mtps[injectNextFnName],elem.removeEventListener&&elem.removeEventListener("load",injectNext,!1))};elem.addEventListener?elem.addEventListener("load",injectNext,!1):elem.readyState==="uninitialized"?elem.onreadystatechange=function(){(this.readyState==="loaded"||this.readyState==="complete")&&injectNext()}:elem.onload=injectNext;script.hasOwnProperty("url")?(timeoutId=window.setTimeout(injectNext,12e4),elem.src=script.url):(injectNextFnName="_injectNextScript_"+index,mtps[injectNextFnName]=injectNext,timeoutId=window.setTimeout(injectNext,2e3),elem.text="try {\n"+script.txt+"\n} finally { MTPS."+injectNextFnName+" && MTPS."+injectNextFnName+"(); }");parent.appendChild(elem)}var mtps=window.MTPS||(window.MTPS={}),parent=document.getElementsByTagName("head")[0];mtps.injectScripts=function(scripts){inject(preload(scripts),0)}})(window,document);
- MTPS.injectScripts([
- { txt: "/**/\r\n(window.MTPS || (window.MTPS = {})).cdnDomains || (window.MTPS.cdnDomains = { \r\n\t\"image\": \"https://i-msdn.sec.s-msft.com\", \r\n\t\"js\": \"https://i2-msdn.sec.s-msft.com\", \r\n\t\"css\": \"https://i-msdn.sec.s-msft.com\", \r\n\t\"ttf\": \"https://i-msdn.sec.s-msft.com\"\r\n});\r\n/**/" },
- { txt: "//\n var literalNormalizedUrl = \u0027/en-us/library/hh439638(d=printer,l=en-us,v=vs.85).aspx\u0027;\n var wt_nvr_ru = \u0027WT_NVR_RU\u0027;\n var wt_fpcdom = \u0027.microsoft.com\u0027;\n var wt_domlist = \u0027msdn.microsoft.com\u0027;\n var wt_pathlist = \u0027\u0027;\n var wt_paramlist = \u0027DCSext.mtps_devcenter\u0027;\n var wt_siteid = \u0027MSDN\u0027;\n var gDomain = \u0027m.webtrends.com\u0027;\n var gDcsId = \u0027dcsmgru7m99k7mqmgrhudo0k8_8c6m\u0027;\n var gFpc = \u0027WT_FPC\u0027;\n\n\n\n if (document.cookie.indexOf(gFpc + \"=\") == -1) {\n var wtidJs = document.createElement(\"script\");\n wtidJs.src = \"//\" + gDomain + \"/\" + gDcsId + \"/wtid.js\";\n document.getElementsByTagName(\"head\")[0].appendChild(wtidJs);\n }\n\n\n\n var detectedLocale = \u0027en-us\u0027;\n var wtsp = \u0027msdnlib_w32_com\u0027;\n var gTrackEvents = \u00270\u0027;\n/**/" },
- { txt: "//\n\n window.appInsightsId = \u00275eb1b2eb-c47a-497a-a7ac-a1c230b2882f\u0027;\n //" },
- { url: "https://i2-msdn.sec.s-msft.com/Combined.js?resources=0:Utilities,1:Layout,2:Header,1:Rating,2:Footer,0:Topic,3:PabTopic,4:webtrendsscript,0:AppInsightsPerf,0:ABTestControl,5:WEDCS,3:CmpgrpForHeader,0:livefyre,0:Comment,1:SearchBox;/Areas/Epx/Content/Scripts:0,/Areas/Epx/Themes/Base/Content:1,/Areas/Centers/Themes/StandardDevCenter/Content:2,/Areas/Library/Content:3,/Areas/Global/Content/Webtrends/resources:4,/Areas/Library/Themes/Base/Content:5\u0026amp;hashKey=30CEE944AABFEA2C5A338BDB9E000732\u0026amp;v=AE608271C0243AAA0449D3BC0FAD8EB4" },
- { url: "https://i1.services.social.microsoft.com/search/Widgets/SearchBox.jss?boxid=HeaderSearchTextBox\u0026btnid=HeaderSearchButton\u0026pgArea=header\u0026brand=Msdn\u0026loc=en-us\u0026focusOnInit=false\u0026emptyWatermark=true\u0026searchButtonTooltip=Search MSDN" },
- { url: "https://i2-msdn.sec.s-msft.com/Combined.js?resources=0:PrintExportButton,1:Toc_Fixed,1:CodeSnippet,1:TopicNotInScope,1:CollapsibleArea,1:VersionSelector,1:SurveyBroker;/Areas/Library/Themes/Base/Content:0,/Areas/Epx/Content/Scripts:1\u0026amp;hashKey=80F30894E3FB8A3295C923AEC7019CFE\u0026amp;v=AE608271C0243AAA0449D3BC0FAD8EB4" },
- { txt: "$(document).ready(function() {\n try {\n var token = $(\"#globalRequestVerification input[name=\u0027__RequestVerificationToken\u0027]\").clone();\n $(\"#siteFeedbackForm\").append(token);\n } catch(err) {\n \n }\n });" }
- ]);
- /*]]>*/
- </script>
- <link rel="stylesheet" type="text/css" href="./Windows Kernel Development Articles (2016-03-30)_files/Combined.css">
- <div id="page">
-
-
-
-
- <link type="text/css" rel="stylesheet">
-
- <input type="hidden" id="isHeaderBleeding" value="true">
- <div id="ux-header" dir="ltr" class="ltr msdn">
-
- <header>
- <span id="singleCol"></span>
- <span id="doubleCol"></span>
- <span id="isMobile"></span>
- <div>
- <div class="row topRow">
- <div class="top">
- <div class="left">
- <a class="msdnLogoImg" href="https://msdn.microsoft.com/en-us" title="MSDN home">
- <div id="msft-logo" class="msft-logo"></div>
- </a>
- <div class="GrayPipe"></div>
- <a class="DevCenterFullNameNonMegaBlade" href="https://msdn.microsoft.com/en-us">Developer Network</a>
- <a class="DevCenterFullName" href="https://msdn.microsoft.com/en-us">Developer Network</a>
- <a class="DevCenterShortName" href="https://msdn.microsoft.com/en-us">Developer</a>
- </div>
- <div class="right">
- <div id="signIn">
- <div class="profileImage"></div>
- <a class="scarabLink" href="https://login.live.com/login.srf?wa=wsignin1.0&rpsnv=12&ct=1459376407&rver=6.0.5276.0&wp=mcmbi&wlcxt=msdn%24msdn%24msdn&wreply=https%3a%2f%2fmsdn.microsoft.com%2fen-us%2flibrary%2fhh439632%2528d%3dprinter%2cv%3dvs.85%2529.aspx%3flan%3dcsharp%26cc%3dn%26trm%3dtra%26view%3dbook&lc=1033&id=254354&mkt=en-us" title="Sign in">Sign in</a></div>
- <div class="auxNav">
- <div>
- <div data-fragmentname="Subscriptions" id="Fragment_Subscriptions" xmlns="http://www.w3.org/1999/xhtml">
- <a href="https://msdn.microsoft.com/subscriptions/manage/hh442900" id="Subscriptions_2153_1" xmlns="http://www.w3.org/1999/xhtml">MSDN subscriptions</a>
- </div>
- <div data-fragmentname="GetTools" id="Fragment_GetTools" xmlns="http://www.w3.org/1999/xhtml">
- <a href="http://go.microsoft.com/fwlink/?LinkId=309297&clcid=0x409&slcid=0x409&campaign=o~msft~msdn~gettools-header~dn308572" id="GetTools_2153_3" xmlns="http://www.w3.org/1999/xhtml">Get tools</a>
- </div>
- </div>
- <div>
- <div data-fragmentname="SocialLinks" id="Fragment_SocialLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <ul class="links horizontal">
- <li>
- <a href="http://www.facebook.com/microsoftdeveloper" target="_blank" id="SocialLinks_2152_4" class="facebook" xmlns="http://www.w3.org/1999/xhtml">http://www.facebook.com/microsoftdeveloper</a>
- </li>
- <li>
- <a href="https://twitter.com/msdev" target="_blank" id="SocialLinks_2152_5" class="twitter" xmlns="http://www.w3.org/1999/xhtml">https://twitter.com/msdev</a>
- </li>
- <li>
- <a href="http://plus.google.com/111221966647232053570/" target="_blank" id="SocialLinks_2152_6" class="googlePlus" xmlns="http://www.w3.org/1999/xhtml">http://plus.google.com/111221966647232053570/</a>
- </li>
- </ul>
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- <div class="row middleRow">
- <div class="expandTop">
- <div class="left"></div>
- <div class="right"></div>
- </div>
- </div>
- </div>
- <div id="buttomRowWrapper" class="bg_default">
- <div class="row buttomRow bg_default">
- <div class="bottom">
- <div class="left">
- <a id="grip" class="menu-icon" href="javascript:void(0)"></a>
-
- <div id="drawer">
- <div class="toc">
-
- <nav>
- <ul class="navL1">
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Technologies">Technologies</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/cloud-app-development-msdn" title="Cloud">Cloud</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/app-development-msdn" title="App Development">App Development</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/web-app-development-msdn" title="Web">Web</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/big-data-development-msdn" title="Data">Data</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/games-development-msdn" title="Gaming">Gaming</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/internetofthings" title="Internet of Things">Internet of Things</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Downloads">Downloads</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://www.visualstudio.com/downloads/download-visual-studio-vs" title="Visual Studio">Visual Studio</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/subscriptions" title="MSDN subscription access">MSDN subscription access</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/microsoft-sdks-msdn" title="SDKs">SDKs</a>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Trial software">Trial software</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/evalcenter" title="Free downloads">Free downloads</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/officeevaluationresources" title="Office resources">Office resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/sharepoint2013resources" title="SharePoint Server 2013 resources">SharePoint Server 2013 resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/sqlserver2014expressresources" title="SQL Server 2014 Express resources">SQL Server 2014 Express resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/windowsserver2012r2resources" title="Windows Server 2012 resources">Windows Server 2012 resources</a>
- </li>
- </ul>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Programs">Programs</a>
- <ul class="navL2">
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Visual Studio subscriptions">Visual Studio subscriptions</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/msdn-subscriptions-overview" title="Overview">Overview</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/benefits-overview" title="Benefits">Benefits</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/msdn-subscriptions-administration" title="Administrators">Administrators</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Students">Students</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/imagine/imagine-home" title="Microsoft Imagine">Microsoft Imagine</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/microsoftstudentpartners" title="Microsoft Student Partners">Microsoft Student Partners</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Architects">Architects</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-overview-msdn" title="Overview">Overview</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-case-studies-msdn" title="Case studies">Case studies</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-blueprints-msdn" title="Blueprints">Blueprints</a>
- </li>
- <li class="inactive">
- <a href="http://blogs.msdn.com/b/msarchitecture/" title="Blog">Blog</a>
- </li>
- <li class="inactive">
- <a href="http://social.msdn.microsoft.com/forums/en-us/home?brandignore=true&sort=relevancedesc&searchterm=architecture+or+architect" title="Forums">Forums</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/applicationbuilder" title="ISV">ISV</a>
-
- </li>
- <li class="inactive">
- <a href="https://www.microsoft.com/bizspark" title="Startups">Startups</a>
-
- </li>
- <li class="inactive">
- <a href="https://rewards.msdn.microsoft.com/" title="TechRewards">TechRewards</a>
-
- </li>
- <li class="inactive">
- <a href="http://events.msdn.microsoft.com/" title="Events">Events</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Community">Community</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/magazine/dd767791" title="Magazine">Magazine</a>
-
- </li>
- <li class="inactive">
- <a href="https://social.msdn.microsoft.com/forums/" title="Forums">Forums</a>
-
- </li>
- <li class="inactive">
- <a href="http://blogs.msdn.com/b/developer-tools/" title="Blogs">Blogs</a>
-
- </li>
- <li class="inactive">
- <a href="http://tech-advisors.msdn.microsoft.com/en-us" title="Tech Advisors">Tech Advisors</a>
-
- </li>
- <li class="inactive">
- <a href="http://channel9.msdn.com/" title="Channel 9">Channel 9</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive current toggle">
- <a href="javascript:void(0)" title="Documentation">Documentation</a>
- <ul class="navL2">
- <li class="inactive current">
- <a href="https://msdn.microsoft.com/library" title="APIs and reference">APIs and reference</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/developer-centers-msdn" title="Dev centers">Dev centers</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive">
- <a href="https://code.msdn.microsoft.com/" title="Samples">Samples</a>
- </li>
- </ul>
- </nav>
- </div>
- </div>
- </div>
- <div class="right">
- <div data-fragmentname="SearchBox" id="Fragment_SearchBox" xmlns="http://www.w3.org/1999/xhtml">
- <div class="SearchBox">
- <form id="HeaderSearchForm" name="HeaderSearchForm" method="get">
- <button id="FakeHeaderSearchButton" value="Search" type="submit" class="header-search-button">
- <div id="search-finder" class="search-finder"></div>
- </button>
- <button id="HeaderSearchButton" style="display:none"></button>
- <div id="searchSplitter"></div>
- <div id="searchCloseIcon" class="search-clear-x"></div>
- <div id="searchTextContainer" style="width: 0;">
- <input id="HeaderSearchTextBox" name="query" type="text" maxlength="200" onfocus="Epx.Controls.SearchBox.watermarkFocus(event, this.title)" onblur="Epx.Controls.SearchBox.watermarkBlur(event, this.title)">
- </div>
- </form>
-
-
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- </header>
- </div>
-
-
-
- <div class="printExportMenus ltr">
- <a id="isd_printABook" href="http://msdn.microsoft.com/en-us/library/export/help/(d=printer)?returnurl=%2fen-us%2flibrary%2fhh439632(d%3dprinter,v%3dvs.85).aspx%3flan%3dcsharp%26cc%3dn%26trm%3dtra%26view%3dbook">
- Export (<span class="count">0</span>)
- </a>
- <a id="isd_print" href="https://msdn.microsoft.com/en-us/library/hh439632(d=printer,v=vs.85).aspx?lan=csharp&cc=n&trm=tra&view=book" rel="nofollow">
- Print
- </a>
- <a id="isd_archiveControl" style="display:none;" data-include-archive="Include Previous Version" data-exclude-archive="Exclude Previous Version">
- </a>
- </div>
-
- <div class="printExportMenus ltr">
- <a id="expandCollapseAll" accesskey="e" href="javascript:void(0)" title="Expand/Collapse all sections by pressing Ctrl + Shift + e">Expand All</a>
- </div>
-
- <div id="body" ms.pgarea="body">
- <span id="tabletView_large"></span>
- <span id="tabletView_small"></span>
- <span id="mobileView"></span>
-
- <div id="content" class="content">
- <input type="hidden" id="printForPab" value="true">
-
- <div class="topic" xmlns="http://www.w3.org/1999/xhtml">
- <h1 class="title">Driver stacks</h1>
-
- <div id="mainSection">
- <div class="clsServerSDKContent">
- </div>
- <p>
- </p><p>Most of the requests that are sent to device drivers are packaged in <a href="https://msdn.microsoft.com/en-us/library/hh439638(v=vs.85).aspx">I/O request packets</a> (IRPs). Each device is represented by a device node, and each device node has a device stack. For more information, see <a href="https://msdn.microsoft.com/en-us/library/ff554721(v=vs.85).aspx">Device nodes and device stacks</a>. To send a read, write, or control request to a device, the I/O manager locates the device node for the device and then sends an IRP to the device stack of that node. Sometimes more than one device stack is involved in processing an I/O request. Regardless of how many device stacks are involved, the overall sequence of drivers that participate in an I/O request is called the <em>driver stack</em> for the request. We also use the term <em>driver stack</em> to refer to the layered set of drivers for a particular technology.</p>
- <h2><a id="I_O_requests_that_are_processed_by_several_device_stacks"></a><a id="i_o_requests_that_are_processed_by_several_device_stacks"></a><a id="I_O_REQUESTS_THAT_ARE_PROCESSED_BY_SEVERAL_DEVICE_STACKS"></a>I/O requests that are processed by several device stacks</h2>
- <p>In some cases, more than one device stack is involved in processing an IRP. The following diagram illustrates a case where four device stacks are involved in processing a single IRP. </p><img id="Chain01" alt="Diagram of four device nodes, each with a device stack" src="./Windows Kernel Development Articles (2016-03-30)_files/IC596026.png" title="Diagram of four device nodes, each with a device stack" xmlns=""><p>Here is how the IRP is processed at each numbered stage in the diagram:</p>
- <ol>
- <li>
- <p>The IRP is created by Disk.sys, which is the function driver in the device stack for the My USB Storage Device node. Disk.sys passes the IRP down the device stack to Usbstor.sys.</p>
- </li>
- <li>Notice that Usbstor.sys is the PDO driver for the My USB Storage Device node and the FDO driver for the USB Mass Storage Device node. At this point, it is not important to decide whether the IRP is owned by the (PDO, Usbstor.sys) pair or the (FDO, Usbstor.sys) pair. The IRP is owned by the driver, Usbstor.sys, and the driver has access to both the PDO and the FDO.</li>
- <li>
- <p>When Usbstor.sys has finished processing the IRP, it passes the IRP to Usbhub.sys. Usbhub.sys is the PDO driver for the USB Mass Storage Device node and the FDO driver for the USB Root Hub node. It is not important to decide whether the IRP is owned by the (PDO, Usbhub.sys) pair or the (FDO, Usbhub.sys) pair. The IRP is owned by the driver, Usbhub.sys, and the driver has access to both the PDO and the FDO.</p>
- </li>
- <li>
- <p>When Usbhub.sys has finished processing the IRP, it passes the IRP to the (Usbuhci.sys, Usbport.sys) pair.</p>
- <p>Usbuhci.sys is a miniport driver, and Usbport.sys is a port driver. The (miniport, port) pair plays the role of a single driver. In this case, both the miniport driver and the port driver are written by Microsoft. The (Usbuhci.sys, Usbport.sys) pair is the PDO driver for the USB Root Hub node, and the (Usbuhci.sys, Usbport.sys) pair is also the FDO driver for the USB Host Controller node. The (Usbuhci.sys, Usbport.sys) pair does the actual communication with the host controller hardware, which in turn communicates with the physical USB storage device.</p>
- </li>
- </ol>
- <h2><a id="The_driver_stack_for_an_I_O_request"></a><a id="the_driver_stack_for_an_i_o_request"></a><a id="THE_DRIVER_STACK_FOR_AN_I_O_REQUEST"></a>The driver stack for an I/O request</h2>
- <p>Consider the sequence of four drivers that participated in the I/O request illustrated in the preceding diagram. We can get another view of the sequence by focusing on the drivers rather than on the device nodes and their individual device stacks. The following diagram shows the drivers in sequence from top to bottom. Notice that Disk.sys is associated with one device object, but each of the other three drivers is associated with two device objects.</p><img id="DriverStack01" alt="Diagram of a driver stack, showing the top driver associated with an FDO only, and the other three drivers associated with a PDO and an FDO" src="./Windows Kernel Development Articles (2016-03-30)_files/IC559047.png" title="Diagram of a driver stack, showing the top driver associated with an FDO only, and the other three drivers associated with a PDO and an FDO" xmlns=""><p>The sequence of drivers that participate in an I/O request is called the <em>driver stack for the I/O request</em>. To illustrate a driver stack for an I/O request, we draw the drivers from top to bottom in the order that they participate in the request.</p>
- <p>Notice that the driver stack for an I/O request is quite different from the device stack for a device node. Also notice that the driver stack for an I/O request does not necessarily remain in one branch of the device tree.</p>
- <h2><a id="Technology_driver_stacks"></a><a id="technology_driver_stacks"></a><a id="TECHNOLOGY_DRIVER_STACKS"></a>Technology driver stacks</h2>
- <p>Consider the driver stack for the I/O request shown in the preceding diagram. If we give each of the drivers a friendly name and make some slight changes to the diagram, we have a block diagram that is similar to many of those that appear in the Windows Driver Kit (WDK) documentation.</p><img id="DriverStack02" alt="Diagram of a driver stack showing friendly names for the drivers: Disk Class Driver on top followed by USB Storage Port Driver, and then USB Hub Driver and (USB 2 Miniport, USB Port) Driver" src="./Windows Kernel Development Articles (2016-03-30)_files/IC559048.png" title="Diagram of a driver stack showing friendly names for the drivers: Disk Class Driver on top followed by USB Storage Port Driver, and then USB Hub Driver and (USB 2 Miniport, USB Port) Driver" xmlns=""><p> In the diagram, the driver stack is divided into three sections. We can think of each section as belonging to a particular technology or to a particular component or portion of the operating system. For example, we might say that the first section at the top of the driver stack belongs to the Volume Manager, the second section belongs to the storage component of the operating system, and the third section belongs to the core USB portion of the operating system.</p>
- <p>Consider the drivers in the third section. These drivers are a subset of a larger set of core USB drivers that Microsoft provides for handling various kinds of USB requests and USB hardware. The following diagram shows what the entire USB core block diagram might look like.</p><img id="TechnologyStack01" alt="Diagram showing the technology driver stack for possible USB core block " src="./Windows Kernel Development Articles (2016-03-30)_files/IC553386.png" title="Diagram showing the technology driver stack for possible USB core block " xmlns=""><p>A block diagram that shows all of the drivers for a particular technology or a particular component or portion of the operating system is called a <em>technology driver stack</em>. Typically, technology driver stacks are given names like the USB Core Driver Stack, the Storage Stack, the 1394 Driver Stack, and the Audio Driver Stack.</p>
- <div class="alert"><strong>Note</strong> The USB core block diagram in this topic shows one of several possible ways to illustrate the technology driver stacks for USB 1.0 and 2.0. For the official diagrams of the USB 1.0, 2.0, and 3.0 driver stacks, see <a href="https://msdn.microsoft.com/en-us/library/hh406256(v=vs.85).aspx">USB Driver Stack Architecture</a>.</div>
- <div> </div>
- <h2><a id="related_topics"></a>Related topics</h2>
- <dl>
- <dt>
- <a href="https://msdn.microsoft.com/en-us/library/ff554721(v=vs.85).aspx">Device nodes and device stacks</a>
- </dt>
- <dt>
- <a href="https://msdn.microsoft.com/en-us/library/hh439643(v=vs.85).aspx">Minidrivers and driver pairs</a>
- </dt>
- <dt>
- <a href="https://msdn.microsoft.com/en-us/library/ff554731(v=vs.85).aspx">Concepts for all driver developers</a>
- </dt>
- </dl>
- <p> </p>
- <p> </p>
- <p><a href="mailto:wsddocfb@microsoft.com?subject=Documentation%20feedback%20[wdkgetstart\wdkgetstart]:%20Driver%20stacks%20%20RELEASE:%20(3/4/2016)&body=%0A%0APRIVACY%20STATEMENT%0A%0AWe%20use%20your%20feedback%20to%20improve%20the%20documentation.%20We%20don%27t%20use%20your%20email%20address%20for%20any%20other%20purpose,%20and%20we%27ll%20remove%20your%20email%20address%20from%20our%20system%20after%20the%20issue%20that%20you%27re%20reporting%20is%20fixed.%20While%20we%27re%20working%20to%20fix%20this%20issue,%20we%20might%20send%20you%20an%20email%20message%20to%20ask%20for%20more%20info.%20Later,%20we%20might%20also%20send%20you%20an%20email%20message%20to%20let%20you%20know%20that%20we%27ve%20addressed%20your%20feedback.%0A%0AFor%20more%20info%20about%20Microsoft%27s%20privacy%20policy,%20see%20http://privacy.microsoft.com/en-us/default.aspx." title="Send comments about this topic to Microsoft">Send comments about this topic to Microsoft</a></p>
- </div>
- </div>
-
- </div>
- </div>
- <div class="clear"></div>
-
- <input name="__RequestVerificationToken" type="hidden" value="CgeUHee47de-1inmYpUWao4YWoU1B-irz9M_EyqE-InS_wWV6IaBrWCSfc4SXMDEx_FtovW0avtyekSqoiy7-WTPPVQ1">
- <input id="ratingValueSubmitUrl" type="hidden" value="https://msdn.microsoft.com/en-us/library/feedback/rate/hh439632(d=printer,v=vs.85).aspx">
- <input id="ratingAdditionalSubmitUrl" type="hidden" value="https://msdn.microsoft.com/en-us/library/feedback/additional/hh439632(d=printer,v=vs.85).aspx">
- <input id="isTopicRated" type="hidden" value="false">
- <div id="lib-footer" ms.pgarea="body">
-
-
- <link type="text/css" rel="stylesheet">
-
- <div id="ux-footer" class="" style="" dir="ltr">
-
- <div id="footerSock" class="librarySock both">
- <div id="footerSockInner">
- <a name="feedback"></a>
- <div class="rating">
- <div id="ratingSection1">
- <div class="title">
- Was this page helpful?
- </div>
- <div class="description">
- Your feedback about this content is important.<br>Let us know what you think.
- </div>
- <div class="buttons">
- <button class="button" id="ratingYes" aria-label="Yes, this page was helpful">Yes</button>
- <button class="button" id="ratingNo" aria-label="No, this page was not helpful">No</button>
- </div>
- <input id="ratingValue" type="hidden" value="">
- </div>
- <div id="ratingSection2">
- <div class="title left">
- Additional feedback?
- </div>
- <textarea id="ratingText" rows="6" cols="" maxlength="1500"></textarea>
- <div class="right">
- <div class="counter">
- <span id="feedbackTextCounter">1500</span> characters remaining
- </div>
- <div class="buttons">
- <button class="button" id="ratingSubmit" aria-label="Submit my additional feedback">Submit</button>
- <button class="button" id="ratingSkipThis" aria-label="Skip additional feedback">Skip this</button>
- </div>
- </div>
- </div>
- <div id="ratingSection3">
- <div class="title">
- Thank you!
- </div>
- <div class="description">
- We appreciate your feedback.
- </div>
- </div>
-
-
- <div id="contentFeedbackQAContainer" style="display: none;"></div>
- </div>
-
- <div class="userVoice">
- <div class="title">
- Help us improve MSDN.
- </div>
- <div class="description">
- Visit our UserVoice Page to submit and vote on ideas!
- </div>
- <div class="buttons">
- <a class="button" id="userVoiceButton" href="http://feedback.msdn.com/forums/257782-msdn-feature-suggestions/category/83975" target="_blank">Make a suggestion</a>
- </div>
- </div>
- <div class="clear"></div>
- </div>
- </div>
- <footer class="top">
- <div data-fragmentname="LeftLinks" id="Fragment_LeftLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Dev centers</div>
- <ul class="links">
- <li>
- <a href="https://dev.windows.com/" id="LeftLinks_2148_1" class="windowsBlue" xmlns="http://www.w3.org/1999/xhtml">Windows</a>
- </li>
- <li>
- <a href="http://dev.office.com/" id="LeftLinks_2148_3" class="office" xmlns="http://www.w3.org/1999/xhtml">Office</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/vstudio" id="LeftLinks_2148_4" class="visualStudio" xmlns="http://www.w3.org/1999/xhtml">Visual Studio</a>
- </li>
- <li>
- <a href="http://azure.microsoft.com/en-us/documentation/" target="_blank" id="LeftLinks_2148_12" xmlns="http://www.w3.org/1999/xhtml">Microsoft Azure</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/developer-centers-msdn" id="LeftLinks_2148_5" xmlns="http://www.w3.org/1999/xhtml">More...</a>
- </li>
- </ul>
- </div>
- </div>
- <div id="rightLinks">
- <div data-fragmentname="CenterLinks1" id="Fragment_CenterLinks1" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Learning resources</div>
- <ul class="links">
- <li>
- <a href="http://www.microsoftvirtualacademy.com/" id="CenterLinks1_2151_4" xmlns="http://www.w3.org/1999/xhtml">Microsoft Virtual Academy</a>
- </li>
- <li>
- <a href="http://channel9.msdn.com/" id="CenterLinks1_2151_5" xmlns="http://www.w3.org/1999/xhtml">Channel 9</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/magazine/" id="CenterLinks1_2151_7" xmlns="http://www.w3.org/1999/xhtml">MSDN Magazine</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks2" id="Fragment_CenterLinks2" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Community</div>
- <ul class="links">
- <li>
- <a href="https://social.msdn.microsoft.com/forums/en-us/home" id="CenterLinks2_2151_8" xmlns="http://www.w3.org/1999/xhtml">Forums</a>
- </li>
- <li>
- <a href="http://blogs.msdn.com/b/developer-tools/" id="CenterLinks2_2151_9" xmlns="http://www.w3.org/1999/xhtml">Blogs</a>
- </li>
- <li>
- <a href="http://www.codeplex.com/" id="CenterLinks2_2151_10" xmlns="http://www.w3.org/1999/xhtml">Codeplex</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks3" id="Fragment_CenterLinks3" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Support</div>
- <ul class="links">
- <li>
- <a href="https://msdn.microsoft.com/hh361695" id="CenterLinks3_2151_11" xmlns="http://www.w3.org/1999/xhtml">Self support</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks4" id="Fragment_CenterLinks4" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Programs</div>
- <ul class="links">
- <li>
- <a href="https://www.microsoft.com/bizspark/" id="CenterLinks4_2151_13" xmlns="http://www.w3.org/1999/xhtml">BizSpark (for startups)</a>
- </li>
- <li>
- <a href="https://www.dreamspark.com/" id="CenterLinks4_2151_14" xmlns="http://www.w3.org/1999/xhtml">DreamSpark</a>
- </li>
- <li>
- <a href="http://www.imaginecup.com/" id="CenterLinks4_2151_17" xmlns="http://www.w3.org/1999/xhtml">Imagine Cup</a>
- </li>
- </ul>
- </div>
- </div>
- </div>
- </footer>
- <footer class="bottom">
- <span class="localeContainer">
-
- <form class="selectLocale" id="selectLocaleForm" action="https://msdn.microsoft.com/en-us/selectlocale-dmc">
- <input type="hidden" name="fromPage" value="https%3a%2f%2fmsdn.microsoft.com%2fen-us%2flibrary%2fhh439632(d%3dprinter%2cv%3dvs.85).aspx%3flan%3dCSharp%26cc%3dn%26trm%3dtra%26view%3dbook">
- <a href="http://msdn.microsoft.com/#" onclick="$('#selectLocaleForm').submit();return false;" title="Change your language">United States (English)</a>
- </form>
- </span>
- <div data-fragmentname="BottomLinks" id="Fragment_BottomLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <ul class="links horizontal">
- <li>
- <a href="https://msdn.microsoft.com/newsletter.aspx" id="BottomLinks_2148_7" xmlns="http://www.w3.org/1999/xhtml">Newsletter</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/dn529288" id="BottomLinks_2148_8" xmlns="http://www.w3.org/1999/xhtml">Privacy & cookies</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/cc300389" id="BottomLinks_2148_9" xmlns="http://www.w3.org/1999/xhtml">Terms of use</a>
- </li>
- <li>
- <a href="https://www.microsoft.com/en-us/legal/intellectualproperty/Trademarks/EN-US.aspx" id="BottomLinks_2148_10" xmlns="http://www.w3.org/1999/xhtml">Trademarks</a>
- </li>
- </ul>
- </div>
- </div>
- <span class="logoLegal">
- <span class="logo"></span>
- <span class="copyright">© 2016 Microsoft</span>
- </span>
- </footer>
- </div>
-
- </div>
- <div class="footerPrintView">
- <div class="footerCopyrightPrintView">© 2016 Microsoft</div>
- </div>
-
-
-
-
- <input id="tocPaddingPerLevel" type="hidden" value="17">
- <input id="MtpsDevice" type="hidden" value="Printer">
- <!--[CDATA[ Third party scripts and code linked to or referenced from this website are licensed to you by the parties that own such code, not by Microsoft. See ASP.NET Ajax CDN Terms of Use – http://www.asp.net/ajaxlibrary/CDN.ashx. ]]-->
-
-
-
-
-
- <noscript><div><img alt="DCSIMG" id="Img1" width="1" height="1" src="https://m.webtrends.com/dcsmgru7m99k7mqmgrhudo0k8_8c6m/njs.gif?dcsuri=/nojavascript&amp;WT.js=No" /></div></noscript>
- <div id="globalRequestVerification">
- <input name="__RequestVerificationToken" type="hidden" value="uyL6T2D0J5N4AhTTzSN3c-ODWarbKxq8eppbKe9Q_rYQaMvbPZ7zmGTSMGkCYbT7wCEpf8e8wu2tbb6fI4g078oXvdQ1">
- </div>
- </div>
-
-
-
-
-
-
- <script type="text/javascript" class="mtps-injected">
- /*<![CDATA[*/
- (function(window,document){"use strict";function preload(scripts){for(var result=[],script,e,i=0;i<scripts.length;i++)script=scripts[i],script.hasOwnProperty("url")&&(e=document.createElement("script"),e.src=script.url,script.throwaway=e),result.push(script);return result}function inject(scripts,index){var script,elem;if(index>=scripts.length){delete mtps.injectScripts;return}script=scripts[index];elem=document.createElement("script");elem.className="mtps-injected";elem.async=!1;var isLoaded=!1,timeoutId=0,injectNextFnName="",injectNext=elem.onerror=function(){isLoaded||(isLoaded=!0,inject(scripts,index+1),window.clearTimeout(timeoutId),elem.onload=elem.onerror=elem.onreadystatechange=null,injectNextFnName&&delete mtps[injectNextFnName],elem.removeEventListener&&elem.removeEventListener("load",injectNext,!1))};elem.addEventListener?elem.addEventListener("load",injectNext,!1):elem.readyState==="uninitialized"?elem.onreadystatechange=function(){(this.readyState==="loaded"||this.readyState==="complete")&&injectNext()}:elem.onload=injectNext;script.hasOwnProperty("url")?(timeoutId=window.setTimeout(injectNext,12e4),elem.src=script.url):(injectNextFnName="_injectNextScript_"+index,mtps[injectNextFnName]=injectNext,timeoutId=window.setTimeout(injectNext,2e3),elem.text="try {\n"+script.txt+"\n} finally { MTPS."+injectNextFnName+" && MTPS."+injectNextFnName+"(); }");parent.appendChild(elem)}var mtps=window.MTPS||(window.MTPS={}),parent=document.getElementsByTagName("head")[0];mtps.injectScripts=function(scripts){inject(preload(scripts),0)}})(window,document);
- MTPS.injectScripts([
- { txt: "/**/\r\n(window.MTPS || (window.MTPS = {})).cdnDomains || (window.MTPS.cdnDomains = { \r\n\t\"image\": \"https://i-msdn.sec.s-msft.com\", \r\n\t\"js\": \"https://i2-msdn.sec.s-msft.com\", \r\n\t\"css\": \"https://i-msdn.sec.s-msft.com\", \r\n\t\"ttf\": \"https://i-msdn.sec.s-msft.com\"\r\n});\r\n/**/" },
- { txt: "//\n var literalNormalizedUrl = \u0027/en-us/library/hh439632(d=printer,l=en-us,v=vs.85).aspx\u0027;\n var wt_nvr_ru = \u0027WT_NVR_RU\u0027;\n var wt_fpcdom = \u0027.microsoft.com\u0027;\n var wt_domlist = \u0027msdn.microsoft.com\u0027;\n var wt_pathlist = \u0027\u0027;\n var wt_paramlist = \u0027DCSext.mtps_devcenter\u0027;\n var wt_siteid = \u0027MSDN\u0027;\n var gDomain = \u0027m.webtrends.com\u0027;\n var gDcsId = \u0027dcsmgru7m99k7mqmgrhudo0k8_8c6m\u0027;\n var gFpc = \u0027WT_FPC\u0027;\n\n\n\n if (document.cookie.indexOf(gFpc + \"=\") == -1) {\n var wtidJs = document.createElement(\"script\");\n wtidJs.src = \"//\" + gDomain + \"/\" + gDcsId + \"/wtid.js\";\n document.getElementsByTagName(\"head\")[0].appendChild(wtidJs);\n }\n\n\n\n var detectedLocale = \u0027en-us\u0027;\n var wtsp = \u0027msdnlib_w32_com\u0027;\n var gTrackEvents = \u00270\u0027;\n/**/" },
- { txt: "//\n\n window.appInsightsId = \u00275eb1b2eb-c47a-497a-a7ac-a1c230b2882f\u0027;\n //" },
- { url: "https://i2-msdn.sec.s-msft.com/Combined.js?resources=0:Utilities,1:Layout,2:Header,1:Rating,2:Footer,0:Topic,3:PabTopic,4:webtrendsscript,0:AppInsightsPerf,0:ABTestControl,5:WEDCS,3:CmpgrpForHeader,0:livefyre,0:Comment,1:SearchBox;/Areas/Epx/Content/Scripts:0,/Areas/Epx/Themes/Base/Content:1,/Areas/Centers/Themes/StandardDevCenter/Content:2,/Areas/Library/Content:3,/Areas/Global/Content/Webtrends/resources:4,/Areas/Library/Themes/Base/Content:5\u0026amp;hashKey=30CEE944AABFEA2C5A338BDB9E000732\u0026amp;v=AE608271C0243AAA0449D3BC0FAD8EB4" },
- { url: "https://i1.services.social.microsoft.com/search/Widgets/SearchBox.jss?boxid=HeaderSearchTextBox\u0026btnid=HeaderSearchButton\u0026pgArea=header\u0026brand=Msdn\u0026loc=en-us\u0026focusOnInit=false\u0026emptyWatermark=true\u0026searchButtonTooltip=Search MSDN" },
- { url: "https://i2-msdn.sec.s-msft.com/Combined.js?resources=0:PrintExportButton,1:Toc_Fixed,1:CodeSnippet,1:TopicNotInScope,1:CollapsibleArea,1:VersionSelector,1:SurveyBroker;/Areas/Library/Themes/Base/Content:0,/Areas/Epx/Content/Scripts:1\u0026amp;hashKey=80F30894E3FB8A3295C923AEC7019CFE\u0026amp;v=AE608271C0243AAA0449D3BC0FAD8EB4" },
- { txt: "$(document).ready(function() {\n try {\n var token = $(\"#globalRequestVerification input[name=\u0027__RequestVerificationToken\u0027]\").clone();\n $(\"#siteFeedbackForm\").append(token);\n } catch(err) {\n \n }\n });" }
- ]);
- /*]]>*/
- </script>
- <link rel="stylesheet" type="text/css" href="./Windows Kernel Development Articles (2016-03-30)_files/Combined.css">
- <div id="page">
-
-
-
-
- <link type="text/css" rel="stylesheet">
-
- <input type="hidden" id="isHeaderBleeding" value="true">
- <div id="ux-header" dir="ltr" class="ltr msdn">
-
- <header>
- <span id="singleCol"></span>
- <span id="doubleCol"></span>
- <span id="isMobile"></span>
- <div>
- <div class="row topRow">
- <div class="top">
- <div class="left">
- <a class="msdnLogoImg" href="https://msdn.microsoft.com/en-us" title="MSDN home">
- <div id="msft-logo" class="msft-logo"></div>
- </a>
- <div class="GrayPipe"></div>
- <a class="DevCenterFullNameNonMegaBlade" href="https://msdn.microsoft.com/en-us">Developer Network</a>
- <a class="DevCenterFullName" href="https://msdn.microsoft.com/en-us">Developer Network</a>
- <a class="DevCenterShortName" href="https://msdn.microsoft.com/en-us">Developer</a>
- </div>
- <div class="right">
- <div id="signIn">
- <div class="profileImage"></div>
- <a class="scarabLink" href="https://login.live.com/login.srf?wa=wsignin1.0&rpsnv=12&ct=1459376408&rver=6.0.5276.0&wp=mcmbi&wlcxt=msdn%24msdn%24msdn&wreply=https%3a%2f%2fmsdn.microsoft.com%2fen-us%2flibrary%2fhh439643%2528d%3dprinter%2cv%3dvs.85%2529.aspx%3flan%3dcsharp%26cc%3dn%26trm%3dtra%26view%3dbook&lc=1033&id=254354&mkt=en-us" title="Sign in">Sign in</a></div>
- <div class="auxNav">
- <div>
- <div data-fragmentname="Subscriptions" id="Fragment_Subscriptions" xmlns="http://www.w3.org/1999/xhtml">
- <a href="https://msdn.microsoft.com/subscriptions/manage/hh442900" id="Subscriptions_2153_1" xmlns="http://www.w3.org/1999/xhtml">MSDN subscriptions</a>
- </div>
- <div data-fragmentname="GetTools" id="Fragment_GetTools" xmlns="http://www.w3.org/1999/xhtml">
- <a href="http://go.microsoft.com/fwlink/?LinkId=309297&clcid=0x409&slcid=0x409&campaign=o~msft~msdn~gettools-header~dn308572" id="GetTools_2153_3" xmlns="http://www.w3.org/1999/xhtml">Get tools</a>
- </div>
- </div>
- <div>
- <div data-fragmentname="SocialLinks" id="Fragment_SocialLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <ul class="links horizontal">
- <li>
- <a href="http://www.facebook.com/microsoftdeveloper" target="_blank" id="SocialLinks_2152_4" class="facebook" xmlns="http://www.w3.org/1999/xhtml">http://www.facebook.com/microsoftdeveloper</a>
- </li>
- <li>
- <a href="https://twitter.com/msdev" target="_blank" id="SocialLinks_2152_5" class="twitter" xmlns="http://www.w3.org/1999/xhtml">https://twitter.com/msdev</a>
- </li>
- <li>
- <a href="http://plus.google.com/111221966647232053570/" target="_blank" id="SocialLinks_2152_6" class="googlePlus" xmlns="http://www.w3.org/1999/xhtml">http://plus.google.com/111221966647232053570/</a>
- </li>
- </ul>
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- <div class="row middleRow">
- <div class="expandTop">
- <div class="left"></div>
- <div class="right"></div>
- </div>
- </div>
- </div>
- <div id="buttomRowWrapper" class="bg_default">
- <div class="row buttomRow bg_default">
- <div class="bottom">
- <div class="left">
- <a id="grip" class="menu-icon" href="javascript:void(0)"></a>
-
- <div id="drawer">
- <div class="toc">
-
- <nav>
- <ul class="navL1">
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Technologies">Technologies</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/cloud-app-development-msdn" title="Cloud">Cloud</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/app-development-msdn" title="App Development">App Development</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/web-app-development-msdn" title="Web">Web</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/big-data-development-msdn" title="Data">Data</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/games-development-msdn" title="Gaming">Gaming</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/internetofthings" title="Internet of Things">Internet of Things</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Downloads">Downloads</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://www.visualstudio.com/downloads/download-visual-studio-vs" title="Visual Studio">Visual Studio</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/subscriptions" title="MSDN subscription access">MSDN subscription access</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/microsoft-sdks-msdn" title="SDKs">SDKs</a>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Trial software">Trial software</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/evalcenter" title="Free downloads">Free downloads</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/officeevaluationresources" title="Office resources">Office resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/sharepoint2013resources" title="SharePoint Server 2013 resources">SharePoint Server 2013 resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/sqlserver2014expressresources" title="SQL Server 2014 Express resources">SQL Server 2014 Express resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/windowsserver2012r2resources" title="Windows Server 2012 resources">Windows Server 2012 resources</a>
- </li>
- </ul>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Programs">Programs</a>
- <ul class="navL2">
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Visual Studio subscriptions">Visual Studio subscriptions</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/msdn-subscriptions-overview" title="Overview">Overview</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/benefits-overview" title="Benefits">Benefits</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/msdn-subscriptions-administration" title="Administrators">Administrators</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Students">Students</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/imagine/imagine-home" title="Microsoft Imagine">Microsoft Imagine</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/microsoftstudentpartners" title="Microsoft Student Partners">Microsoft Student Partners</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Architects">Architects</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-overview-msdn" title="Overview">Overview</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-case-studies-msdn" title="Case studies">Case studies</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-blueprints-msdn" title="Blueprints">Blueprints</a>
- </li>
- <li class="inactive">
- <a href="http://blogs.msdn.com/b/msarchitecture/" title="Blog">Blog</a>
- </li>
- <li class="inactive">
- <a href="http://social.msdn.microsoft.com/forums/en-us/home?brandignore=true&sort=relevancedesc&searchterm=architecture+or+architect" title="Forums">Forums</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/applicationbuilder" title="ISV">ISV</a>
-
- </li>
- <li class="inactive">
- <a href="https://www.microsoft.com/bizspark" title="Startups">Startups</a>
-
- </li>
- <li class="inactive">
- <a href="https://rewards.msdn.microsoft.com/" title="TechRewards">TechRewards</a>
-
- </li>
- <li class="inactive">
- <a href="http://events.msdn.microsoft.com/" title="Events">Events</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Community">Community</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/magazine/dd767791" title="Magazine">Magazine</a>
-
- </li>
- <li class="inactive">
- <a href="https://social.msdn.microsoft.com/forums/" title="Forums">Forums</a>
-
- </li>
- <li class="inactive">
- <a href="http://blogs.msdn.com/b/developer-tools/" title="Blogs">Blogs</a>
-
- </li>
- <li class="inactive">
- <a href="http://tech-advisors.msdn.microsoft.com/en-us" title="Tech Advisors">Tech Advisors</a>
-
- </li>
- <li class="inactive">
- <a href="http://channel9.msdn.com/" title="Channel 9">Channel 9</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive current toggle">
- <a href="javascript:void(0)" title="Documentation">Documentation</a>
- <ul class="navL2">
- <li class="inactive current">
- <a href="https://msdn.microsoft.com/library" title="APIs and reference">APIs and reference</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/developer-centers-msdn" title="Dev centers">Dev centers</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive">
- <a href="https://code.msdn.microsoft.com/" title="Samples">Samples</a>
- </li>
- </ul>
- </nav>
- </div>
- </div>
- </div>
- <div class="right">
- <div data-fragmentname="SearchBox" id="Fragment_SearchBox" xmlns="http://www.w3.org/1999/xhtml">
- <div class="SearchBox">
- <form id="HeaderSearchForm" name="HeaderSearchForm" method="get">
- <button id="FakeHeaderSearchButton" value="Search" type="submit" class="header-search-button">
- <div id="search-finder" class="search-finder"></div>
- </button>
- <button id="HeaderSearchButton" style="display:none"></button>
- <div id="searchSplitter"></div>
- <div id="searchCloseIcon" class="search-clear-x"></div>
- <div id="searchTextContainer" style="width: 0;">
- <input id="HeaderSearchTextBox" name="query" type="text" maxlength="200" onfocus="Epx.Controls.SearchBox.watermarkFocus(event, this.title)" onblur="Epx.Controls.SearchBox.watermarkBlur(event, this.title)">
- </div>
- </form>
-
-
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- </header>
- </div>
-
-
-
- <div class="printExportMenus ltr">
- <a id="isd_printABook" href="http://msdn.microsoft.com/en-us/library/export/help/(d=printer)?returnurl=%2fen-us%2flibrary%2fhh439643(d%3dprinter,v%3dvs.85).aspx%3flan%3dcsharp%26cc%3dn%26trm%3dtra%26view%3dbook">
- Export (<span class="count">0</span>)
- </a>
- <a id="isd_print" href="https://msdn.microsoft.com/en-us/library/hh439643(d=printer,v=vs.85).aspx?lan=csharp&cc=n&trm=tra&view=book" rel="nofollow">
- Print
- </a>
- <a id="isd_archiveControl" style="display:none;" data-include-archive="Include Previous Version" data-exclude-archive="Exclude Previous Version">
- </a>
- </div>
-
- <div class="printExportMenus ltr">
- <a id="expandCollapseAll" accesskey="e" href="javascript:void(0)" title="Expand/Collapse all sections by pressing Ctrl + Shift + e">Expand All</a>
- </div>
-
- <div id="body" ms.pgarea="body">
- <span id="tabletView_large"></span>
- <span id="tabletView_small"></span>
- <span id="mobileView"></span>
-
- <div id="content" class="content">
- <input type="hidden" id="printForPab" value="true">
-
- <div class="topic" xmlns="http://www.w3.org/1999/xhtml">
- <h1 class="title">Minidrivers, Miniport drivers, and driver pairs</h1>
-
- <div id="mainSection">
- <div class="clsServerSDKContent">
- </div>
- <p></p>
- <p>A minidriver or a miniport driver acts as half of a driver pair. Driver pairs like (miniport, port) can make driver development easier. In a driver pair, one driver handles general tasks that are common to a whole collection of devices, while the other driver handles tasks that are specific to an individual device. The drivers that handle device-specific tasks go by a variety of names, including miniport driver, miniclass driver, and minidriver.</p>
- <p>Microsoft provides the general driver, and typically an independent hardware vendor provides the specific driver. Before you read this topic, you should understand the ideas presented in <a href="https://msdn.microsoft.com/en-us/library/ff554721(v=vs.85).aspx">Device nodes and device stacks</a> and <a href="https://msdn.microsoft.com/en-us/library/hh439638(v=vs.85).aspx">I/O request packets</a>.</p>
- <p>Every kernel-mode driver must implement a function named <a href="https://msdn.microsoft.com/en-us/library/ff544113(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">DriverEntry</strong></a>, which gets called shortly after the driver is loaded. The <strong>DriverEntry</strong> function fills in certain members of a <a href="https://msdn.microsoft.com/en-us/library/ff544174(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">DRIVER_OBJECT</strong></a> structure with pointers to several other functions that the driver implements. For example, the <strong>DriverEntry</strong> function fills in the <strong>Unload</strong> member of the <strong>DRIVER_OBJECT</strong> structure with a pointer to the driver's <a href="https://msdn.microsoft.com/en-us/library/ff564886(v=vs.85).aspx"><em xmlns="http://www.w3.org/1999/xhtml">Unload</em></a> function, as shown in the following diagram.</p><img id="DriverFunctionPointers02" alt="Diagram showing the DRIVER_OBJECT structure with the Unload member" src="./Windows Kernel Development Articles (2016-03-30)_files/IC553387.png" title="Diagram showing the DRIVER_OBJECT structure with the Unload member" xmlns=""><p>The <strong>MajorFunction</strong> member of the <a href="https://msdn.microsoft.com/en-us/library/ff544174(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">DRIVER_OBJECT</strong></a> structure is an array of pointers to functions that handle I/O request packets (<a href="https://msdn.microsoft.com/en-us/library/ff550694(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">IRP</strong></a>s), as shown in the following diagram. Typically the driver fills in several members of the <strong>MajorFunction</strong> array with pointers to functions (implemented by the driver) that handle various kinds of IRPs. </p><img id="DriverFunctionPointers03" alt="Diagram showing the DRIVER_OBJECT structure with the MajorFunction member" src="./Windows Kernel Development Articles (2016-03-30)_files/IC553388.png" title="Diagram showing the DRIVER_OBJECT structure with the MajorFunction member" xmlns=""><p>An IRP can be categorized according to its major function code, which is identified by a constant, such as <strong>IRP_MJ_READ</strong>, <strong>IRP_MJ_WRITE</strong>, or <strong>IRP_MJ_PNP</strong>. The constants that identify major function code serve as indices in the <strong>MajorFunction</strong> array. For example, suppose the driver implements a dispatch function to handle IRPs that have the major function code <strong>IRP_MJ_WRITE</strong>. In this case, the driver must fill in the <strong>MajorFunction</strong>[IRP_MJ_WRITE] element of the array with a pointer to the dispatch function.</p>
- <p>Typically the driver fills in some of the elements of the <strong>MajorFunction</strong> array and leaves the remaining elements set to default values provided by the I/O manager. The following example shows how to use the <a href="https://msdn.microsoft.com/en-us/library/ff562408(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">!drvobj</strong></a> debugger extension to inspect the function pointers for the parport driver.</p>
- <div id="code-snippet-1" class="codeSnippetContainer" xmlns="http://www.w3.org/1999/xhtml">
- <div class="codeSnippetContainerTabs">
- <div class="codeSnippetContainerTab codeSnippetContainerTabActive" dir="ltr">
- <a></a>
- </div>
- </div>
- <div class="codeSnippetContainerCodeContainer">
- <div class="codeSnippetToolBar"></div>
- <div class="codeSnippetContainerCode" dir="ltr">
- <div style="color:Black;"><pre>0: kd> !drvobj parport 2
- Driver object (fffffa80048d9e70) is for:
- \Driver\Parport
- DriverEntry: fffff880065ea070 parport!GsDriverEntry
- DriverStartIo: 00000000
- DriverUnload: fffff880065e131c parport!PptUnload
- AddDevice: fffff880065d2008 parport!P5AddDevice
- Dispatch routines:
- [00] IRP_MJ_CREATE fffff880065d49d0 parport!PptDispatchCreateOpen
- [01] IRP_MJ_CREATE_NAMED_PIPE fffff80001b6ecd4 nt!IopInvalidDeviceRequest
- [02] IRP_MJ_CLOSE fffff880065d4a78 parport!PptDispatchClose
- [03] IRP_MJ_READ fffff880065d4bac parport!PptDispatchRead
- [04] IRP_MJ_WRITE fffff880065d4bac parport!PptDispatchRead
- [05] IRP_MJ_QUERY_INFORMATION fffff880065d4c40 parport!PptDispatchQueryInformation
- [06] IRP_MJ_SET_INFORMATION fffff880065d4ce4 parport!PptDispatchSetInformation
- [07] IRP_MJ_QUERY_EA fffff80001b6ecd4 nt!IopInvalidDeviceRequest
- [08] IRP_MJ_SET_EA fffff80001b6ecd4 nt!IopInvalidDeviceRequest
- [09] IRP_MJ_FLUSH_BUFFERS fffff80001b6ecd4 nt!IopInvalidDeviceRequest
- [0a] IRP_MJ_QUERY_VOLUME_INFORMATION fffff80001b6ecd4 nt!IopInvalidDeviceRequest
- [0b] IRP_MJ_SET_VOLUME_INFORMATION fffff80001b6ecd4 nt!IopInvalidDeviceRequest
- [0c] IRP_MJ_DIRECTORY_CONTROL fffff80001b6ecd4 nt!IopInvalidDeviceRequest
- [0d] IRP_MJ_FILE_SYSTEM_CONTROL fffff80001b6ecd4 nt!IopInvalidDeviceRequest
- [0e] IRP_MJ_DEVICE_CONTROL fffff880065d4be8 parport!PptDispatchDeviceControl
- [0f] IRP_MJ_INTERNAL_DEVICE_CONTROL fffff880065d4c24 parport!PptDispatchInternalDeviceControl
- [10] IRP_MJ_SHUTDOWN fffff80001b6ecd4 nt!IopInvalidDeviceRequest
- [11] IRP_MJ_LOCK_CONTROL fffff80001b6ecd4 nt!IopInvalidDeviceRequest
- [12] IRP_MJ_CLEANUP fffff880065d4af4 parport!PptDispatchCleanup
- [13] IRP_MJ_CREATE_MAILSLOT fffff80001b6ecd4 nt!IopInvalidDeviceRequest
- [14] IRP_MJ_QUERY_SECURITY fffff80001b6ecd4 nt!IopInvalidDeviceRequest
- [15] IRP_MJ_SET_SECURITY fffff80001b6ecd4 nt!IopInvalidDeviceRequest
- [16] IRP_MJ_POWER fffff880065d491c parport!PptDispatchPower
- [17] IRP_MJ_SYSTEM_CONTROL fffff880065d4d4c parport!PptDispatchSystemControl
- [18] IRP_MJ_DEVICE_CHANGE fffff80001b6ecd4 nt!IopInvalidDeviceRequest
- [19] IRP_MJ_QUERY_QUOTA fffff80001b6ecd4 nt!IopInvalidDeviceRequest
- [1a] IRP_MJ_SET_QUOTA fffff80001b6ecd4 nt!IopInvalidDeviceRequest
- [1b] IRP_MJ_PNP fffff880065d4840 parport!PptDispatchPnp
- </pre></div>
- </div>
- </div>
- </div>
- <p>In the debugger output, you can see that parport.sys implements <strong>GsDriverEntry</strong>, the entry point for the driver. <strong>GsDriverEntry</strong>, which was generated automatically when the driver was built, performs some initialization and then calls <a href="https://msdn.microsoft.com/en-us/library/ff544113(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">DriverEntry</strong></a>, which was implemented by the driver developer.</p>
- <p>You can also see that the parport driver (in its <a href="https://msdn.microsoft.com/en-us/library/ff544113(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">DriverEntry</strong></a> function) provides pointers to dispatch functions for these major function codes:</p>
- <ul>
- <li>IRP_MJ_CREATE</li>
- <li>IRP_MJ_CLOSE</li>
- <li>IRP_MJ_READ</li>
- <li>IRP_MJ_WRITE</li>
- <li>IRP_MJ_QUERY_INFORMATION</li>
- <li>IRP_MJ_SET_INFORMATION</li>
- <li>IRP_MJ_DEVICE_CONTROL</li>
- <li>IRP_MJ_INTERNAL_DEVICE_CONTROL</li>
- <li>IRP_MJ_CLEANUP</li>
- <li>IRP_MJ_POWER</li>
- <li>IRP_MJ_SYSTEM_CONTROL</li>
- <li>IRP_MJ_PNP</li>
- </ul>
- <p>The remaining elements of the <strong>MajorFunction</strong> array hold pointers to the default dispatch function <strong>nt!IopInvalidDeviceRequest</strong>.</p>
- <p>In the debugger output, you can see that the parport driver provided function pointers for <a href="https://msdn.microsoft.com/en-us/library/ff564886(v=vs.85).aspx"><em xmlns="http://www.w3.org/1999/xhtml">Unload</em></a> and <a href="https://msdn.microsoft.com/en-us/library/ff540521(v=vs.85).aspx"><em xmlns="http://www.w3.org/1999/xhtml">AddDevice</em></a>, but did not provide a function pointer for <a href="https://msdn.microsoft.com/en-us/library/ff563858(v=vs.85).aspx"><em xmlns="http://www.w3.org/1999/xhtml">StartIo</em></a>. The <em>AddDevice</em> function is unusual because its function pointer is not stored in the <a href="https://msdn.microsoft.com/en-us/library/ff544174(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">DRIVER_OBJECT</strong></a> structure. Instead, it is stored in the <strong>AddDevice</strong> member of an extension to the <strong>DRIVER_OBJECT</strong> structure. The following diagram illustrates the function pointers that the parport driver provided in its <a href="https://msdn.microsoft.com/en-us/library/ff544113(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">DriverEntry</strong></a> function. The function pointers provided by parport are shaded.</p><img id="DriverFunctionPointers01" alt="Diagram of function pointers in a DRIVER_OBJECT structure" src="./Windows Kernel Development Articles (2016-03-30)_files/IC553389.png" title="Diagram of function pointers in a DRIVER_OBJECT structure" xmlns=""><h2><a id="Making_it_easier_by_using_driver_pairs"></a><a id="making_it_easier_by_using_driver_pairs"></a><a id="MAKING_IT_EASIER_BY_USING_DRIVER_PAIRS"></a>Making it easier by using driver pairs</h2>
- <p>Over a period of time, as driver developers inside and outside of Microsoft gained experience with the Windows Driver Model (WDM), they realized a couple of things about dispatch functions:</p>
- <ul>
- <li>Dispatch functions are largely boilerplate. For example, much of the code in the dispatch function for IRP_MJ_PNP is the same for all drivers. It is only a small portion of the Plug and Play (PnP) code that is specific to an individual driver that controls an individual piece of hardware.</li>
- <li>Dispatch functions are complicated and difficult to get right. Implementing features like thread synchronization, IRP queuing, and IRP cancellation is challenging and requires a deep understanding of how the operating system works.</li>
- </ul>
- <p>To make things easier for driver developers, Microsoft created several technology-specific driver models. At first glance, the technology-specific models seem quite different from each other, but a closer look reveals that many of them are based on this paradigm:</p>
- <ul>
- <li>The driver is split into two pieces: one that handles the general processing and one that handles processing specific to a particular device.</li>
- <li>The general piece is written by Microsoft.</li>
- <li>The specific piece may be written by Microsoft or an independent hardware vendor.</li>
- </ul>
- <p>Suppose that the Proseware and Contoso companies both make a toy robot that requires a WDM driver. Also suppose that Microsoft provides a General Robot Driver called GeneralRobot.sys. Proseware and Contoso can each write small drivers that handle the requirements of their specific robots. For example, Proseware could write ProsewareRobot.sys, and the pair of drivers (ProsewareRobot.sys, GeneralRobot.sys) could be combined to form a single WDM driver. Likewise, the pair of drivers (ContosoRobot.sys, GeneralRobot.sys) could combine to form a single WDM driver. In its most general form, the idea is that you can create drivers by using (specific.sys, general.sys) pairs.</p>
- <h2><a id="Function_pointers_in_driver_pairs"></a><a id="function_pointers_in_driver_pairs"></a><a id="FUNCTION_POINTERS_IN_DRIVER_PAIRS"></a>Function pointers in driver pairs</h2>
- <p> In a (specific.sys, general.sys) pair, Windows loads specific.sys and calls its <a href="https://msdn.microsoft.com/en-us/library/ff544113(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">DriverEntry</strong></a> function. The <strong>DriverEntry</strong> function of specific.sys receives a pointer to a <a href="https://msdn.microsoft.com/en-us/library/ff544174(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">DRIVER_OBJECT</strong></a> structure. Normally you would expect <strong>DriverEntry</strong> to fill in several elements of the <strong>MajorFunction</strong> array with pointers to dispatch functions. Also you would expect <strong>DriverEntry</strong> to fill in the <strong>Unload</strong> member (and possibly the <strong>StartIo</strong> member) of the <strong>DRIVER_OBJECT</strong> structure and the <strong>AddDevice</strong> member of the driver object extension. However, in a driver pair model, <strong>DriverEntry</strong> does not necessarily do this. Instead the <strong>DriverEntry</strong> function of specific.sys passes the <strong>DRIVER_OBJECT</strong> structure along to an initialization function implemented by general.sys. The following code example shows how the initialization function might be called in the (ProsewareRobot.sys, GeneralRobot.sys) pair.</p>
- <div id="code-snippet-2" class="codeSnippetContainer" xmlns="http://www.w3.org/1999/xhtml">
- <div class="codeSnippetContainerTabs">
- <div class="codeSnippetContainerTab codeSnippetContainerTabActive" dir="ltr">
- <a>C++</a>
- </div>
- </div>
- <div class="codeSnippetContainerCodeContainer">
- <div class="codeSnippetToolBar"></div>
- <div class="codeSnippetContainerCode" dir="ltr">
- <div style="color:Black;"><pre>
- PVOID g_ProsewareRobottCallbacks[3] = {DeviceControlCallback, PnpCallback, PowerCallback};
- <span style="color:Green;">// DriverEntry function in ProsewareRobot.sys</span>
- NTSTATUS DriverEntry (DRIVER_OBJECT *DriverObject, PUNICODE_STRING RegistryPath)
- {
- <span style="color:Green;">// Call the initialization function implemented by GeneralRobot.sys.</span>
- <span style="color:Blue;">return</span> GeneralRobotInit(DriverObject, RegistryPath, g_ProsewareRobottCallbacks);
- }
- </pre></div>
- </div>
- </div>
- </div>
- <p>The initialization function in GeneralRobot.sys writes function pointers to the appropriate members of the <a href="https://msdn.microsoft.com/en-us/library/ff544174(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">DRIVER_OBJECT</strong></a> structure (and its extension) and the appropriate elements of the <strong>MajorFunction</strong> array. The idea is that when the I/O manager sends an IRP to the driver pair, the IRP goes first to a dispatch function implemented by GeneralRobot.sys. If GeneralRobot.sys can handle the IRP on its own, then the specific driver, ProsewareRobot.sys, does not have to be involved. If GeneralRobot.sys can handle some, but not all, of the IRP processing, it gets help from one of the callback functions implemented by ProsewareRobot.sys. GeneralRobot.sys receives pointers to the ProsewareRobot callbacks in the GeneralRobotInit call.</p>
- <p>At some point after <a href="https://msdn.microsoft.com/en-us/library/ff544113(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">DriverEntry</strong></a> returns, a device stack gets constructed for the Proseware Robot device node. The device stack might look like this.</p><img id="driverpairs01" alt="Diagram of the Proseware Robot device node, showing three device objects in the device stack: AfterThought.sys (Filter DO), ProsewareRobot.sys, GeneralRobot.sys (FDO), and Pci.sys (PDO)" src="./Windows Kernel Development Articles (2016-03-30)_files/IC553390.png" title="Diagram of the Proseware Robot device node, showing three device objects in the device stack: AfterThought.sys (Filter DO), ProsewareRobot.sys, GeneralRobot.sys (FDO), and Pci.sys (PDO)" xmlns=""><p>As shown in the preceding diagram, the device stack for Proseware Robot has three device objects. The top device object is a filter device object (Filter DO) associated with the filter driver AfterThought.sys. The middle device object is a functional device object (FDO) associated with the driver pair (ProsewareRobot.sys, GeneralRobot.sys). The driver pair serves as the function driver for the device stack. The bottom device object is a physical device object (PDO) associated with Pci.sys.</p>
- <p>Notice that the driver pair occupies only one level in the device stack and is associated with only one device object: the FDO. When GeneralRobot.sys processes an IRP, it might call ProsewareRobot.sys for assistance, but that is not the same as passing the request down the device stack. The driver pair forms a single WDM driver that is at one level in the device stack. The driver pair either completes the IRP or passes it down the device stack to the PDO, which is associated with Pci.sys.</p>
- <h2><a id="Example_of_a_driver_pair"></a><a id="example_of_a_driver_pair"></a><a id="EXAMPLE_OF_A_DRIVER_PAIR"></a>Example of a driver pair</h2>
- <p>Suppose you have a wireless network card in your laptop computer, and by looking in Device Manager, you determine that netwlv64.sys is the driver for the network card. You can use the <a href="https://msdn.microsoft.com/en-us/library/ff562408(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">!drvobj</strong></a> debugger extension to inspect the function pointers for netwlv64.sys.</p>
- <div id="code-snippet-3" class="codeSnippetContainer" xmlns="http://www.w3.org/1999/xhtml">
- <div class="codeSnippetContainerTabs">
- <div class="codeSnippetContainerTab codeSnippetContainerTabActive" dir="ltr">
- <a></a>
- </div>
- </div>
- <div class="codeSnippetContainerCodeContainer">
- <div class="codeSnippetToolBar"></div>
- <div class="codeSnippetContainerCode" dir="ltr">
- <div style="color:Black;"><pre>1: kd> !drvobj netwlv64 2
- Driver object (fffffa8002e5f420) is for:
- \Driver\netwlv64
- DriverEntry: fffff8800482f064 netwlv64!GsDriverEntry
- DriverStartIo: 00000000
- DriverUnload: fffff8800195c5f4 ndis!ndisMUnloadEx
- AddDevice: fffff88001940d30 ndis!ndisPnPAddDevice
- Dispatch routines:
- [00] IRP_MJ_CREATE fffff880018b5530 ndis!ndisCreateIrpHandler
- [01] IRP_MJ_CREATE_NAMED_PIPE fffff88001936f00 ndis!ndisDummyIrpHandler
- [02] IRP_MJ_CLOSE fffff880018b5870 ndis!ndisCloseIrpHandler
- [03] IRP_MJ_READ fffff88001936f00 ndis!ndisDummyIrpHandler
- [04] IRP_MJ_WRITE fffff88001936f00 ndis!ndisDummyIrpHandler
- [05] IRP_MJ_QUERY_INFORMATION fffff88001936f00 ndis!ndisDummyIrpHandler
- [06] IRP_MJ_SET_INFORMATION fffff88001936f00 ndis!ndisDummyIrpHandler
- [07] IRP_MJ_QUERY_EA fffff88001936f00 ndis!ndisDummyIrpHandler
- [08] IRP_MJ_SET_EA fffff88001936f00 ndis!ndisDummyIrpHandler
- [09] IRP_MJ_FLUSH_BUFFERS fffff88001936f00 ndis!ndisDummyIrpHandler
- [0a] IRP_MJ_QUERY_VOLUME_INFORMATION fffff88001936f00 ndis!ndisDummyIrpHandler
- [0b] IRP_MJ_SET_VOLUME_INFORMATION fffff88001936f00 ndis!ndisDummyIrpHandler
- [0c] IRP_MJ_DIRECTORY_CONTROL fffff88001936f00 ndis!ndisDummyIrpHandler
- [0d] IRP_MJ_FILE_SYSTEM_CONTROL fffff88001936f00 ndis!ndisDummyIrpHandler
- [0e] IRP_MJ_DEVICE_CONTROL fffff8800193696c ndis!ndisDeviceControlIrpHandler
- [0f] IRP_MJ_INTERNAL_DEVICE_CONTROL fffff880018f9114 ndis!ndisDeviceInternalIrpDispatch
- [10] IRP_MJ_SHUTDOWN fffff88001936f00 ndis!ndisDummyIrpHandler
- [11] IRP_MJ_LOCK_CONTROL fffff88001936f00 ndis!ndisDummyIrpHandler
- [12] IRP_MJ_CLEANUP fffff88001936f00 ndis!ndisDummyIrpHandler
- [13] IRP_MJ_CREATE_MAILSLOT fffff88001936f00 ndis!ndisDummyIrpHandler
- [14] IRP_MJ_QUERY_SECURITY fffff88001936f00 ndis!ndisDummyIrpHandler
- [15] IRP_MJ_SET_SECURITY fffff88001936f00 ndis!ndisDummyIrpHandler
- [16] IRP_MJ_POWER fffff880018c35e8 ndis!ndisPowerDispatch
- [17] IRP_MJ_SYSTEM_CONTROL fffff880019392c8 ndis!ndisWMIDispatch
- [18] IRP_MJ_DEVICE_CHANGE fffff88001936f00 ndis!ndisDummyIrpHandler
- [19] IRP_MJ_QUERY_QUOTA fffff88001936f00 ndis!ndisDummyIrpHandler
- [1a] IRP_MJ_SET_QUOTA fffff88001936f00 ndis!ndisDummyIrpHandler
- [1b] IRP_MJ_PNP fffff8800193e518 ndis!ndisPnPDispatch
- </pre></div>
- </div>
- </div>
- </div>
- <p>In the debugger output, you can see that netwlv64.sys implements <strong>GsDriverEntry</strong>, the entry point for the driver. <strong>GsDriverEntry</strong>, which was automatically generated when the driver was built, performs some initialization and then calls <a href="https://msdn.microsoft.com/en-us/library/ff544113(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">DriverEntry</strong></a>, which was written by the driver developer.</p>
- <p>In this example, netwlv64.sys implements <a href="https://msdn.microsoft.com/en-us/library/ff544113(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">DriverEntry</strong></a>, but ndis.sys implements <a href="https://msdn.microsoft.com/en-us/library/ff540521(v=vs.85).aspx"><em xmlns="http://www.w3.org/1999/xhtml">AddDevice</em></a>, <a href="https://msdn.microsoft.com/en-us/library/ff564886(v=vs.85).aspx"><em xmlns="http://www.w3.org/1999/xhtml">Unload</em></a>, and several dispatch functions. Netwlv64.sys is called an NDIS miniport driver, and ndis.sys is called the NDIS Library. Together, the two modules form an (NDIS miniport, NDIS Library) pair.</p>
- <p>This diagram shows the device stack for the wireless network card. Notice that the driver pair (netwlv64.sys, ndis.sys) occupies only one level in the device stack and is associated with only one device object: the FDO.</p><img id="DriverPairs02A" alt="Diagram of the Wireless network card device stack, showing Netwlv64.sys, ndis.sys as the driver pair associated with the FDO and Pci.sys associated with the PDO " src="./Windows Kernel Development Articles (2016-03-30)_files/IC559049.png" title="Diagram of the Wireless network card device stack, showing Netwlv64.sys, ndis.sys as the driver pair associated with the FDO and Pci.sys associated with the PDO " xmlns=""><h2><a id="Available_driver_pairs"></a><a id="available_driver_pairs"></a><a id="AVAILABLE_DRIVER_PAIRS"></a>Available driver pairs</h2>
- <p>The different technology-specific driver models use a variety of names for the specific and general pieces of a driver pair. In many cases, the specific portion of the pair has the prefix "mini." Here are some of (specific, general) pairs that are available:</p><ul>
- <li>(display miniport driver, display port driver)</li>
- <li>(audio miniport driver, audio port driver)</li>
- <li>(storage miniport driver, storage port driver)</li>
- <li>(battery miniclass driver, battery class driver)</li>
- <li>(HID minidriver, HID class driver)</li>
- <li>(changer miniclass driver, changer port driver)</li>
- <li>(NDIS miniport driver, NDIS library)</li>
- </ul>
- <div class="alert"><strong>Note</strong> As you can see in the list, several of the models use the term <em>class driver</em> for the general portion of a driver pair. This kind of class driver is different from a standalone class driver and different from a class filter driver.</div>
- <div> </div>
- <h2><a id="related_topics"></a>Related topics</h2>
- <dl>
- <dt>
- <a href="https://msdn.microsoft.com/en-us/library/ff554731(v=vs.85).aspx">Concepts for all driver developers</a>
- </dt>
- <dt>
- <a href="https://msdn.microsoft.com/en-us/library/ff554721(v=vs.85).aspx">Device nodes and device stacks</a>
- </dt>
- <dt>
- <a href="https://msdn.microsoft.com/en-us/library/hh439632(v=vs.85).aspx">Driver stacks</a>
- </dt>
- </dl>
- <p> </p>
- <p> </p>
- <p><a href="mailto:wsddocfb@microsoft.com?subject=Documentation%20feedback%20[wdkgetstart\wdkgetstart]:%20Minidrivers,%20Miniport%20drivers,%20and%20driver%20pairs%20%20RELEASE:%20(3/4/2016)&body=%0A%0APRIVACY%20STATEMENT%0A%0AWe%20use%20your%20feedback%20to%20improve%20the%20documentation.%20We%20don%27t%20use%20your%20email%20address%20for%20any%20other%20purpose,%20and%20we%27ll%20remove%20your%20email%20address%20from%20our%20system%20after%20the%20issue%20that%20you%27re%20reporting%20is%20fixed.%20While%20we%27re%20working%20to%20fix%20this%20issue,%20we%20might%20send%20you%20an%20email%20message%20to%20ask%20for%20more%20info.%20Later,%20we%20might%20also%20send%20you%20an%20email%20message%20to%20let%20you%20know%20that%20we%27ve%20addressed%20your%20feedback.%0A%0AFor%20more%20info%20about%20Microsoft%27s%20privacy%20policy,%20see%20http://privacy.microsoft.com/en-us/default.aspx." title="Send comments about this topic to Microsoft">Send comments about this topic to Microsoft</a></p>
- </div>
- </div>
-
- </div>
- </div>
- <div class="clear"></div>
-
- <input name="__RequestVerificationToken" type="hidden" value="_1zXsUVhlhFQw2NfPwDMBnXkjrzCJpMi3cYqbuklqtWie-ORuhlQEtPtBHlxWqhp7LQrO_Ni9m0DhBERCsptGSO81Xw1">
- <input id="ratingValueSubmitUrl" type="hidden" value="https://msdn.microsoft.com/en-us/library/feedback/rate/hh439643(d=printer,v=vs.85).aspx">
- <input id="ratingAdditionalSubmitUrl" type="hidden" value="https://msdn.microsoft.com/en-us/library/feedback/additional/hh439643(d=printer,v=vs.85).aspx">
- <input id="isTopicRated" type="hidden" value="false">
- <div id="lib-footer" ms.pgarea="body">
-
-
- <link type="text/css" rel="stylesheet">
-
- <div id="ux-footer" class="" style="" dir="ltr">
-
- <div id="footerSock" class="librarySock both">
- <div id="footerSockInner">
- <a name="feedback"></a>
- <div class="rating">
- <div id="ratingSection1">
- <div class="title">
- Was this page helpful?
- </div>
- <div class="description">
- Your feedback about this content is important.<br>Let us know what you think.
- </div>
- <div class="buttons">
- <button class="button" id="ratingYes" aria-label="Yes, this page was helpful">Yes</button>
- <button class="button" id="ratingNo" aria-label="No, this page was not helpful">No</button>
- </div>
- <input id="ratingValue" type="hidden" value="">
- </div>
- <div id="ratingSection2">
- <div class="title left">
- Additional feedback?
- </div>
- <textarea id="ratingText" rows="6" cols="" maxlength="1500"></textarea>
- <div class="right">
- <div class="counter">
- <span id="feedbackTextCounter">1500</span> characters remaining
- </div>
- <div class="buttons">
- <button class="button" id="ratingSubmit" aria-label="Submit my additional feedback">Submit</button>
- <button class="button" id="ratingSkipThis" aria-label="Skip additional feedback">Skip this</button>
- </div>
- </div>
- </div>
- <div id="ratingSection3">
- <div class="title">
- Thank you!
- </div>
- <div class="description">
- We appreciate your feedback.
- </div>
- </div>
-
-
- <div id="contentFeedbackQAContainer" style="display: none;"></div>
- </div>
-
- <div class="userVoice">
- <div class="title">
- Help us improve MSDN.
- </div>
- <div class="description">
- Visit our UserVoice Page to submit and vote on ideas!
- </div>
- <div class="buttons">
- <a class="button" id="userVoiceButton" href="http://feedback.msdn.com/forums/257782-msdn-feature-suggestions/category/83975" target="_blank">Make a suggestion</a>
- </div>
- </div>
- <div class="clear"></div>
- </div>
- </div>
- <footer class="top">
- <div data-fragmentname="LeftLinks" id="Fragment_LeftLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Dev centers</div>
- <ul class="links">
- <li>
- <a href="https://dev.windows.com/" id="LeftLinks_2148_1" class="windowsBlue" xmlns="http://www.w3.org/1999/xhtml">Windows</a>
- </li>
- <li>
- <a href="http://dev.office.com/" id="LeftLinks_2148_3" class="office" xmlns="http://www.w3.org/1999/xhtml">Office</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/vstudio" id="LeftLinks_2148_4" class="visualStudio" xmlns="http://www.w3.org/1999/xhtml">Visual Studio</a>
- </li>
- <li>
- <a href="http://azure.microsoft.com/en-us/documentation/" target="_blank" id="LeftLinks_2148_12" xmlns="http://www.w3.org/1999/xhtml">Microsoft Azure</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/developer-centers-msdn" id="LeftLinks_2148_5" xmlns="http://www.w3.org/1999/xhtml">More...</a>
- </li>
- </ul>
- </div>
- </div>
- <div id="rightLinks">
- <div data-fragmentname="CenterLinks1" id="Fragment_CenterLinks1" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Learning resources</div>
- <ul class="links">
- <li>
- <a href="http://www.microsoftvirtualacademy.com/" id="CenterLinks1_2151_4" xmlns="http://www.w3.org/1999/xhtml">Microsoft Virtual Academy</a>
- </li>
- <li>
- <a href="http://channel9.msdn.com/" id="CenterLinks1_2151_5" xmlns="http://www.w3.org/1999/xhtml">Channel 9</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/magazine/" id="CenterLinks1_2151_7" xmlns="http://www.w3.org/1999/xhtml">MSDN Magazine</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks2" id="Fragment_CenterLinks2" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Community</div>
- <ul class="links">
- <li>
- <a href="https://social.msdn.microsoft.com/forums/en-us/home" id="CenterLinks2_2151_8" xmlns="http://www.w3.org/1999/xhtml">Forums</a>
- </li>
- <li>
- <a href="http://blogs.msdn.com/b/developer-tools/" id="CenterLinks2_2151_9" xmlns="http://www.w3.org/1999/xhtml">Blogs</a>
- </li>
- <li>
- <a href="http://www.codeplex.com/" id="CenterLinks2_2151_10" xmlns="http://www.w3.org/1999/xhtml">Codeplex</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks3" id="Fragment_CenterLinks3" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Support</div>
- <ul class="links">
- <li>
- <a href="https://msdn.microsoft.com/hh361695" id="CenterLinks3_2151_11" xmlns="http://www.w3.org/1999/xhtml">Self support</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks4" id="Fragment_CenterLinks4" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Programs</div>
- <ul class="links">
- <li>
- <a href="https://www.microsoft.com/bizspark/" id="CenterLinks4_2151_13" xmlns="http://www.w3.org/1999/xhtml">BizSpark (for startups)</a>
- </li>
- <li>
- <a href="https://www.dreamspark.com/" id="CenterLinks4_2151_14" xmlns="http://www.w3.org/1999/xhtml">DreamSpark</a>
- </li>
- <li>
- <a href="http://www.imaginecup.com/" id="CenterLinks4_2151_17" xmlns="http://www.w3.org/1999/xhtml">Imagine Cup</a>
- </li>
- </ul>
- </div>
- </div>
- </div>
- </footer>
- <footer class="bottom">
- <span class="localeContainer">
-
- <form class="selectLocale" id="selectLocaleForm" action="https://msdn.microsoft.com/en-us/selectlocale-dmc">
- <input type="hidden" name="fromPage" value="https%3a%2f%2fmsdn.microsoft.com%2fen-us%2flibrary%2fhh439643(d%3dprinter%2cv%3dvs.85).aspx%3flan%3dCSharp%26cc%3dn%26trm%3dtra%26view%3dbook">
- <a href="http://msdn.microsoft.com/#" onclick="$('#selectLocaleForm').submit();return false;" title="Change your language">United States (English)</a>
- </form>
- </span>
- <div data-fragmentname="BottomLinks" id="Fragment_BottomLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <ul class="links horizontal">
- <li>
- <a href="https://msdn.microsoft.com/newsletter.aspx" id="BottomLinks_2148_7" xmlns="http://www.w3.org/1999/xhtml">Newsletter</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/dn529288" id="BottomLinks_2148_8" xmlns="http://www.w3.org/1999/xhtml">Privacy & cookies</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/cc300389" id="BottomLinks_2148_9" xmlns="http://www.w3.org/1999/xhtml">Terms of use</a>
- </li>
- <li>
- <a href="https://www.microsoft.com/en-us/legal/intellectualproperty/Trademarks/EN-US.aspx" id="BottomLinks_2148_10" xmlns="http://www.w3.org/1999/xhtml">Trademarks</a>
- </li>
- </ul>
- </div>
- </div>
- <span class="logoLegal">
- <span class="logo"></span>
- <span class="copyright">© 2016 Microsoft</span>
- </span>
- </footer>
- </div>
-
- </div>
- <div class="footerPrintView">
- <div class="footerCopyrightPrintView">© 2016 Microsoft</div>
- </div>
-
-
-
-
- <input id="tocPaddingPerLevel" type="hidden" value="17">
- <input id="MtpsDevice" type="hidden" value="Printer">
- <!--[CDATA[ Third party scripts and code linked to or referenced from this website are licensed to you by the parties that own such code, not by Microsoft. See ASP.NET Ajax CDN Terms of Use – http://www.asp.net/ajaxlibrary/CDN.ashx. ]]-->
-
-
-
-
-
- <noscript><div><img alt="DCSIMG" id="Img1" width="1" height="1" src="https://m.webtrends.com/dcsmgru7m99k7mqmgrhudo0k8_8c6m/njs.gif?dcsuri=/nojavascript&amp;WT.js=No" /></div></noscript>
- <div id="globalRequestVerification">
- <input name="__RequestVerificationToken" type="hidden" value="8xrmLK8jU6CoR5m_-OyOzHYoxoUkl2_LPKXhqYrZskXjmf7WbLs1MFcGsHEg2VxLr5botbrOs-2GQMLNfRrJ_C7Q9EE1">
- </div>
- </div>
-
-
-
-
-
-
- <script type="text/javascript" class="mtps-injected">
- /*<![CDATA[*/
- (function(window,document){"use strict";function preload(scripts){for(var result=[],script,e,i=0;i<scripts.length;i++)script=scripts[i],script.hasOwnProperty("url")&&(e=document.createElement("script"),e.src=script.url,script.throwaway=e),result.push(script);return result}function inject(scripts,index){var script,elem;if(index>=scripts.length){delete mtps.injectScripts;return}script=scripts[index];elem=document.createElement("script");elem.className="mtps-injected";elem.async=!1;var isLoaded=!1,timeoutId=0,injectNextFnName="",injectNext=elem.onerror=function(){isLoaded||(isLoaded=!0,inject(scripts,index+1),window.clearTimeout(timeoutId),elem.onload=elem.onerror=elem.onreadystatechange=null,injectNextFnName&&delete mtps[injectNextFnName],elem.removeEventListener&&elem.removeEventListener("load",injectNext,!1))};elem.addEventListener?elem.addEventListener("load",injectNext,!1):elem.readyState==="uninitialized"?elem.onreadystatechange=function(){(this.readyState==="loaded"||this.readyState==="complete")&&injectNext()}:elem.onload=injectNext;script.hasOwnProperty("url")?(timeoutId=window.setTimeout(injectNext,12e4),elem.src=script.url):(injectNextFnName="_injectNextScript_"+index,mtps[injectNextFnName]=injectNext,timeoutId=window.setTimeout(injectNext,2e3),elem.text="try {\n"+script.txt+"\n} finally { MTPS."+injectNextFnName+" && MTPS."+injectNextFnName+"(); }");parent.appendChild(elem)}var mtps=window.MTPS||(window.MTPS={}),parent=document.getElementsByTagName("head")[0];mtps.injectScripts=function(scripts){inject(preload(scripts),0)}})(window,document);
- MTPS.injectScripts([
- { txt: "/**/\r\n(window.MTPS || (window.MTPS = {})).cdnDomains || (window.MTPS.cdnDomains = { \r\n\t\"image\": \"https://i-msdn.sec.s-msft.com\", \r\n\t\"js\": \"https://i2-msdn.sec.s-msft.com\", \r\n\t\"css\": \"https://i-msdn.sec.s-msft.com\", \r\n\t\"ttf\": \"https://i-msdn.sec.s-msft.com\"\r\n});\r\n/**/" },
- { txt: "//\n var literalNormalizedUrl = \u0027/en-us/library/hh439643(d=printer,l=en-us,v=vs.85).aspx\u0027;\n var wt_nvr_ru = \u0027WT_NVR_RU\u0027;\n var wt_fpcdom = \u0027.microsoft.com\u0027;\n var wt_domlist = \u0027msdn.microsoft.com\u0027;\n var wt_pathlist = \u0027\u0027;\n var wt_paramlist = \u0027DCSext.mtps_devcenter\u0027;\n var wt_siteid = \u0027MSDN\u0027;\n var gDomain = \u0027m.webtrends.com\u0027;\n var gDcsId = \u0027dcsmgru7m99k7mqmgrhudo0k8_8c6m\u0027;\n var gFpc = \u0027WT_FPC\u0027;\n\n\n\n if (document.cookie.indexOf(gFpc + \"=\") == -1) {\n var wtidJs = document.createElement(\"script\");\n wtidJs.src = \"//\" + gDomain + \"/\" + gDcsId + \"/wtid.js\";\n document.getElementsByTagName(\"head\")[0].appendChild(wtidJs);\n }\n\n\n\n var detectedLocale = \u0027en-us\u0027;\n var wtsp = \u0027msdnlib_w32_com\u0027;\n var gTrackEvents = \u00270\u0027;\n/**/" },
- { txt: "//\n\n window.appInsightsId = \u00275eb1b2eb-c47a-497a-a7ac-a1c230b2882f\u0027;\n //" },
- { url: "https://i2-msdn.sec.s-msft.com/Combined.js?resources=0:Utilities,1:Layout,2:Header,1:Rating,2:Footer,0:Topic,3:PabTopic,4:webtrendsscript,0:AppInsightsPerf,0:ABTestControl,5:WEDCS,3:CmpgrpForHeader,0:livefyre,0:Comment,1:SearchBox;/Areas/Epx/Content/Scripts:0,/Areas/Epx/Themes/Base/Content:1,/Areas/Centers/Themes/StandardDevCenter/Content:2,/Areas/Library/Content:3,/Areas/Global/Content/Webtrends/resources:4,/Areas/Library/Themes/Base/Content:5\u0026amp;hashKey=30CEE944AABFEA2C5A338BDB9E000732\u0026amp;v=AE608271C0243AAA0449D3BC0FAD8EB4" },
- { url: "https://i1.services.social.microsoft.com/search/Widgets/SearchBox.jss?boxid=HeaderSearchTextBox\u0026btnid=HeaderSearchButton\u0026pgArea=header\u0026brand=Msdn\u0026loc=en-us\u0026focusOnInit=false\u0026emptyWatermark=true\u0026searchButtonTooltip=Search MSDN" },
- { url: "https://i2-msdn.sec.s-msft.com/Combined.js?resources=0:PrintExportButton,1:Toc_Fixed,1:CodeSnippet,1:TopicNotInScope,1:CollapsibleArea,1:VersionSelector,1:SurveyBroker;/Areas/Library/Themes/Base/Content:0,/Areas/Epx/Content/Scripts:1\u0026amp;hashKey=80F30894E3FB8A3295C923AEC7019CFE\u0026amp;v=AE608271C0243AAA0449D3BC0FAD8EB4" },
- { txt: "$(document).ready(function() {\n try {\n var token = $(\"#globalRequestVerification input[name=\u0027__RequestVerificationToken\u0027]\").clone();\n $(\"#siteFeedbackForm\").append(token);\n } catch(err) {\n \n }\n });" }
- ]);
- /*]]>*/
- </script>
- <link rel="stylesheet" type="text/css" href="./Windows Kernel Development Articles (2016-03-30)_files/Combined.css">
- <div id="page">
-
-
-
-
- <link type="text/css" rel="stylesheet">
-
- <input type="hidden" id="isHeaderBleeding" value="true">
- <div id="ux-header" dir="ltr" class="ltr msdn">
-
- <header>
- <span id="singleCol"></span>
- <span id="doubleCol"></span>
- <span id="isMobile"></span>
- <div>
- <div class="row topRow">
- <div class="top">
- <div class="left">
- <a class="msdnLogoImg" href="https://msdn.microsoft.com/en-us" title="MSDN home">
- <div id="msft-logo" class="msft-logo"></div>
- </a>
- <div class="GrayPipe"></div>
- <a class="DevCenterFullNameNonMegaBlade" href="https://msdn.microsoft.com/en-us">Developer Network</a>
- <a class="DevCenterFullName" href="https://msdn.microsoft.com/en-us">Developer Network</a>
- <a class="DevCenterShortName" href="https://msdn.microsoft.com/en-us">Developer</a>
- </div>
- <div class="right">
- <div id="signIn">
- <div class="profileImage"></div>
- <a class="scarabLink" href="https://login.live.com/login.srf?wa=wsignin1.0&rpsnv=12&ct=1459376410&rver=6.0.5276.0&wp=mcmbi&wlcxt=msdn%24msdn%24msdn&wreply=https%3a%2f%2fmsdn.microsoft.com%2fen-us%2flibrary%2fhh706279%2528d%3dprinter%2cv%3dvs.85%2529.aspx%3flan%3dcsharp%26cc%3dn%26trm%3dtra%26view%3dbook&lc=1033&id=254354&mkt=en-us" title="Sign in">Sign in</a></div>
- <div class="auxNav">
- <div>
- <div data-fragmentname="Subscriptions" id="Fragment_Subscriptions" xmlns="http://www.w3.org/1999/xhtml">
- <a href="https://msdn.microsoft.com/subscriptions/manage/hh442900" id="Subscriptions_2153_1" xmlns="http://www.w3.org/1999/xhtml">MSDN subscriptions</a>
- </div>
- <div data-fragmentname="GetTools" id="Fragment_GetTools" xmlns="http://www.w3.org/1999/xhtml">
- <a href="http://go.microsoft.com/fwlink/?LinkId=309297&clcid=0x409&slcid=0x409&campaign=o~msft~msdn~gettools-header~dn308572" id="GetTools_2153_3" xmlns="http://www.w3.org/1999/xhtml">Get tools</a>
- </div>
- </div>
- <div>
- <div data-fragmentname="SocialLinks" id="Fragment_SocialLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <ul class="links horizontal">
- <li>
- <a href="http://www.facebook.com/microsoftdeveloper" target="_blank" id="SocialLinks_2152_4" class="facebook" xmlns="http://www.w3.org/1999/xhtml">http://www.facebook.com/microsoftdeveloper</a>
- </li>
- <li>
- <a href="https://twitter.com/msdev" target="_blank" id="SocialLinks_2152_5" class="twitter" xmlns="http://www.w3.org/1999/xhtml">https://twitter.com/msdev</a>
- </li>
- <li>
- <a href="http://plus.google.com/111221966647232053570/" target="_blank" id="SocialLinks_2152_6" class="googlePlus" xmlns="http://www.w3.org/1999/xhtml">http://plus.google.com/111221966647232053570/</a>
- </li>
- </ul>
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- <div class="row middleRow">
- <div class="expandTop">
- <div class="left"></div>
- <div class="right"></div>
- </div>
- </div>
- </div>
- <div id="buttomRowWrapper" class="bg_default">
- <div class="row buttomRow bg_default">
- <div class="bottom">
- <div class="left">
- <a id="grip" class="menu-icon" href="javascript:void(0)"></a>
-
- <div id="drawer">
- <div class="toc">
-
- <nav>
- <ul class="navL1">
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Technologies">Technologies</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/cloud-app-development-msdn" title="Cloud">Cloud</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/app-development-msdn" title="App Development">App Development</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/web-app-development-msdn" title="Web">Web</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/big-data-development-msdn" title="Data">Data</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/games-development-msdn" title="Gaming">Gaming</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/internetofthings" title="Internet of Things">Internet of Things</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Downloads">Downloads</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://www.visualstudio.com/downloads/download-visual-studio-vs" title="Visual Studio">Visual Studio</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/subscriptions" title="MSDN subscription access">MSDN subscription access</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/microsoft-sdks-msdn" title="SDKs">SDKs</a>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Trial software">Trial software</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/evalcenter" title="Free downloads">Free downloads</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/officeevaluationresources" title="Office resources">Office resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/sharepoint2013resources" title="SharePoint Server 2013 resources">SharePoint Server 2013 resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/sqlserver2014expressresources" title="SQL Server 2014 Express resources">SQL Server 2014 Express resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/windowsserver2012r2resources" title="Windows Server 2012 resources">Windows Server 2012 resources</a>
- </li>
- </ul>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Programs">Programs</a>
- <ul class="navL2">
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Visual Studio subscriptions">Visual Studio subscriptions</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/msdn-subscriptions-overview" title="Overview">Overview</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/benefits-overview" title="Benefits">Benefits</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/msdn-subscriptions-administration" title="Administrators">Administrators</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Students">Students</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/imagine/imagine-home" title="Microsoft Imagine">Microsoft Imagine</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/microsoftstudentpartners" title="Microsoft Student Partners">Microsoft Student Partners</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Architects">Architects</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-overview-msdn" title="Overview">Overview</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-case-studies-msdn" title="Case studies">Case studies</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-blueprints-msdn" title="Blueprints">Blueprints</a>
- </li>
- <li class="inactive">
- <a href="http://blogs.msdn.com/b/msarchitecture/" title="Blog">Blog</a>
- </li>
- <li class="inactive">
- <a href="http://social.msdn.microsoft.com/forums/en-us/home?brandignore=true&sort=relevancedesc&searchterm=architecture+or+architect" title="Forums">Forums</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/applicationbuilder" title="ISV">ISV</a>
-
- </li>
- <li class="inactive">
- <a href="https://www.microsoft.com/bizspark" title="Startups">Startups</a>
-
- </li>
- <li class="inactive">
- <a href="https://rewards.msdn.microsoft.com/" title="TechRewards">TechRewards</a>
-
- </li>
- <li class="inactive">
- <a href="http://events.msdn.microsoft.com/" title="Events">Events</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Community">Community</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/magazine/dd767791" title="Magazine">Magazine</a>
-
- </li>
- <li class="inactive">
- <a href="https://social.msdn.microsoft.com/forums/" title="Forums">Forums</a>
-
- </li>
- <li class="inactive">
- <a href="http://blogs.msdn.com/b/developer-tools/" title="Blogs">Blogs</a>
-
- </li>
- <li class="inactive">
- <a href="http://tech-advisors.msdn.microsoft.com/en-us" title="Tech Advisors">Tech Advisors</a>
-
- </li>
- <li class="inactive">
- <a href="http://channel9.msdn.com/" title="Channel 9">Channel 9</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive current toggle">
- <a href="javascript:void(0)" title="Documentation">Documentation</a>
- <ul class="navL2">
- <li class="inactive current">
- <a href="https://msdn.microsoft.com/library" title="APIs and reference">APIs and reference</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/developer-centers-msdn" title="Dev centers">Dev centers</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive">
- <a href="https://code.msdn.microsoft.com/" title="Samples">Samples</a>
- </li>
- </ul>
- </nav>
- </div>
- </div>
- </div>
- <div class="right">
- <div data-fragmentname="SearchBox" id="Fragment_SearchBox" xmlns="http://www.w3.org/1999/xhtml">
- <div class="SearchBox">
- <form id="HeaderSearchForm" name="HeaderSearchForm" method="get">
- <button id="FakeHeaderSearchButton" value="Search" type="submit" class="header-search-button">
- <div id="search-finder" class="search-finder"></div>
- </button>
- <button id="HeaderSearchButton" style="display:none"></button>
- <div id="searchSplitter"></div>
- <div id="searchCloseIcon" class="search-clear-x"></div>
- <div id="searchTextContainer" style="width: 0;">
- <input id="HeaderSearchTextBox" name="query" type="text" maxlength="200" onfocus="Epx.Controls.SearchBox.watermarkFocus(event, this.title)" onblur="Epx.Controls.SearchBox.watermarkBlur(event, this.title)">
- </div>
- </form>
-
-
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- </header>
- </div>
-
-
-
- <div class="printExportMenus ltr">
- <a id="isd_printABook" href="http://msdn.microsoft.com/en-us/library/export/help/(d=printer)?returnurl=%2fen-us%2flibrary%2fhh706279(d%3dprinter,v%3dvs.85).aspx%3flan%3dcsharp%26cc%3dn%26trm%3dtra%26view%3dbook">
- Export (<span class="count">0</span>)
- </a>
- <a id="isd_print" href="https://msdn.microsoft.com/en-us/library/hh706279(d=printer,v=vs.85).aspx?lan=csharp&cc=n&trm=tra&view=book" rel="nofollow">
- Print
- </a>
- <a id="isd_archiveControl" style="display:none;" data-include-archive="Include Previous Version" data-exclude-archive="Exclude Previous Version">
- </a>
- </div>
-
- <div class="printExportMenus ltr">
- <a id="expandCollapseAll" accesskey="e" href="javascript:void(0)" title="Expand/Collapse all sections by pressing Ctrl + Shift + e">Expand All</a>
- </div>
-
- <div id="body" ms.pgarea="body">
- <span id="tabletView_large"></span>
- <span id="tabletView_small"></span>
- <span id="mobileView"></span>
-
- <div id="content" class="content">
- <input type="hidden" id="printForPab" value="true">
-
- <div class="topic" xmlns="http://www.w3.org/1999/xhtml">
- <h1 class="title">KMDF as a generic driver pair model</h1>
-
- <div id="mainSection">
- <div class="clsServerSDKContent">
- </div>
- <p>In this topic, we discuss the idea that the Kernel Mode Driver Framework can be viewed as a generic driver pair model. Before you read this topic, you should understand the ideas presented in <a href="https://msdn.microsoft.com/en-us/library/hh439643(v=vs.85).aspx">Minidrivers and driver pairs</a>.</p>
- <p>Over the years, Microsoft has created several technology-specific driver models that use this paradigm:</p>
- <ul>
- <li>The driver is split into two pieces: one that handles general processing and one that handles processing that is specific to a particular device.</li>
- <li>The general piece, called the Framework, is written by Microsoft.</li>
- <li>The specific piece, called the KMDF driver, may be written by Microsoft or an independent hardware vendor.</li>
- </ul><img id="kmdfdriverpair" alt="Diagram of KMDF as a Generic Driver Pair" src="./Windows Kernel Development Articles (2016-03-30)_files/IC831360.png" title="Diagram of KMDF as a Generic Driver Pair" xmlns=""><p>The Framework portion of the driver pair performs general tasks that are common to a wide variety of drivers. For example, the Framework can handle I/O request queues, thread synchronization, and a large portion of the power management duties.</p>
- <p>The Framework owns the dispatch table for the KMDF driver, so when someone sends an I/O request packet (IRP) to the (KMDF driver, Framework) pair, the IRP goes to Framework. If the Framework can handle the IRP by itself, the KMDF driver is not involved. If the Framework cannot handle the IRP by itself, it gets help by calling event handlers implemented by the KMDF driver. Here are some examples of event handlers that might be implemented by a KMDF driver.</p>
- <ul>
- <li>
- <a href="https://msdn.microsoft.com/en-us/library/ff540880(v=vs.85).aspx"><em xmlns="http://www.w3.org/1999/xhtml">EvtDevicePrepareHardware</em></a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/en-us/library/ff541776(v=vs.85).aspx"><em xmlns="http://www.w3.org/1999/xhtml">EvtIoRead</em></a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/en-us/library/ff541758(v=vs.85).aspx"><em xmlns="http://www.w3.org/1999/xhtml">EvtIoDeviceControl</em></a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/en-us/library/ff541735(v=vs.85).aspx"><em xmlns="http://www.w3.org/1999/xhtml">EvtInterruptIsr</em></a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/en-us/library/ff541721(v=vs.85).aspx"><em xmlns="http://www.w3.org/1999/xhtml">EvtInterruptDpc</em></a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/en-us/library/ff540874(v=vs.85).aspx"><em xmlns="http://www.w3.org/1999/xhtml">EvtDevicePnpStateChange</em></a>
- </li>
- </ul>
- <p>For example, a USB 2.0 host controller driver has a specific piece named usbehci.sys and a general piece named usbport.sys. Usbehci.sys, which is called the USB 2.0 Miniport driver, has code that is specific to USB 2.0 host controllers. Usbport.sys, which is called the USB Port driver, has general code that applies to both USB 2.0 and USB 1.0. The pair of drivers (usbehci.sys, usbport.sys) combine to form a single WDM driver for a USB 2.0 host controller.</p>
- <p> The (specific, general) driver pairs have a variety of names across different device technologies. Most of the device-specific drivers have the prefix <em>mini</em>. The general drivers are often called port or class drivers. Here are some examples of (specific, general) pairs:</p>
- <ul>
- <li>(display miniport driver, display port driver)</li>
- <li>(USB miniport driver, USB port driver)</li>
- <li>(battery miniclass driver, battery class driver)</li>
- <li>(HID minidriver, HID class driver)</li>
- <li>(storage miniport driver, storage port driver)</li>
- </ul>
- <p>As more and more driver pair models were developed, it became difficult to keep track of all the different ways to write a driver. Each model has it's own interface for communication between the device-specific driver and the general driver. The body of knowledge required to develop drivers for one device technology (for example, Audio) can be quite different from the body of knowledge required to develop drivers for another device technology (for example, Storage).</p>
- <p>Over time, developers realized that it would be good to have a single unified model for kernel-mode driver pairs. The Kernel Mode Driver Framework (KMDF), which was first available in Windows Vista, fulfills that need. A driver based on KMDF uses a paradigm that is similar to many of the technology-specific driver pair models.</p>
- <ul>
- <li>The driver is split into two pieces: one that handles general processing and one that handles processing that is specific to a particular device.</li>
- <li>The general piece, which is written by Microsoft, is called the Framework.</li>
- <li>The specific piece, which is written by Microsoft or an independent hardware vendor, is called the KMDF driver.</li>
- </ul>
- <p>The USB 3.0 host controller driver is an example of a driver based on KMDF. In this example, both drivers in the pair are written by Microsoft. The general driver is the Framework, and the device-specific driver is the USB 3.0 Host Controller Driver. This diagram illustrates the device node and device stack for a USB 3.0 host controller.</p><img id="KmdfAsPair01" alt="Diagram of device stack for USB 3 host controller" src="./Windows Kernel Development Articles (2016-03-30)_files/IC554550.png" title="Diagram of device stack for USB 3 host controller" xmlns=""><p>In the diagram, Usbxhci.sys is the USB 3.0 host controller driver. It is paired with Wdf01000.sys, which is the Framework. The (usbxhci.sys, wdf01000.sys) pair forms a single WDM driver that serves as the function driver for the USB 3.0 host controller. Notice that the driver pair occupies one level in the device stack and is represented by single device object. The single device object that represents the (usbxhci.sys, wdf01000.sys) pair is the functional device object (FDO) for the USB 3.0 host controller. </p>
- <p>In a (KMDF driver, Framework) pair, the Framework handles tasks that are common to a wide variety of kernel-mode drivers. For example, the Framework can handle queuing of I/O requests, thread synchronization, most of the Plug and Play tasks, and most of the power management tasks. The KMDF driver handles tasks that require interaction with a specific device. The KMDF driver participates in processing requests by registering event handlers that the Framework calls as needed.</p>
- <h2><a id="related_topics"></a>Related topics</h2>
- <dl>
- <dt>
- <a href="https://msdn.microsoft.com/en-us/library/hh439643(v=vs.85).aspx">Minidrivers and driver pairs</a>
- </dt>
- <dt>
- <a href="https://msdn.microsoft.com/en-us/library/ff544396(v=vs.85).aspx">Kernel-Mode Driver Framework</a>
- </dt>
- </dl>
- <p> </p>
- <p> </p>
- <p><a href="mailto:wsddocfb@microsoft.com?subject=Documentation%20feedback%20[wdkgetstart\wdkgetstart]:%20KMDF%20as%20a%20generic%20driver%20pair%20model%20%20RELEASE:%20(3/4/2016)&body=%0A%0APRIVACY%20STATEMENT%0A%0AWe%20use%20your%20feedback%20to%20improve%20the%20documentation.%20We%20don%27t%20use%20your%20email%20address%20for%20any%20other%20purpose,%20and%20we%27ll%20remove%20your%20email%20address%20from%20our%20system%20after%20the%20issue%20that%20you%27re%20reporting%20is%20fixed.%20While%20we%27re%20working%20to%20fix%20this%20issue,%20we%20might%20send%20you%20an%20email%20message%20to%20ask%20for%20more%20info.%20Later,%20we%20might%20also%20send%20you%20an%20email%20message%20to%20let%20you%20know%20that%20we%27ve%20addressed%20your%20feedback.%0A%0AFor%20more%20info%20about%20Microsoft%27s%20privacy%20policy,%20see%20http://privacy.microsoft.com/en-us/default.aspx." title="Send comments about this topic to Microsoft">Send comments about this topic to Microsoft</a></p>
- </div>
- </div>
-
- </div>
- </div>
- <div class="clear"></div>
-
- <input name="__RequestVerificationToken" type="hidden" value="0QcrQhmjK3IIeTiVHfybcTWcmiWXdmewHbIcxSsefJPzQEpzFqa0nwpLvVMCd7MoVDvK21HVosGeppIgkMHWlTQM_fc1">
- <input id="ratingValueSubmitUrl" type="hidden" value="https://msdn.microsoft.com/en-us/library/feedback/rate/hh706279(d=printer,v=vs.85).aspx">
- <input id="ratingAdditionalSubmitUrl" type="hidden" value="https://msdn.microsoft.com/en-us/library/feedback/additional/hh706279(d=printer,v=vs.85).aspx">
- <input id="isTopicRated" type="hidden" value="false">
- <div id="lib-footer" ms.pgarea="body">
-
-
- <link type="text/css" rel="stylesheet">
-
- <div id="ux-footer" class="" style="" dir="ltr">
-
- <div id="footerSock" class="librarySock both">
- <div id="footerSockInner">
- <a name="feedback"></a>
- <div class="rating">
- <div id="ratingSection1">
- <div class="title">
- Was this page helpful?
- </div>
- <div class="description">
- Your feedback about this content is important.<br>Let us know what you think.
- </div>
- <div class="buttons">
- <button class="button" id="ratingYes" aria-label="Yes, this page was helpful">Yes</button>
- <button class="button" id="ratingNo" aria-label="No, this page was not helpful">No</button>
- </div>
- <input id="ratingValue" type="hidden" value="">
- </div>
- <div id="ratingSection2">
- <div class="title left">
- Additional feedback?
- </div>
- <textarea id="ratingText" rows="6" cols="" maxlength="1500"></textarea>
- <div class="right">
- <div class="counter">
- <span id="feedbackTextCounter">1500</span> characters remaining
- </div>
- <div class="buttons">
- <button class="button" id="ratingSubmit" aria-label="Submit my additional feedback">Submit</button>
- <button class="button" id="ratingSkipThis" aria-label="Skip additional feedback">Skip this</button>
- </div>
- </div>
- </div>
- <div id="ratingSection3">
- <div class="title">
- Thank you!
- </div>
- <div class="description">
- We appreciate your feedback.
- </div>
- </div>
-
-
- <div id="contentFeedbackQAContainer" style="display: none;"></div>
- </div>
-
- <div class="userVoice">
- <div class="title">
- Help us improve MSDN.
- </div>
- <div class="description">
- Visit our UserVoice Page to submit and vote on ideas!
- </div>
- <div class="buttons">
- <a class="button" id="userVoiceButton" href="http://feedback.msdn.com/forums/257782-msdn-feature-suggestions/category/83975" target="_blank">Make a suggestion</a>
- </div>
- </div>
- <div class="clear"></div>
- </div>
- </div>
- <footer class="top">
- <div data-fragmentname="LeftLinks" id="Fragment_LeftLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Dev centers</div>
- <ul class="links">
- <li>
- <a href="https://dev.windows.com/" id="LeftLinks_2148_1" class="windowsBlue" xmlns="http://www.w3.org/1999/xhtml">Windows</a>
- </li>
- <li>
- <a href="http://dev.office.com/" id="LeftLinks_2148_3" class="office" xmlns="http://www.w3.org/1999/xhtml">Office</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/vstudio" id="LeftLinks_2148_4" class="visualStudio" xmlns="http://www.w3.org/1999/xhtml">Visual Studio</a>
- </li>
- <li>
- <a href="http://azure.microsoft.com/en-us/documentation/" target="_blank" id="LeftLinks_2148_12" xmlns="http://www.w3.org/1999/xhtml">Microsoft Azure</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/developer-centers-msdn" id="LeftLinks_2148_5" xmlns="http://www.w3.org/1999/xhtml">More...</a>
- </li>
- </ul>
- </div>
- </div>
- <div id="rightLinks">
- <div data-fragmentname="CenterLinks1" id="Fragment_CenterLinks1" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Learning resources</div>
- <ul class="links">
- <li>
- <a href="http://www.microsoftvirtualacademy.com/" id="CenterLinks1_2151_4" xmlns="http://www.w3.org/1999/xhtml">Microsoft Virtual Academy</a>
- </li>
- <li>
- <a href="http://channel9.msdn.com/" id="CenterLinks1_2151_5" xmlns="http://www.w3.org/1999/xhtml">Channel 9</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/magazine/" id="CenterLinks1_2151_7" xmlns="http://www.w3.org/1999/xhtml">MSDN Magazine</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks2" id="Fragment_CenterLinks2" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Community</div>
- <ul class="links">
- <li>
- <a href="https://social.msdn.microsoft.com/forums/en-us/home" id="CenterLinks2_2151_8" xmlns="http://www.w3.org/1999/xhtml">Forums</a>
- </li>
- <li>
- <a href="http://blogs.msdn.com/b/developer-tools/" id="CenterLinks2_2151_9" xmlns="http://www.w3.org/1999/xhtml">Blogs</a>
- </li>
- <li>
- <a href="http://www.codeplex.com/" id="CenterLinks2_2151_10" xmlns="http://www.w3.org/1999/xhtml">Codeplex</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks3" id="Fragment_CenterLinks3" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Support</div>
- <ul class="links">
- <li>
- <a href="https://msdn.microsoft.com/hh361695" id="CenterLinks3_2151_11" xmlns="http://www.w3.org/1999/xhtml">Self support</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks4" id="Fragment_CenterLinks4" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Programs</div>
- <ul class="links">
- <li>
- <a href="https://www.microsoft.com/bizspark/" id="CenterLinks4_2151_13" xmlns="http://www.w3.org/1999/xhtml">BizSpark (for startups)</a>
- </li>
- <li>
- <a href="https://www.dreamspark.com/" id="CenterLinks4_2151_14" xmlns="http://www.w3.org/1999/xhtml">DreamSpark</a>
- </li>
- <li>
- <a href="http://www.imaginecup.com/" id="CenterLinks4_2151_17" xmlns="http://www.w3.org/1999/xhtml">Imagine Cup</a>
- </li>
- </ul>
- </div>
- </div>
- </div>
- </footer>
- <footer class="bottom">
- <span class="localeContainer">
-
- <form class="selectLocale" id="selectLocaleForm" action="https://msdn.microsoft.com/en-us/selectlocale-dmc">
- <input type="hidden" name="fromPage" value="https%3a%2f%2fmsdn.microsoft.com%2fen-us%2flibrary%2fhh706279(d%3dprinter%2cv%3dvs.85).aspx%3flan%3dCSharp%26cc%3dn%26trm%3dtra%26view%3dbook">
- <a href="http://msdn.microsoft.com/#" onclick="$('#selectLocaleForm').submit();return false;" title="Change your language">United States (English)</a>
- </form>
- </span>
- <div data-fragmentname="BottomLinks" id="Fragment_BottomLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <ul class="links horizontal">
- <li>
- <a href="https://msdn.microsoft.com/newsletter.aspx" id="BottomLinks_2148_7" xmlns="http://www.w3.org/1999/xhtml">Newsletter</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/dn529288" id="BottomLinks_2148_8" xmlns="http://www.w3.org/1999/xhtml">Privacy & cookies</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/cc300389" id="BottomLinks_2148_9" xmlns="http://www.w3.org/1999/xhtml">Terms of use</a>
- </li>
- <li>
- <a href="https://www.microsoft.com/en-us/legal/intellectualproperty/Trademarks/EN-US.aspx" id="BottomLinks_2148_10" xmlns="http://www.w3.org/1999/xhtml">Trademarks</a>
- </li>
- </ul>
- </div>
- </div>
- <span class="logoLegal">
- <span class="logo"></span>
- <span class="copyright">© 2016 Microsoft</span>
- </span>
- </footer>
- </div>
-
- </div>
- <div class="footerPrintView">
- <div class="footerCopyrightPrintView">© 2016 Microsoft</div>
- </div>
-
-
-
-
- <input id="tocPaddingPerLevel" type="hidden" value="17">
- <input id="MtpsDevice" type="hidden" value="Printer">
- <!--[CDATA[ Third party scripts and code linked to or referenced from this website are licensed to you by the parties that own such code, not by Microsoft. See ASP.NET Ajax CDN Terms of Use – http://www.asp.net/ajaxlibrary/CDN.ashx. ]]-->
-
-
-
-
-
- <noscript><div><img alt="DCSIMG" id="Img1" width="1" height="1" src="https://m.webtrends.com/dcsmgru7m99k7mqmgrhudo0k8_8c6m/njs.gif?dcsuri=/nojavascript&amp;WT.js=No" /></div></noscript>
- <div id="globalRequestVerification">
- <input name="__RequestVerificationToken" type="hidden" value="nZiQ3CFcIrEEZwZQ_WPJmjSPfVh-WesE05vrl49yAyjsceTwvVLwjvi3c8d0TQkFpFADnFJsQfKGL28DZa_-g5MXGRg1">
- </div>
- </div>
-
-
-
-
-
-
- <script type="text/javascript" class="mtps-injected">
- /*<![CDATA[*/
- (function(window,document){"use strict";function preload(scripts){for(var result=[],script,e,i=0;i<scripts.length;i++)script=scripts[i],script.hasOwnProperty("url")&&(e=document.createElement("script"),e.src=script.url,script.throwaway=e),result.push(script);return result}function inject(scripts,index){var script,elem;if(index>=scripts.length){delete mtps.injectScripts;return}script=scripts[index];elem=document.createElement("script");elem.className="mtps-injected";elem.async=!1;var isLoaded=!1,timeoutId=0,injectNextFnName="",injectNext=elem.onerror=function(){isLoaded||(isLoaded=!0,inject(scripts,index+1),window.clearTimeout(timeoutId),elem.onload=elem.onerror=elem.onreadystatechange=null,injectNextFnName&&delete mtps[injectNextFnName],elem.removeEventListener&&elem.removeEventListener("load",injectNext,!1))};elem.addEventListener?elem.addEventListener("load",injectNext,!1):elem.readyState==="uninitialized"?elem.onreadystatechange=function(){(this.readyState==="loaded"||this.readyState==="complete")&&injectNext()}:elem.onload=injectNext;script.hasOwnProperty("url")?(timeoutId=window.setTimeout(injectNext,12e4),elem.src=script.url):(injectNextFnName="_injectNextScript_"+index,mtps[injectNextFnName]=injectNext,timeoutId=window.setTimeout(injectNext,2e3),elem.text="try {\n"+script.txt+"\n} finally { MTPS."+injectNextFnName+" && MTPS."+injectNextFnName+"(); }");parent.appendChild(elem)}var mtps=window.MTPS||(window.MTPS={}),parent=document.getElementsByTagName("head")[0];mtps.injectScripts=function(scripts){inject(preload(scripts),0)}})(window,document);
- MTPS.injectScripts([
- { txt: "/**/\r\n(window.MTPS || (window.MTPS = {})).cdnDomains || (window.MTPS.cdnDomains = { \r\n\t\"image\": \"https://i-msdn.sec.s-msft.com\", \r\n\t\"js\": \"https://i2-msdn.sec.s-msft.com\", \r\n\t\"css\": \"https://i-msdn.sec.s-msft.com\", \r\n\t\"ttf\": \"https://i-msdn.sec.s-msft.com\"\r\n});\r\n/**/" },
- { txt: "//\n var literalNormalizedUrl = \u0027/en-us/library/hh706279(d=printer,l=en-us,v=vs.85).aspx\u0027;\n var wt_nvr_ru = \u0027WT_NVR_RU\u0027;\n var wt_fpcdom = \u0027.microsoft.com\u0027;\n var wt_domlist = \u0027msdn.microsoft.com\u0027;\n var wt_pathlist = \u0027\u0027;\n var wt_paramlist = \u0027DCSext.mtps_devcenter\u0027;\n var wt_siteid = \u0027MSDN\u0027;\n var gDomain = \u0027m.webtrends.com\u0027;\n var gDcsId = \u0027dcsmgru7m99k7mqmgrhudo0k8_8c6m\u0027;\n var gFpc = \u0027WT_FPC\u0027;\n\n\n\n if (document.cookie.indexOf(gFpc + \"=\") == -1) {\n var wtidJs = document.createElement(\"script\");\n wtidJs.src = \"//\" + gDomain + \"/\" + gDcsId + \"/wtid.js\";\n document.getElementsByTagName(\"head\")[0].appendChild(wtidJs);\n }\n\n\n\n var detectedLocale = \u0027en-us\u0027;\n var wtsp = \u0027msdnlib_w32_com\u0027;\n var gTrackEvents = \u00270\u0027;\n/**/" },
- { txt: "//\n\n window.appInsightsId = \u00275eb1b2eb-c47a-497a-a7ac-a1c230b2882f\u0027;\n //" },
- { url: "https://i2-msdn.sec.s-msft.com/Combined.js?resources=0:Utilities,1:Layout,2:Header,1:Rating,2:Footer,0:Topic,3:PabTopic,4:webtrendsscript,0:AppInsightsPerf,0:ABTestControl,5:WEDCS,3:CmpgrpForHeader,0:livefyre,0:Comment,1:SearchBox;/Areas/Epx/Content/Scripts:0,/Areas/Epx/Themes/Base/Content:1,/Areas/Centers/Themes/StandardDevCenter/Content:2,/Areas/Library/Content:3,/Areas/Global/Content/Webtrends/resources:4,/Areas/Library/Themes/Base/Content:5\u0026amp;hashKey=30CEE944AABFEA2C5A338BDB9E000732\u0026amp;v=AE608271C0243AAA0449D3BC0FAD8EB4" },
- { url: "https://i1.services.social.microsoft.com/search/Widgets/SearchBox.jss?boxid=HeaderSearchTextBox\u0026btnid=HeaderSearchButton\u0026pgArea=header\u0026brand=Msdn\u0026loc=en-us\u0026focusOnInit=false\u0026emptyWatermark=true\u0026searchButtonTooltip=Search MSDN" },
- { url: "https://i2-msdn.sec.s-msft.com/Combined.js?resources=0:PrintExportButton,1:Toc_Fixed,1:CodeSnippet,1:TopicNotInScope,1:CollapsibleArea,1:VersionSelector,1:SurveyBroker;/Areas/Library/Themes/Base/Content:0,/Areas/Epx/Content/Scripts:1\u0026amp;hashKey=80F30894E3FB8A3295C923AEC7019CFE\u0026amp;v=AE608271C0243AAA0449D3BC0FAD8EB4" },
- { txt: "$(document).ready(function() {\n try {\n var token = $(\"#globalRequestVerification input[name=\u0027__RequestVerificationToken\u0027]\").clone();\n $(\"#siteFeedbackForm\").append(token);\n } catch(err) {\n \n }\n });" }
- ]);
- /*]]>*/
- </script>
- <link rel="stylesheet" type="text/css" href="./Windows Kernel Development Articles (2016-03-30)_files/Combined.css">
- <div id="page">
-
-
-
-
- <link type="text/css" rel="stylesheet">
-
- <input type="hidden" id="isHeaderBleeding" value="true">
- <div id="ux-header" dir="ltr" class="ltr msdn">
-
- <header>
- <span id="singleCol"></span>
- <span id="doubleCol"></span>
- <span id="isMobile"></span>
- <div>
- <div class="row topRow">
- <div class="top">
- <div class="left">
- <a class="msdnLogoImg" href="https://msdn.microsoft.com/en-us" title="MSDN home">
- <div id="msft-logo" class="msft-logo"></div>
- </a>
- <div class="GrayPipe"></div>
- <a class="DevCenterFullNameNonMegaBlade" href="https://msdn.microsoft.com/en-us">Developer Network</a>
- <a class="DevCenterFullName" href="https://msdn.microsoft.com/en-us">Developer Network</a>
- <a class="DevCenterShortName" href="https://msdn.microsoft.com/en-us">Developer</a>
- </div>
- <div class="right">
- <div id="signIn">
- <div class="profileImage"></div>
- <a class="scarabLink" href="https://login.live.com/login.srf?wa=wsignin1.0&rpsnv=12&ct=1459376412&rver=6.0.5276.0&wp=mcmbi&wlcxt=msdn%24msdn%24msdn&wreply=https%3a%2f%2fmsdn.microsoft.com%2fen-us%2flibrary%2fhh706278%2528d%3dprinter%2cv%3dvs.85%2529.aspx%3flan%3dcsharp%26cc%3dn%26trm%3dtra%26view%3dbook&lc=1033&id=254354&mkt=en-us" title="Sign in">Sign in</a></div>
- <div class="auxNav">
- <div>
- <div data-fragmentname="Subscriptions" id="Fragment_Subscriptions" xmlns="http://www.w3.org/1999/xhtml">
- <a href="https://msdn.microsoft.com/subscriptions/manage/hh442900" id="Subscriptions_2153_1" xmlns="http://www.w3.org/1999/xhtml">MSDN subscriptions</a>
- </div>
- <div data-fragmentname="GetTools" id="Fragment_GetTools" xmlns="http://www.w3.org/1999/xhtml">
- <a href="http://go.microsoft.com/fwlink/?LinkId=309297&clcid=0x409&slcid=0x409&campaign=o~msft~msdn~gettools-header~dn308572" id="GetTools_2153_3" xmlns="http://www.w3.org/1999/xhtml">Get tools</a>
- </div>
- </div>
- <div>
- <div data-fragmentname="SocialLinks" id="Fragment_SocialLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <ul class="links horizontal">
- <li>
- <a href="http://www.facebook.com/microsoftdeveloper" target="_blank" id="SocialLinks_2152_4" class="facebook" xmlns="http://www.w3.org/1999/xhtml">http://www.facebook.com/microsoftdeveloper</a>
- </li>
- <li>
- <a href="https://twitter.com/msdev" target="_blank" id="SocialLinks_2152_5" class="twitter" xmlns="http://www.w3.org/1999/xhtml">https://twitter.com/msdev</a>
- </li>
- <li>
- <a href="http://plus.google.com/111221966647232053570/" target="_blank" id="SocialLinks_2152_6" class="googlePlus" xmlns="http://www.w3.org/1999/xhtml">http://plus.google.com/111221966647232053570/</a>
- </li>
- </ul>
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- <div class="row middleRow">
- <div class="expandTop">
- <div class="left"></div>
- <div class="right"></div>
- </div>
- </div>
- </div>
- <div id="buttomRowWrapper" class="bg_default">
- <div class="row buttomRow bg_default">
- <div class="bottom">
- <div class="left">
- <a id="grip" class="menu-icon" href="javascript:void(0)"></a>
-
- <div id="drawer">
- <div class="toc">
-
- <nav>
- <ul class="navL1">
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Technologies">Technologies</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/cloud-app-development-msdn" title="Cloud">Cloud</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/app-development-msdn" title="App Development">App Development</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/web-app-development-msdn" title="Web">Web</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/big-data-development-msdn" title="Data">Data</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/games-development-msdn" title="Gaming">Gaming</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/internetofthings" title="Internet of Things">Internet of Things</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Downloads">Downloads</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://www.visualstudio.com/downloads/download-visual-studio-vs" title="Visual Studio">Visual Studio</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/subscriptions" title="MSDN subscription access">MSDN subscription access</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/microsoft-sdks-msdn" title="SDKs">SDKs</a>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Trial software">Trial software</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/evalcenter" title="Free downloads">Free downloads</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/officeevaluationresources" title="Office resources">Office resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/sharepoint2013resources" title="SharePoint Server 2013 resources">SharePoint Server 2013 resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/sqlserver2014expressresources" title="SQL Server 2014 Express resources">SQL Server 2014 Express resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/windowsserver2012r2resources" title="Windows Server 2012 resources">Windows Server 2012 resources</a>
- </li>
- </ul>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Programs">Programs</a>
- <ul class="navL2">
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Visual Studio subscriptions">Visual Studio subscriptions</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/msdn-subscriptions-overview" title="Overview">Overview</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/benefits-overview" title="Benefits">Benefits</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/msdn-subscriptions-administration" title="Administrators">Administrators</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Students">Students</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/imagine/imagine-home" title="Microsoft Imagine">Microsoft Imagine</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/microsoftstudentpartners" title="Microsoft Student Partners">Microsoft Student Partners</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Architects">Architects</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-overview-msdn" title="Overview">Overview</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-case-studies-msdn" title="Case studies">Case studies</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-blueprints-msdn" title="Blueprints">Blueprints</a>
- </li>
- <li class="inactive">
- <a href="http://blogs.msdn.com/b/msarchitecture/" title="Blog">Blog</a>
- </li>
- <li class="inactive">
- <a href="http://social.msdn.microsoft.com/forums/en-us/home?brandignore=true&sort=relevancedesc&searchterm=architecture+or+architect" title="Forums">Forums</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/applicationbuilder" title="ISV">ISV</a>
-
- </li>
- <li class="inactive">
- <a href="https://www.microsoft.com/bizspark" title="Startups">Startups</a>
-
- </li>
- <li class="inactive">
- <a href="https://rewards.msdn.microsoft.com/" title="TechRewards">TechRewards</a>
-
- </li>
- <li class="inactive">
- <a href="http://events.msdn.microsoft.com/" title="Events">Events</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Community">Community</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/magazine/dd767791" title="Magazine">Magazine</a>
-
- </li>
- <li class="inactive">
- <a href="https://social.msdn.microsoft.com/forums/" title="Forums">Forums</a>
-
- </li>
- <li class="inactive">
- <a href="http://blogs.msdn.com/b/developer-tools/" title="Blogs">Blogs</a>
-
- </li>
- <li class="inactive">
- <a href="http://tech-advisors.msdn.microsoft.com/en-us" title="Tech Advisors">Tech Advisors</a>
-
- </li>
- <li class="inactive">
- <a href="http://channel9.msdn.com/" title="Channel 9">Channel 9</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive current toggle">
- <a href="javascript:void(0)" title="Documentation">Documentation</a>
- <ul class="navL2">
- <li class="inactive current">
- <a href="https://msdn.microsoft.com/library" title="APIs and reference">APIs and reference</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/developer-centers-msdn" title="Dev centers">Dev centers</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive">
- <a href="https://code.msdn.microsoft.com/" title="Samples">Samples</a>
- </li>
- </ul>
- </nav>
- </div>
- </div>
- </div>
- <div class="right">
- <div data-fragmentname="SearchBox" id="Fragment_SearchBox" xmlns="http://www.w3.org/1999/xhtml">
- <div class="SearchBox">
- <form id="HeaderSearchForm" name="HeaderSearchForm" method="get">
- <button id="FakeHeaderSearchButton" value="Search" type="submit" class="header-search-button">
- <div id="search-finder" class="search-finder"></div>
- </button>
- <button id="HeaderSearchButton" style="display:none"></button>
- <div id="searchSplitter"></div>
- <div id="searchCloseIcon" class="search-clear-x"></div>
- <div id="searchTextContainer" style="width: 0;">
- <input id="HeaderSearchTextBox" name="query" type="text" maxlength="200" onfocus="Epx.Controls.SearchBox.watermarkFocus(event, this.title)" onblur="Epx.Controls.SearchBox.watermarkBlur(event, this.title)">
- </div>
- </form>
-
-
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- </header>
- </div>
-
-
-
- <div class="printExportMenus ltr">
- <a id="isd_printABook" href="http://msdn.microsoft.com/en-us/library/export/help/(d=printer)?returnurl=%2fen-us%2flibrary%2fhh706278(d%3dprinter,v%3dvs.85).aspx%3flan%3dcsharp%26cc%3dn%26trm%3dtra%26view%3dbook">
- Export (<span class="count">0</span>)
- </a>
- <a id="isd_print" href="https://msdn.microsoft.com/en-us/library/hh706278(d=printer,v=vs.85).aspx?lan=csharp&cc=n&trm=tra&view=book" rel="nofollow">
- Print
- </a>
- <a id="isd_archiveControl" style="display:none;" data-include-archive="Include Previous Version" data-exclude-archive="Exclude Previous Version">
- </a>
- </div>
-
- <div class="printExportMenus ltr">
- <a id="expandCollapseAll" accesskey="e" href="javascript:void(0)" title="Expand/Collapse all sections by pressing Ctrl + Shift + e">Expand All</a>
- </div>
-
- <div id="body" ms.pgarea="body">
- <span id="tabletView_large"></span>
- <span id="tabletView_small"></span>
- <span id="mobileView"></span>
-
- <div id="content" class="content">
- <input type="hidden" id="printForPab" value="true">
-
- <div class="topic" xmlns="http://www.w3.org/1999/xhtml">
- <h1 class="title">KMDF extensions and driver triples</h1>
-
- <div id="mainSection">
- <div class="clsServerSDKContent">
- </div>
- <p>In this topic, we discuss class-based extensions to the Kernel Mode Driver Framework (KMDF). Before you read this topic, you should understand the ideas presented in <a href="https://msdn.microsoft.com/en-us/library/hh439643(v=vs.85).aspx">Minidrivers and driver pairs</a> and <a href="https://msdn.microsoft.com/en-us/library/hh706279(v=vs.85).aspx">KMDF as a Generic Driver Pair Model</a>.</p>
- <p>For some device classes, Microsoft provides KMDF extensions that further reduce the amount of processing that must be performed by KMDF drivers. A driver that uses a class-based KMDF extension has these three pieces, which we call a <em>driver triple</em>.</p>
- <ul>
- <li>The Framework, which handles tasks common to most all drivers</li>
- <li>The class-based framework extension, which handles tasks that are specific to a particular class of devices</li>
- <li>The KMDF driver, which handles tasks that are specific to a particular device.</li>
- </ul>
- <p>The three drivers in a driver triple (KMDF driver, device-class KMDF extension, Framework) combine to form a single WDM driver.</p>
- <p>An example of a device-class KMDF extension is SpbCx.sys, which is the KMDF extension for the Simple Peripheral Bus (SPB) device class. The SPB class includes synchronous serial buses such as I2C and SPI. A driver triple for an I2C bus controller would look like this:</p>
- <ul>
- <li>The Framework handles general tasks that are common to most all drivers.</li>
- <li>SpbCx.sys handles tasks that are specific to the SPB bus class. These are tasks that are common to all SPB busses.</li>
- <li>The KMDF driver handles tasks that are specific to an I2C bus. Let's call this driver MyI2CBusDriver.sys.</li>
- </ul><img id="kmdfdrivertriple" alt="KMDF Driver Triple Extension" src="./Windows Kernel Development Articles (2016-03-30)_files/IC831359.png" title="KMDF Driver Triple Extension" xmlns=""><p>The three drivers in the driver triple (MyI2CBusDriver.sys, SpbCx.sys, Wdf01000.sys) combine to form a single WDM driver that serves as the function driver for the I2C bus controller. Wdf01000.sys (the Framework) owns the dispatch table for this driver, so when someone sends an IRP to the driver triple, it goes to the wdf01000.sys. If the wdf01000.sys can handle the IRP by itself, SpbCx.sys and MyI2CBusDriver.sys are not involved. If wdf01000.sys cannot handle the IRP by itself, it gets help by calling an event handler in SbpCx.sys.</p>
- <p></p>
- <p>Here are some examples of event handlers that might be implemented by MyI2CBusDriver.sys:</p>
- <ul>
- <li>EvtSpbControllerLock</li>
- <li>EvtSpbIoRead</li>
- <li>EvtSpbIoSequence</li>
- </ul>
- <p>Here are some examples of event handlers that are implemented by SpbCx.sys</p>
- <ul>
- <li>EvtIoRead</li>
- </ul>
- <p> </p>
- <p> </p>
- <p><a href="mailto:wsddocfb@microsoft.com?subject=Documentation%20feedback%20[wdkgetstart\wdkgetstart]:%20KMDF%20extensions%20and%20driver%20triples%20%20RELEASE:%20(3/4/2016)&body=%0A%0APRIVACY%20STATEMENT%0A%0AWe%20use%20your%20feedback%20to%20improve%20the%20documentation.%20We%20don%27t%20use%20your%20email%20address%20for%20any%20other%20purpose,%20and%20we%27ll%20remove%20your%20email%20address%20from%20our%20system%20after%20the%20issue%20that%20you%27re%20reporting%20is%20fixed.%20While%20we%27re%20working%20to%20fix%20this%20issue,%20we%20might%20send%20you%20an%20email%20message%20to%20ask%20for%20more%20info.%20Later,%20we%20might%20also%20send%20you%20an%20email%20message%20to%20let%20you%20know%20that%20we%27ve%20addressed%20your%20feedback.%0A%0AFor%20more%20info%20about%20Microsoft%27s%20privacy%20policy,%20see%20http://privacy.microsoft.com/en-us/default.aspx." title="Send comments about this topic to Microsoft">Send comments about this topic to Microsoft</a></p>
- </div>
- </div>
-
- </div>
- </div>
- <div class="clear"></div>
-
- <input name="__RequestVerificationToken" type="hidden" value="Y_ZLItitR82NdFjxHP5UW2gToOKbN8RShlDCjhIrdLflp57W4KvRLLTiguwAiZ2R8xqx8LkapnKrs7Fvc2_90byLNbY1">
- <input id="ratingValueSubmitUrl" type="hidden" value="https://msdn.microsoft.com/en-us/library/feedback/rate/hh706278(d=printer,v=vs.85).aspx">
- <input id="ratingAdditionalSubmitUrl" type="hidden" value="https://msdn.microsoft.com/en-us/library/feedback/additional/hh706278(d=printer,v=vs.85).aspx">
- <input id="isTopicRated" type="hidden" value="false">
- <div id="lib-footer" ms.pgarea="body">
-
-
- <link type="text/css" rel="stylesheet">
-
- <div id="ux-footer" class="" style="" dir="ltr">
-
- <div id="footerSock" class="librarySock both">
- <div id="footerSockInner">
- <a name="feedback"></a>
- <div class="rating">
- <div id="ratingSection1">
- <div class="title">
- Was this page helpful?
- </div>
- <div class="description">
- Your feedback about this content is important.<br>Let us know what you think.
- </div>
- <div class="buttons">
- <button class="button" id="ratingYes" aria-label="Yes, this page was helpful">Yes</button>
- <button class="button" id="ratingNo" aria-label="No, this page was not helpful">No</button>
- </div>
- <input id="ratingValue" type="hidden" value="">
- </div>
- <div id="ratingSection2">
- <div class="title left">
- Additional feedback?
- </div>
- <textarea id="ratingText" rows="6" cols="" maxlength="1500"></textarea>
- <div class="right">
- <div class="counter">
- <span id="feedbackTextCounter">1500</span> characters remaining
- </div>
- <div class="buttons">
- <button class="button" id="ratingSubmit" aria-label="Submit my additional feedback">Submit</button>
- <button class="button" id="ratingSkipThis" aria-label="Skip additional feedback">Skip this</button>
- </div>
- </div>
- </div>
- <div id="ratingSection3">
- <div class="title">
- Thank you!
- </div>
- <div class="description">
- We appreciate your feedback.
- </div>
- </div>
-
-
- <div id="contentFeedbackQAContainer" style="display: none;"></div>
- </div>
-
- <div class="userVoice">
- <div class="title">
- Help us improve MSDN.
- </div>
- <div class="description">
- Visit our UserVoice Page to submit and vote on ideas!
- </div>
- <div class="buttons">
- <a class="button" id="userVoiceButton" href="http://feedback.msdn.com/forums/257782-msdn-feature-suggestions/category/83975" target="_blank">Make a suggestion</a>
- </div>
- </div>
- <div class="clear"></div>
- </div>
- </div>
- <footer class="top">
- <div data-fragmentname="LeftLinks" id="Fragment_LeftLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Dev centers</div>
- <ul class="links">
- <li>
- <a href="https://dev.windows.com/" id="LeftLinks_2148_1" class="windowsBlue" xmlns="http://www.w3.org/1999/xhtml">Windows</a>
- </li>
- <li>
- <a href="http://dev.office.com/" id="LeftLinks_2148_3" class="office" xmlns="http://www.w3.org/1999/xhtml">Office</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/vstudio" id="LeftLinks_2148_4" class="visualStudio" xmlns="http://www.w3.org/1999/xhtml">Visual Studio</a>
- </li>
- <li>
- <a href="http://azure.microsoft.com/en-us/documentation/" target="_blank" id="LeftLinks_2148_12" xmlns="http://www.w3.org/1999/xhtml">Microsoft Azure</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/developer-centers-msdn" id="LeftLinks_2148_5" xmlns="http://www.w3.org/1999/xhtml">More...</a>
- </li>
- </ul>
- </div>
- </div>
- <div id="rightLinks">
- <div data-fragmentname="CenterLinks1" id="Fragment_CenterLinks1" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Learning resources</div>
- <ul class="links">
- <li>
- <a href="http://www.microsoftvirtualacademy.com/" id="CenterLinks1_2151_4" xmlns="http://www.w3.org/1999/xhtml">Microsoft Virtual Academy</a>
- </li>
- <li>
- <a href="http://channel9.msdn.com/" id="CenterLinks1_2151_5" xmlns="http://www.w3.org/1999/xhtml">Channel 9</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/magazine/" id="CenterLinks1_2151_7" xmlns="http://www.w3.org/1999/xhtml">MSDN Magazine</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks2" id="Fragment_CenterLinks2" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Community</div>
- <ul class="links">
- <li>
- <a href="https://social.msdn.microsoft.com/forums/en-us/home" id="CenterLinks2_2151_8" xmlns="http://www.w3.org/1999/xhtml">Forums</a>
- </li>
- <li>
- <a href="http://blogs.msdn.com/b/developer-tools/" id="CenterLinks2_2151_9" xmlns="http://www.w3.org/1999/xhtml">Blogs</a>
- </li>
- <li>
- <a href="http://www.codeplex.com/" id="CenterLinks2_2151_10" xmlns="http://www.w3.org/1999/xhtml">Codeplex</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks3" id="Fragment_CenterLinks3" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Support</div>
- <ul class="links">
- <li>
- <a href="https://msdn.microsoft.com/hh361695" id="CenterLinks3_2151_11" xmlns="http://www.w3.org/1999/xhtml">Self support</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks4" id="Fragment_CenterLinks4" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Programs</div>
- <ul class="links">
- <li>
- <a href="https://www.microsoft.com/bizspark/" id="CenterLinks4_2151_13" xmlns="http://www.w3.org/1999/xhtml">BizSpark (for startups)</a>
- </li>
- <li>
- <a href="https://www.dreamspark.com/" id="CenterLinks4_2151_14" xmlns="http://www.w3.org/1999/xhtml">DreamSpark</a>
- </li>
- <li>
- <a href="http://www.imaginecup.com/" id="CenterLinks4_2151_17" xmlns="http://www.w3.org/1999/xhtml">Imagine Cup</a>
- </li>
- </ul>
- </div>
- </div>
- </div>
- </footer>
- <footer class="bottom">
- <span class="localeContainer">
-
- <form class="selectLocale" id="selectLocaleForm" action="https://msdn.microsoft.com/en-us/selectlocale-dmc">
- <input type="hidden" name="fromPage" value="https%3a%2f%2fmsdn.microsoft.com%2fen-us%2flibrary%2fhh706278(d%3dprinter%2cv%3dvs.85).aspx%3flan%3dCSharp%26cc%3dn%26trm%3dtra%26view%3dbook">
- <a href="http://msdn.microsoft.com/#" onclick="$('#selectLocaleForm').submit();return false;" title="Change your language">United States (English)</a>
- </form>
- </span>
- <div data-fragmentname="BottomLinks" id="Fragment_BottomLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <ul class="links horizontal">
- <li>
- <a href="https://msdn.microsoft.com/newsletter.aspx" id="BottomLinks_2148_7" xmlns="http://www.w3.org/1999/xhtml">Newsletter</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/dn529288" id="BottomLinks_2148_8" xmlns="http://www.w3.org/1999/xhtml">Privacy & cookies</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/cc300389" id="BottomLinks_2148_9" xmlns="http://www.w3.org/1999/xhtml">Terms of use</a>
- </li>
- <li>
- <a href="https://www.microsoft.com/en-us/legal/intellectualproperty/Trademarks/EN-US.aspx" id="BottomLinks_2148_10" xmlns="http://www.w3.org/1999/xhtml">Trademarks</a>
- </li>
- </ul>
- </div>
- </div>
- <span class="logoLegal">
- <span class="logo"></span>
- <span class="copyright">© 2016 Microsoft</span>
- </span>
- </footer>
- </div>
-
- </div>
- <div class="footerPrintView">
- <div class="footerCopyrightPrintView">© 2016 Microsoft</div>
- </div>
-
-
-
-
- <input id="tocPaddingPerLevel" type="hidden" value="17">
- <input id="MtpsDevice" type="hidden" value="Printer">
- <!--[CDATA[ Third party scripts and code linked to or referenced from this website are licensed to you by the parties that own such code, not by Microsoft. See ASP.NET Ajax CDN Terms of Use – http://www.asp.net/ajaxlibrary/CDN.ashx. ]]-->
-
-
-
-
-
- <noscript><div><img alt="DCSIMG" id="Img1" width="1" height="1" src="https://m.webtrends.com/dcsmgru7m99k7mqmgrhudo0k8_8c6m/njs.gif?dcsuri=/nojavascript&amp;WT.js=No" /></div></noscript>
- <div id="globalRequestVerification">
- <input name="__RequestVerificationToken" type="hidden" value="hLUjEzoA1cBRbA7FPIW3B8W8LZfU3iaKD4FYPhl7wfyuJWRFbGrSYt1Tx2zig8XjIYVCWXJvMwR2H3DteKkomDs33C81">
- </div>
- </div>
-
-
-
-
-
-
- <script type="text/javascript" class="mtps-injected">
- /*<![CDATA[*/
- (function(window,document){"use strict";function preload(scripts){for(var result=[],script,e,i=0;i<scripts.length;i++)script=scripts[i],script.hasOwnProperty("url")&&(e=document.createElement("script"),e.src=script.url,script.throwaway=e),result.push(script);return result}function inject(scripts,index){var script,elem;if(index>=scripts.length){delete mtps.injectScripts;return}script=scripts[index];elem=document.createElement("script");elem.className="mtps-injected";elem.async=!1;var isLoaded=!1,timeoutId=0,injectNextFnName="",injectNext=elem.onerror=function(){isLoaded||(isLoaded=!0,inject(scripts,index+1),window.clearTimeout(timeoutId),elem.onload=elem.onerror=elem.onreadystatechange=null,injectNextFnName&&delete mtps[injectNextFnName],elem.removeEventListener&&elem.removeEventListener("load",injectNext,!1))};elem.addEventListener?elem.addEventListener("load",injectNext,!1):elem.readyState==="uninitialized"?elem.onreadystatechange=function(){(this.readyState==="loaded"||this.readyState==="complete")&&injectNext()}:elem.onload=injectNext;script.hasOwnProperty("url")?(timeoutId=window.setTimeout(injectNext,12e4),elem.src=script.url):(injectNextFnName="_injectNextScript_"+index,mtps[injectNextFnName]=injectNext,timeoutId=window.setTimeout(injectNext,2e3),elem.text="try {\n"+script.txt+"\n} finally { MTPS."+injectNextFnName+" && MTPS."+injectNextFnName+"(); }");parent.appendChild(elem)}var mtps=window.MTPS||(window.MTPS={}),parent=document.getElementsByTagName("head")[0];mtps.injectScripts=function(scripts){inject(preload(scripts),0)}})(window,document);
- MTPS.injectScripts([
- { txt: "/**/\r\n(window.MTPS || (window.MTPS = {})).cdnDomains || (window.MTPS.cdnDomains = { \r\n\t\"image\": \"https://i-msdn.sec.s-msft.com\", \r\n\t\"js\": \"https://i2-msdn.sec.s-msft.com\", \r\n\t\"css\": \"https://i-msdn.sec.s-msft.com\", \r\n\t\"ttf\": \"https://i-msdn.sec.s-msft.com\"\r\n});\r\n/**/" },
- { txt: "//\n var literalNormalizedUrl = \u0027/en-us/library/hh706278(d=printer,l=en-us,v=vs.85).aspx\u0027;\n var wt_nvr_ru = \u0027WT_NVR_RU\u0027;\n var wt_fpcdom = \u0027.microsoft.com\u0027;\n var wt_domlist = \u0027msdn.microsoft.com\u0027;\n var wt_pathlist = \u0027\u0027;\n var wt_paramlist = \u0027DCSext.mtps_devcenter\u0027;\n var wt_siteid = \u0027MSDN\u0027;\n var gDomain = \u0027m.webtrends.com\u0027;\n var gDcsId = \u0027dcsmgru7m99k7mqmgrhudo0k8_8c6m\u0027;\n var gFpc = \u0027WT_FPC\u0027;\n\n\n\n if (document.cookie.indexOf(gFpc + \"=\") == -1) {\n var wtidJs = document.createElement(\"script\");\n wtidJs.src = \"//\" + gDomain + \"/\" + gDcsId + \"/wtid.js\";\n document.getElementsByTagName(\"head\")[0].appendChild(wtidJs);\n }\n\n\n\n var detectedLocale = \u0027en-us\u0027;\n var wtsp = \u0027msdnlib_w32_com\u0027;\n var gTrackEvents = \u00270\u0027;\n/**/" },
- { txt: "//\n\n window.appInsightsId = \u00275eb1b2eb-c47a-497a-a7ac-a1c230b2882f\u0027;\n //" },
- { url: "https://i2-msdn.sec.s-msft.com/Combined.js?resources=0:Utilities,1:Layout,2:Header,1:Rating,2:Footer,0:Topic,3:PabTopic,4:webtrendsscript,0:AppInsightsPerf,0:ABTestControl,5:WEDCS,3:CmpgrpForHeader,0:livefyre,0:Comment,1:SearchBox;/Areas/Epx/Content/Scripts:0,/Areas/Epx/Themes/Base/Content:1,/Areas/Centers/Themes/StandardDevCenter/Content:2,/Areas/Library/Content:3,/Areas/Global/Content/Webtrends/resources:4,/Areas/Library/Themes/Base/Content:5\u0026amp;hashKey=30CEE944AABFEA2C5A338BDB9E000732\u0026amp;v=AE608271C0243AAA0449D3BC0FAD8EB4" },
- { url: "https://i1.services.social.microsoft.com/search/Widgets/SearchBox.jss?boxid=HeaderSearchTextBox\u0026btnid=HeaderSearchButton\u0026pgArea=header\u0026brand=Msdn\u0026loc=en-us\u0026focusOnInit=false\u0026emptyWatermark=true\u0026searchButtonTooltip=Search MSDN" },
- { url: "https://i2-msdn.sec.s-msft.com/Combined.js?resources=0:PrintExportButton,1:Toc_Fixed,1:CodeSnippet,1:TopicNotInScope,1:CollapsibleArea,1:VersionSelector,1:SurveyBroker;/Areas/Library/Themes/Base/Content:0,/Areas/Epx/Content/Scripts:1\u0026amp;hashKey=80F30894E3FB8A3295C923AEC7019CFE\u0026amp;v=AE608271C0243AAA0449D3BC0FAD8EB4" },
- { txt: "$(document).ready(function() {\n try {\n var token = $(\"#globalRequestVerification input[name=\u0027__RequestVerificationToken\u0027]\").clone();\n $(\"#siteFeedbackForm\").append(token);\n } catch(err) {\n \n }\n });" }
- ]);
- /*]]>*/
- </script>
- <link rel="stylesheet" type="text/css" href="./Windows Kernel Development Articles (2016-03-30)_files/Combined.css">
- <div id="page">
-
-
-
-
- <link type="text/css" rel="stylesheet">
-
- <input type="hidden" id="isHeaderBleeding" value="true">
- <div id="ux-header" dir="ltr" class="ltr msdn">
-
- <header>
- <span id="singleCol"></span>
- <span id="doubleCol"></span>
- <span id="isMobile"></span>
- <div>
- <div class="row topRow">
- <div class="top">
- <div class="left">
- <a class="msdnLogoImg" href="https://msdn.microsoft.com/en-us" title="MSDN home">
- <div id="msft-logo" class="msft-logo"></div>
- </a>
- <div class="GrayPipe"></div>
- <a class="DevCenterFullNameNonMegaBlade" href="https://msdn.microsoft.com/en-us">Developer Network</a>
- <a class="DevCenterFullName" href="https://msdn.microsoft.com/en-us">Developer Network</a>
- <a class="DevCenterShortName" href="https://msdn.microsoft.com/en-us">Developer</a>
- </div>
- <div class="right">
- <div id="signIn">
- <div class="profileImage"></div>
- <a class="scarabLink" href="https://login.live.com/login.srf?wa=wsignin1.0&rpsnv=12&ct=1459376413&rver=6.0.5276.0&wp=mcmbi&wlcxt=msdn%24msdn%24msdn&wreply=https%3a%2f%2fmsdn.microsoft.com%2fen-us%2flibrary%2fhh706280%2528d%3dprinter%2cv%3dvs.85%2529.aspx%3flan%3dcsharp%26cc%3dn%26trm%3dtra%26view%3dbook&lc=1033&id=254354&mkt=en-us" title="Sign in">Sign in</a></div>
- <div class="auxNav">
- <div>
- <div data-fragmentname="Subscriptions" id="Fragment_Subscriptions" xmlns="http://www.w3.org/1999/xhtml">
- <a href="https://msdn.microsoft.com/subscriptions/manage/hh442900" id="Subscriptions_2153_1" xmlns="http://www.w3.org/1999/xhtml">MSDN subscriptions</a>
- </div>
- <div data-fragmentname="GetTools" id="Fragment_GetTools" xmlns="http://www.w3.org/1999/xhtml">
- <a href="http://go.microsoft.com/fwlink/?LinkId=309297&clcid=0x409&slcid=0x409&campaign=o~msft~msdn~gettools-header~dn308572" id="GetTools_2153_3" xmlns="http://www.w3.org/1999/xhtml">Get tools</a>
- </div>
- </div>
- <div>
- <div data-fragmentname="SocialLinks" id="Fragment_SocialLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <ul class="links horizontal">
- <li>
- <a href="http://www.facebook.com/microsoftdeveloper" target="_blank" id="SocialLinks_2152_4" class="facebook" xmlns="http://www.w3.org/1999/xhtml">http://www.facebook.com/microsoftdeveloper</a>
- </li>
- <li>
- <a href="https://twitter.com/msdev" target="_blank" id="SocialLinks_2152_5" class="twitter" xmlns="http://www.w3.org/1999/xhtml">https://twitter.com/msdev</a>
- </li>
- <li>
- <a href="http://plus.google.com/111221966647232053570/" target="_blank" id="SocialLinks_2152_6" class="googlePlus" xmlns="http://www.w3.org/1999/xhtml">http://plus.google.com/111221966647232053570/</a>
- </li>
- </ul>
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- <div class="row middleRow">
- <div class="expandTop">
- <div class="left"></div>
- <div class="right"></div>
- </div>
- </div>
- </div>
- <div id="buttomRowWrapper" class="bg_default">
- <div class="row buttomRow bg_default">
- <div class="bottom">
- <div class="left">
- <a id="grip" class="menu-icon" href="javascript:void(0)"></a>
-
- <div id="drawer">
- <div class="toc">
-
- <nav>
- <ul class="navL1">
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Technologies">Technologies</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/cloud-app-development-msdn" title="Cloud">Cloud</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/app-development-msdn" title="App Development">App Development</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/web-app-development-msdn" title="Web">Web</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/big-data-development-msdn" title="Data">Data</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/games-development-msdn" title="Gaming">Gaming</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/internetofthings" title="Internet of Things">Internet of Things</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Downloads">Downloads</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://www.visualstudio.com/downloads/download-visual-studio-vs" title="Visual Studio">Visual Studio</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/subscriptions" title="MSDN subscription access">MSDN subscription access</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/microsoft-sdks-msdn" title="SDKs">SDKs</a>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Trial software">Trial software</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/evalcenter" title="Free downloads">Free downloads</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/officeevaluationresources" title="Office resources">Office resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/sharepoint2013resources" title="SharePoint Server 2013 resources">SharePoint Server 2013 resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/sqlserver2014expressresources" title="SQL Server 2014 Express resources">SQL Server 2014 Express resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/windowsserver2012r2resources" title="Windows Server 2012 resources">Windows Server 2012 resources</a>
- </li>
- </ul>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Programs">Programs</a>
- <ul class="navL2">
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Visual Studio subscriptions">Visual Studio subscriptions</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/msdn-subscriptions-overview" title="Overview">Overview</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/benefits-overview" title="Benefits">Benefits</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/msdn-subscriptions-administration" title="Administrators">Administrators</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Students">Students</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/imagine/imagine-home" title="Microsoft Imagine">Microsoft Imagine</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/microsoftstudentpartners" title="Microsoft Student Partners">Microsoft Student Partners</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Architects">Architects</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-overview-msdn" title="Overview">Overview</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-case-studies-msdn" title="Case studies">Case studies</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-blueprints-msdn" title="Blueprints">Blueprints</a>
- </li>
- <li class="inactive">
- <a href="http://blogs.msdn.com/b/msarchitecture/" title="Blog">Blog</a>
- </li>
- <li class="inactive">
- <a href="http://social.msdn.microsoft.com/forums/en-us/home?brandignore=true&sort=relevancedesc&searchterm=architecture+or+architect" title="Forums">Forums</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/applicationbuilder" title="ISV">ISV</a>
-
- </li>
- <li class="inactive">
- <a href="https://www.microsoft.com/bizspark" title="Startups">Startups</a>
-
- </li>
- <li class="inactive">
- <a href="https://rewards.msdn.microsoft.com/" title="TechRewards">TechRewards</a>
-
- </li>
- <li class="inactive">
- <a href="http://events.msdn.microsoft.com/" title="Events">Events</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Community">Community</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/magazine/dd767791" title="Magazine">Magazine</a>
-
- </li>
- <li class="inactive">
- <a href="https://social.msdn.microsoft.com/forums/" title="Forums">Forums</a>
-
- </li>
- <li class="inactive">
- <a href="http://blogs.msdn.com/b/developer-tools/" title="Blogs">Blogs</a>
-
- </li>
- <li class="inactive">
- <a href="http://tech-advisors.msdn.microsoft.com/en-us" title="Tech Advisors">Tech Advisors</a>
-
- </li>
- <li class="inactive">
- <a href="http://channel9.msdn.com/" title="Channel 9">Channel 9</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive current toggle">
- <a href="javascript:void(0)" title="Documentation">Documentation</a>
- <ul class="navL2">
- <li class="inactive current">
- <a href="https://msdn.microsoft.com/library" title="APIs and reference">APIs and reference</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/developer-centers-msdn" title="Dev centers">Dev centers</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive">
- <a href="https://code.msdn.microsoft.com/" title="Samples">Samples</a>
- </li>
- </ul>
- </nav>
- </div>
- </div>
- </div>
- <div class="right">
- <div data-fragmentname="SearchBox" id="Fragment_SearchBox" xmlns="http://www.w3.org/1999/xhtml">
- <div class="SearchBox">
- <form id="HeaderSearchForm" name="HeaderSearchForm" method="get">
- <button id="FakeHeaderSearchButton" value="Search" type="submit" class="header-search-button">
- <div id="search-finder" class="search-finder"></div>
- </button>
- <button id="HeaderSearchButton" style="display:none"></button>
- <div id="searchSplitter"></div>
- <div id="searchCloseIcon" class="search-clear-x"></div>
- <div id="searchTextContainer" style="width: 0;">
- <input id="HeaderSearchTextBox" name="query" type="text" maxlength="200" onfocus="Epx.Controls.SearchBox.watermarkFocus(event, this.title)" onblur="Epx.Controls.SearchBox.watermarkBlur(event, this.title)">
- </div>
- </form>
-
-
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- </header>
- </div>
-
-
-
- <div class="printExportMenus ltr">
- <a id="isd_printABook" href="http://msdn.microsoft.com/en-us/library/export/help/(d=printer)?returnurl=%2fen-us%2flibrary%2fhh706280(d%3dprinter,v%3dvs.85).aspx%3flan%3dcsharp%26cc%3dn%26trm%3dtra%26view%3dbook">
- Export (<span class="count">0</span>)
- </a>
- <a id="isd_print" href="https://msdn.microsoft.com/en-us/library/hh706280(d=printer,v=vs.85).aspx?lan=csharp&cc=n&trm=tra&view=book" rel="nofollow">
- Print
- </a>
- <a id="isd_archiveControl" style="display:none;" data-include-archive="Include Previous Version" data-exclude-archive="Exclude Previous Version">
- </a>
- </div>
-
- <div class="printExportMenus ltr">
- <a id="expandCollapseAll" accesskey="e" href="javascript:void(0)" title="Expand/Collapse all sections by pressing Ctrl + Shift + e">Expand All</a>
- </div>
-
- <div id="body" ms.pgarea="body">
- <span id="tabletView_large"></span>
- <span id="tabletView_small"></span>
- <span id="mobileView"></span>
-
- <div id="content" class="content">
- <input type="hidden" id="printForPab" value="true">
-
- <div class="topic" xmlns="http://www.w3.org/1999/xhtml">
- <h1 class="title">Upper and lower edges of drivers</h1>
-
- <div id="mainSection">
- <div class="clsServerSDKContent">
- </div>
- <p>The sequence of drivers that participate in an I/O request is called the driver stack for the request. A driver can call into the upper edge of a lower driver in the stack. A driver can also call into the lower edge of a higher driver in the stack.</p>
- <p>Before you read this topic, you should understand the ideas presented in <a href="https://msdn.microsoft.com/en-us/library/ff554721(v=vs.85).aspx">Device nodes and device stacks</a> and <a href="https://msdn.microsoft.com/en-us/library/hh439632(v=vs.85).aspx">Driver stacks</a>.</p>
- <p> I/O requests are processed first by the top driver in the driver stack, then by the next lower driver, and so on until the request is fully processed. </p>
- <p>When a driver implements a set of functions that a higher driver can call, that set of functions is called the <em>upper edge</em> of the driver or the <em>upper-edge interface</em> of the driver.</p>
- <p>When a driver implements a set of functions that a lower driver can call, that set of functions is called the <em>lower edge</em> of the driver or the <em>lower-edge interface</em> of the driver.</p>
- <h3><a id="Audio_example"></a><a id="audio_example"></a><a id="AUDIO_EXAMPLE"></a>Audio example</h3>
- <p>We can think of an audio miniport driver sitting below an audio port driver in a driver stack. The port driver makes calls to the miniport driver's upper edge. The miniport driver makes calls to the port driver's lower edge.</p><img id="AudioDrvStack" alt="Diagram of audio port driver above miniport driver" src="./Windows Kernel Development Articles (2016-03-30)_files/IC534970.png" title="Diagram of audio port driver above miniport driver" xmlns=""><p>The preceding diagram illustrates that it is sometimes useful to think of a port driver sitting above a miniport driver in a driver stack. Because I/O requests are processed first by the port driver and then by the miniport driver, it is reasonable to think of the port driver as being above the miniport driver. Keep in mind, however, that a (miniport, port) driver pair usually sits at a single level in a device stack, as shown here.</p><img id="upperloweredge01" alt="Diagram of device stack with (miniport/port) pair" src="./Windows Kernel Development Articles (2016-03-30)_files/IC554551.png" title="Diagram of device stack with (miniport/port) pair" xmlns=""><p>Note that a <em>device stack</em> is not the same thing as a <em>driver stack</em>. For definitions of these terms, and for a discussion of how a pair of drivers can form a single WDM driver that occupies one level in a device stack, see <a href="https://msdn.microsoft.com/en-us/library/hh439643(v=vs.85).aspx">Minidrivers and driver pairs</a>. </p>
- <p>Here's another way to draw a diagram of the same device node and device stack:</p><img id="upperloweredge02" alt="Diagram of device stack with port driver above miniport" src="./Windows Kernel Development Articles (2016-03-30)_files/IC554552.png" title="Diagram of device stack with port driver above miniport" xmlns=""><p>In the preceding diagram, we see that the (miniport, port) pair forms a single WDM driver that is associated with a single device object (the FDO) in the device stack; that is, the (miniport, port) pair occupies only one level in the device stack. But we also see a vertical relationship between the miniport and port drivers. The port driver is shown above the miniport driver to indicate that the port driver processes I/O requests first and then calls into the miniport driver for additional processing.</p>
- <p>The key point is that when the port driver calls into the miniport driver's upper-edge interface, that is not the same as passing an I/O request down the device stack. In a driver stack (not device stack) you can choose to draw a port driver above a miniport driver, but that does not mean that the port driver is above the miniport driver in the device stack.</p>
- <h3><a id="NDIS_example"></a><a id="ndis_example"></a><a id="NDIS_EXAMPLE"></a>NDIS example</h3>
- <p>Sometimes a driver calls the upper edge of a lower driver indirectly. For example, suppose a <a href="https://msdn.microsoft.com/en-us/library/ff556929(v=vs.85).aspx">TCP/IP protocol driver</a> sits above an <a href="https://msdn.microsoft.com/en-us/library/ff565448(v=vs.85).aspx">NDIS</a> miniport driver in a driver stack. The miniport driver implements a set of <em>MiniportXxx</em> functions that form the miniport driver's upper edge. We say that the TCP/IP protocol driver <em>binds</em> to the upper edge of the NDIS miniport driver. But the TCP/IP driver does not call the <em>MiniportXxx</em> functions directly. Instead, it calls functions in the NDIS library, which then call the <em>MiniportXxx</em> functions.</p><img id="UpperLowerEdge03" alt="Diagram of TCP/IP and NDIS miniport stack" src="./Windows Kernel Development Articles (2016-03-30)_files/IC686629.png" title="Diagram of TCP/IP and NDIS miniport stack" xmlns=""><p>The preceding diagram shows a driver stack. Here's another view of the same drivers.</p><img id="UpperLowerEdge04" alt="Diagram of device stack for a network card" src="./Windows Kernel Development Articles (2016-03-30)_files/IC686630.png" title="Diagram of device stack for a network card" xmlns=""><p>The preceding diagram shows the device node for a network interface card (NIC). The device node has a position in the Plug and Play (PnP) device tree. The device node for the NIC has a device stack with three device objects. Notice that the NDIS miniport driver and the NDIS library work as a pair. The pair (MyMiniport.sys, Ndis.sys) forms a single WDM driver that is represented by the functional device object (FDO).</p>
- <p>Also notice that the protocol driver Tcpip.sys is not part of the device stack for the NIC. In fact, Tcpip.sys is not part of the PnP device tree at all.</p>
- <h2><a id="Summary"></a><a id="summary"></a><a id="SUMMARY"></a>Summary</h2>
- <p>The terms <em>upper edge</em> and <em>lower edge</em> are used to describe the interfaces that drivers in a stack use to communicate with each other. A <a href="https://msdn.microsoft.com/en-us/library/hh439632(v=vs.85).aspx"><em xmlns="http://www.w3.org/1999/xhtml">driver stack</em></a> is not the same thing as <a href="https://msdn.microsoft.com/en-us/library/ff554721(v=vs.85).aspx"><em xmlns="http://www.w3.org/1999/xhtml">device stack</em></a>. Two drivers that are shown vertically in a driver stack might form a driver pair that sits at a single level in a device stack. Some drivers are not part of the PnP device tree.</p>
- <h2><a id="related_topics"></a>Related topics</h2>
- <dl>
- <dt>
- <a href="https://msdn.microsoft.com/en-us/library/ff554731(v=vs.85).aspx">Concepts for all driver developers</a>
- </dt>
- <dt>
- <a href="https://msdn.microsoft.com/en-us/library/ff554721(v=vs.85).aspx">Device nodes and device stacks</a>
- </dt>
- <dt>
- <a href="https://msdn.microsoft.com/en-us/library/hh439632(v=vs.85).aspx">Driver stacks</a>
- </dt>
- <dt>
- <a href="https://msdn.microsoft.com/en-us/library/ff537760(v=vs.85).aspx">Audio Devices</a>
- </dt>
- <dt>
- <a href="https://msdn.microsoft.com/en-us/library/ff570021(v=vs.85).aspx">Network Drivers Starting with Windows Vista</a>
- </dt>
- </dl>
- <p> </p>
- <p> </p>
- <p><a href="mailto:wsddocfb@microsoft.com?subject=Documentation%20feedback%20[wdkgetstart\wdkgetstart]:%20Upper%20and%20lower%20edges%20of%20drivers%20%20RELEASE:%20(3/4/2016)&body=%0A%0APRIVACY%20STATEMENT%0A%0AWe%20use%20your%20feedback%20to%20improve%20the%20documentation.%20We%20don%27t%20use%20your%20email%20address%20for%20any%20other%20purpose,%20and%20we%27ll%20remove%20your%20email%20address%20from%20our%20system%20after%20the%20issue%20that%20you%27re%20reporting%20is%20fixed.%20While%20we%27re%20working%20to%20fix%20this%20issue,%20we%20might%20send%20you%20an%20email%20message%20to%20ask%20for%20more%20info.%20Later,%20we%20might%20also%20send%20you%20an%20email%20message%20to%20let%20you%20know%20that%20we%27ve%20addressed%20your%20feedback.%0A%0AFor%20more%20info%20about%20Microsoft%27s%20privacy%20policy,%20see%20http://privacy.microsoft.com/en-us/default.aspx." title="Send comments about this topic to Microsoft">Send comments about this topic to Microsoft</a></p>
- </div>
- </div>
-
- </div>
- </div>
- <div class="clear"></div>
-
- <input name="__RequestVerificationToken" type="hidden" value="tVn6GYeM4ftFPo661EPjc8mNQv64fPdD8CqPp4VdlNAkYf_JW0v3kgQRRgZH5P90oLlTspSAG0M_tRVCTYxzS95ZOr41">
- <input id="ratingValueSubmitUrl" type="hidden" value="https://msdn.microsoft.com/en-us/library/feedback/rate/hh706280(d=printer,v=vs.85).aspx">
- <input id="ratingAdditionalSubmitUrl" type="hidden" value="https://msdn.microsoft.com/en-us/library/feedback/additional/hh706280(d=printer,v=vs.85).aspx">
- <input id="isTopicRated" type="hidden" value="false">
- <div id="lib-footer" ms.pgarea="body">
-
-
- <link type="text/css" rel="stylesheet">
-
- <div id="ux-footer" class="" style="" dir="ltr">
-
- <div id="footerSock" class="librarySock both">
- <div id="footerSockInner">
- <a name="feedback"></a>
- <div class="rating">
- <div id="ratingSection1">
- <div class="title">
- Was this page helpful?
- </div>
- <div class="description">
- Your feedback about this content is important.<br>Let us know what you think.
- </div>
- <div class="buttons">
- <button class="button" id="ratingYes" aria-label="Yes, this page was helpful">Yes</button>
- <button class="button" id="ratingNo" aria-label="No, this page was not helpful">No</button>
- </div>
- <input id="ratingValue" type="hidden" value="">
- </div>
- <div id="ratingSection2">
- <div class="title left">
- Additional feedback?
- </div>
- <textarea id="ratingText" rows="6" cols="" maxlength="1500"></textarea>
- <div class="right">
- <div class="counter">
- <span id="feedbackTextCounter">1500</span> characters remaining
- </div>
- <div class="buttons">
- <button class="button" id="ratingSubmit" aria-label="Submit my additional feedback">Submit</button>
- <button class="button" id="ratingSkipThis" aria-label="Skip additional feedback">Skip this</button>
- </div>
- </div>
- </div>
- <div id="ratingSection3">
- <div class="title">
- Thank you!
- </div>
- <div class="description">
- We appreciate your feedback.
- </div>
- </div>
-
-
- <div id="contentFeedbackQAContainer" style="display: none;"></div>
- </div>
-
- <div class="userVoice">
- <div class="title">
- Help us improve MSDN.
- </div>
- <div class="description">
- Visit our UserVoice Page to submit and vote on ideas!
- </div>
- <div class="buttons">
- <a class="button" id="userVoiceButton" href="http://feedback.msdn.com/forums/257782-msdn-feature-suggestions/category/83975" target="_blank">Make a suggestion</a>
- </div>
- </div>
- <div class="clear"></div>
- </div>
- </div>
- <footer class="top">
- <div data-fragmentname="LeftLinks" id="Fragment_LeftLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Dev centers</div>
- <ul class="links">
- <li>
- <a href="https://dev.windows.com/" id="LeftLinks_2148_1" class="windowsBlue" xmlns="http://www.w3.org/1999/xhtml">Windows</a>
- </li>
- <li>
- <a href="http://dev.office.com/" id="LeftLinks_2148_3" class="office" xmlns="http://www.w3.org/1999/xhtml">Office</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/vstudio" id="LeftLinks_2148_4" class="visualStudio" xmlns="http://www.w3.org/1999/xhtml">Visual Studio</a>
- </li>
- <li>
- <a href="http://azure.microsoft.com/en-us/documentation/" target="_blank" id="LeftLinks_2148_12" xmlns="http://www.w3.org/1999/xhtml">Microsoft Azure</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/developer-centers-msdn" id="LeftLinks_2148_5" xmlns="http://www.w3.org/1999/xhtml">More...</a>
- </li>
- </ul>
- </div>
- </div>
- <div id="rightLinks">
- <div data-fragmentname="CenterLinks1" id="Fragment_CenterLinks1" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Learning resources</div>
- <ul class="links">
- <li>
- <a href="http://www.microsoftvirtualacademy.com/" id="CenterLinks1_2151_4" xmlns="http://www.w3.org/1999/xhtml">Microsoft Virtual Academy</a>
- </li>
- <li>
- <a href="http://channel9.msdn.com/" id="CenterLinks1_2151_5" xmlns="http://www.w3.org/1999/xhtml">Channel 9</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/magazine/" id="CenterLinks1_2151_7" xmlns="http://www.w3.org/1999/xhtml">MSDN Magazine</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks2" id="Fragment_CenterLinks2" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Community</div>
- <ul class="links">
- <li>
- <a href="https://social.msdn.microsoft.com/forums/en-us/home" id="CenterLinks2_2151_8" xmlns="http://www.w3.org/1999/xhtml">Forums</a>
- </li>
- <li>
- <a href="http://blogs.msdn.com/b/developer-tools/" id="CenterLinks2_2151_9" xmlns="http://www.w3.org/1999/xhtml">Blogs</a>
- </li>
- <li>
- <a href="http://www.codeplex.com/" id="CenterLinks2_2151_10" xmlns="http://www.w3.org/1999/xhtml">Codeplex</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks3" id="Fragment_CenterLinks3" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Support</div>
- <ul class="links">
- <li>
- <a href="https://msdn.microsoft.com/hh361695" id="CenterLinks3_2151_11" xmlns="http://www.w3.org/1999/xhtml">Self support</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks4" id="Fragment_CenterLinks4" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Programs</div>
- <ul class="links">
- <li>
- <a href="https://www.microsoft.com/bizspark/" id="CenterLinks4_2151_13" xmlns="http://www.w3.org/1999/xhtml">BizSpark (for startups)</a>
- </li>
- <li>
- <a href="https://www.dreamspark.com/" id="CenterLinks4_2151_14" xmlns="http://www.w3.org/1999/xhtml">DreamSpark</a>
- </li>
- <li>
- <a href="http://www.imaginecup.com/" id="CenterLinks4_2151_17" xmlns="http://www.w3.org/1999/xhtml">Imagine Cup</a>
- </li>
- </ul>
- </div>
- </div>
- </div>
- </footer>
- <footer class="bottom">
- <span class="localeContainer">
-
- <form class="selectLocale" id="selectLocaleForm" action="https://msdn.microsoft.com/en-us/selectlocale-dmc">
- <input type="hidden" name="fromPage" value="https%3a%2f%2fmsdn.microsoft.com%2fen-us%2flibrary%2fhh706280(d%3dprinter%2cv%3dvs.85).aspx%3flan%3dCSharp%26cc%3dn%26trm%3dtra%26view%3dbook">
- <a href="http://msdn.microsoft.com/#" onclick="$('#selectLocaleForm').submit();return false;" title="Change your language">United States (English)</a>
- </form>
- </span>
- <div data-fragmentname="BottomLinks" id="Fragment_BottomLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <ul class="links horizontal">
- <li>
- <a href="https://msdn.microsoft.com/newsletter.aspx" id="BottomLinks_2148_7" xmlns="http://www.w3.org/1999/xhtml">Newsletter</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/dn529288" id="BottomLinks_2148_8" xmlns="http://www.w3.org/1999/xhtml">Privacy & cookies</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/cc300389" id="BottomLinks_2148_9" xmlns="http://www.w3.org/1999/xhtml">Terms of use</a>
- </li>
- <li>
- <a href="https://www.microsoft.com/en-us/legal/intellectualproperty/Trademarks/EN-US.aspx" id="BottomLinks_2148_10" xmlns="http://www.w3.org/1999/xhtml">Trademarks</a>
- </li>
- </ul>
- </div>
- </div>
- <span class="logoLegal">
- <span class="logo"></span>
- <span class="copyright">© 2016 Microsoft</span>
- </span>
- </footer>
- </div>
-
- </div>
- <div class="footerPrintView">
- <div class="footerCopyrightPrintView">© 2016 Microsoft</div>
- </div>
-
-
-
-
- <input id="tocPaddingPerLevel" type="hidden" value="17">
- <input id="MtpsDevice" type="hidden" value="Printer">
- <!--[CDATA[ Third party scripts and code linked to or referenced from this website are licensed to you by the parties that own such code, not by Microsoft. See ASP.NET Ajax CDN Terms of Use – http://www.asp.net/ajaxlibrary/CDN.ashx. ]]-->
-
-
-
-
-
- <noscript><div><img alt="DCSIMG" id="Img1" width="1" height="1" src="https://m.webtrends.com/dcsmgru7m99k7mqmgrhudo0k8_8c6m/njs.gif?dcsuri=/nojavascript&amp;WT.js=No" /></div></noscript>
- <div id="globalRequestVerification">
- <input name="__RequestVerificationToken" type="hidden" value="BE6aMRYKDuQYpxoPXSaq9djjAFfYUOv6ZJQiEFptVgKqBjoyuSfjhk4MAuwV4HxSNyyuyO39O0VGK-CQv2jMue2Wwmc1">
- </div>
- </div>
-
-
-
-
-
-
- <script type="text/javascript" class="mtps-injected">
- /*<![CDATA[*/
- (function(window,document){"use strict";function preload(scripts){for(var result=[],script,e,i=0;i<scripts.length;i++)script=scripts[i],script.hasOwnProperty("url")&&(e=document.createElement("script"),e.src=script.url,script.throwaway=e),result.push(script);return result}function inject(scripts,index){var script,elem;if(index>=scripts.length){delete mtps.injectScripts;return}script=scripts[index];elem=document.createElement("script");elem.className="mtps-injected";elem.async=!1;var isLoaded=!1,timeoutId=0,injectNextFnName="",injectNext=elem.onerror=function(){isLoaded||(isLoaded=!0,inject(scripts,index+1),window.clearTimeout(timeoutId),elem.onload=elem.onerror=elem.onreadystatechange=null,injectNextFnName&&delete mtps[injectNextFnName],elem.removeEventListener&&elem.removeEventListener("load",injectNext,!1))};elem.addEventListener?elem.addEventListener("load",injectNext,!1):elem.readyState==="uninitialized"?elem.onreadystatechange=function(){(this.readyState==="loaded"||this.readyState==="complete")&&injectNext()}:elem.onload=injectNext;script.hasOwnProperty("url")?(timeoutId=window.setTimeout(injectNext,12e4),elem.src=script.url):(injectNextFnName="_injectNextScript_"+index,mtps[injectNextFnName]=injectNext,timeoutId=window.setTimeout(injectNext,2e3),elem.text="try {\n"+script.txt+"\n} finally { MTPS."+injectNextFnName+" && MTPS."+injectNextFnName+"(); }");parent.appendChild(elem)}var mtps=window.MTPS||(window.MTPS={}),parent=document.getElementsByTagName("head")[0];mtps.injectScripts=function(scripts){inject(preload(scripts),0)}})(window,document);
- MTPS.injectScripts([
- { txt: "/**/\r\n(window.MTPS || (window.MTPS = {})).cdnDomains || (window.MTPS.cdnDomains = { \r\n\t\"image\": \"https://i-msdn.sec.s-msft.com\", \r\n\t\"js\": \"https://i2-msdn.sec.s-msft.com\", \r\n\t\"css\": \"https://i-msdn.sec.s-msft.com\", \r\n\t\"ttf\": \"https://i-msdn.sec.s-msft.com\"\r\n});\r\n/**/" },
- { txt: "//\n var literalNormalizedUrl = \u0027/en-us/library/hh706280(d=printer,l=en-us,v=vs.85).aspx\u0027;\n var wt_nvr_ru = \u0027WT_NVR_RU\u0027;\n var wt_fpcdom = \u0027.microsoft.com\u0027;\n var wt_domlist = \u0027msdn.microsoft.com\u0027;\n var wt_pathlist = \u0027\u0027;\n var wt_paramlist = \u0027DCSext.mtps_devcenter\u0027;\n var wt_siteid = \u0027MSDN\u0027;\n var gDomain = \u0027m.webtrends.com\u0027;\n var gDcsId = \u0027dcsmgru7m99k7mqmgrhudo0k8_8c6m\u0027;\n var gFpc = \u0027WT_FPC\u0027;\n\n\n\n if (document.cookie.indexOf(gFpc + \"=\") == -1) {\n var wtidJs = document.createElement(\"script\");\n wtidJs.src = \"//\" + gDomain + \"/\" + gDcsId + \"/wtid.js\";\n document.getElementsByTagName(\"head\")[0].appendChild(wtidJs);\n }\n\n\n\n var detectedLocale = \u0027en-us\u0027;\n var wtsp = \u0027msdnlib_w32_com\u0027;\n var gTrackEvents = \u00270\u0027;\n/**/" },
- { txt: "//\n\n window.appInsightsId = \u00275eb1b2eb-c47a-497a-a7ac-a1c230b2882f\u0027;\n //" },
- { url: "https://i2-msdn.sec.s-msft.com/Combined.js?resources=0:Utilities,1:Layout,2:Header,1:Rating,2:Footer,0:Topic,3:PabTopic,4:webtrendsscript,0:AppInsightsPerf,0:ABTestControl,5:WEDCS,3:CmpgrpForHeader,0:livefyre,0:Comment,1:SearchBox;/Areas/Epx/Content/Scripts:0,/Areas/Epx/Themes/Base/Content:1,/Areas/Centers/Themes/StandardDevCenter/Content:2,/Areas/Library/Content:3,/Areas/Global/Content/Webtrends/resources:4,/Areas/Library/Themes/Base/Content:5\u0026amp;hashKey=30CEE944AABFEA2C5A338BDB9E000732\u0026amp;v=AE608271C0243AAA0449D3BC0FAD8EB4" },
- { url: "https://i1.services.social.microsoft.com/search/Widgets/SearchBox.jss?boxid=HeaderSearchTextBox\u0026btnid=HeaderSearchButton\u0026pgArea=header\u0026brand=Msdn\u0026loc=en-us\u0026focusOnInit=false\u0026emptyWatermark=true\u0026searchButtonTooltip=Search MSDN" },
- { url: "https://i2-msdn.sec.s-msft.com/Combined.js?resources=0:PrintExportButton,1:Toc_Fixed,1:CodeSnippet,1:TopicNotInScope,1:CollapsibleArea,1:VersionSelector,1:SurveyBroker;/Areas/Library/Themes/Base/Content:0,/Areas/Epx/Content/Scripts:1\u0026amp;hashKey=80F30894E3FB8A3295C923AEC7019CFE\u0026amp;v=AE608271C0243AAA0449D3BC0FAD8EB4" },
- { txt: "$(document).ready(function() {\n try {\n var token = $(\"#globalRequestVerification input[name=\u0027__RequestVerificationToken\u0027]\").clone();\n $(\"#siteFeedbackForm\").append(token);\n } catch(err) {\n \n }\n });" }
- ]);
- /*]]>*/
- </script>
- <link rel="stylesheet" type="text/css" href="./Windows Kernel Development Articles (2016-03-30)_files/Combined.css">
- <div id="page">
-
-
-
-
- <link type="text/css" rel="stylesheet">
-
- <input type="hidden" id="isHeaderBleeding" value="true">
- <div id="ux-header" dir="ltr" class="ltr msdn">
-
- <header>
- <span id="singleCol"></span>
- <span id="doubleCol"></span>
- <span id="isMobile"></span>
- <div>
- <div class="row topRow">
- <div class="top">
- <div class="left">
- <a class="msdnLogoImg" href="https://msdn.microsoft.com/en-us" title="MSDN home">
- <div id="msft-logo" class="msft-logo"></div>
- </a>
- <div class="GrayPipe"></div>
- <a class="DevCenterFullNameNonMegaBlade" href="https://msdn.microsoft.com/en-us">Developer Network</a>
- <a class="DevCenterFullName" href="https://msdn.microsoft.com/en-us">Developer Network</a>
- <a class="DevCenterShortName" href="https://msdn.microsoft.com/en-us">Developer</a>
- </div>
- <div class="right">
- <div id="signIn">
- <div class="profileImage"></div>
- <a class="scarabLink" href="https://login.live.com/login.srf?wa=wsignin1.0&rpsnv=12&ct=1459376414&rver=6.0.5276.0&wp=mcmbi&wlcxt=msdn%24msdn%24msdn&wreply=https%3a%2f%2fmsdn.microsoft.com%2fen-us%2flibrary%2fff554695%2528d%3dprinter%2cv%3dvs.85%2529.aspx%3flan%3dcsharp%26cc%3dn%26trm%3dtra%26view%3dbook&lc=1033&id=254354&mkt=en-us" title="Sign in">Sign in</a></div>
- <div class="auxNav">
- <div>
- <div data-fragmentname="Subscriptions" id="Fragment_Subscriptions" xmlns="http://www.w3.org/1999/xhtml">
- <a href="https://msdn.microsoft.com/subscriptions/manage/hh442900" id="Subscriptions_2153_1" xmlns="http://www.w3.org/1999/xhtml">MSDN subscriptions</a>
- </div>
- <div data-fragmentname="GetTools" id="Fragment_GetTools" xmlns="http://www.w3.org/1999/xhtml">
- <a href="http://go.microsoft.com/fwlink/?LinkId=309297&clcid=0x409&slcid=0x409&campaign=o~msft~msdn~gettools-header~dn308572" id="GetTools_2153_3" xmlns="http://www.w3.org/1999/xhtml">Get tools</a>
- </div>
- </div>
- <div>
- <div data-fragmentname="SocialLinks" id="Fragment_SocialLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <ul class="links horizontal">
- <li>
- <a href="http://www.facebook.com/microsoftdeveloper" target="_blank" id="SocialLinks_2152_4" class="facebook" xmlns="http://www.w3.org/1999/xhtml">http://www.facebook.com/microsoftdeveloper</a>
- </li>
- <li>
- <a href="https://twitter.com/msdev" target="_blank" id="SocialLinks_2152_5" class="twitter" xmlns="http://www.w3.org/1999/xhtml">https://twitter.com/msdev</a>
- </li>
- <li>
- <a href="http://plus.google.com/111221966647232053570/" target="_blank" id="SocialLinks_2152_6" class="googlePlus" xmlns="http://www.w3.org/1999/xhtml">http://plus.google.com/111221966647232053570/</a>
- </li>
- </ul>
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- <div class="row middleRow">
- <div class="expandTop">
- <div class="left"></div>
- <div class="right"></div>
- </div>
- </div>
- </div>
- <div id="buttomRowWrapper" class="bg_default">
- <div class="row buttomRow bg_default">
- <div class="bottom">
- <div class="left">
- <a id="grip" class="menu-icon" href="javascript:void(0)"></a>
-
- <div id="drawer">
- <div class="toc">
-
- <nav>
- <ul class="navL1">
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Technologies">Technologies</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/cloud-app-development-msdn" title="Cloud">Cloud</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/app-development-msdn" title="App Development">App Development</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/web-app-development-msdn" title="Web">Web</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/big-data-development-msdn" title="Data">Data</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/games-development-msdn" title="Gaming">Gaming</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/internetofthings" title="Internet of Things">Internet of Things</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Downloads">Downloads</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://www.visualstudio.com/downloads/download-visual-studio-vs" title="Visual Studio">Visual Studio</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/subscriptions" title="MSDN subscription access">MSDN subscription access</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/microsoft-sdks-msdn" title="SDKs">SDKs</a>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Trial software">Trial software</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/evalcenter" title="Free downloads">Free downloads</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/officeevaluationresources" title="Office resources">Office resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/sharepoint2013resources" title="SharePoint Server 2013 resources">SharePoint Server 2013 resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/sqlserver2014expressresources" title="SQL Server 2014 Express resources">SQL Server 2014 Express resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/windowsserver2012r2resources" title="Windows Server 2012 resources">Windows Server 2012 resources</a>
- </li>
- </ul>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Programs">Programs</a>
- <ul class="navL2">
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Visual Studio subscriptions">Visual Studio subscriptions</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/msdn-subscriptions-overview" title="Overview">Overview</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/benefits-overview" title="Benefits">Benefits</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/msdn-subscriptions-administration" title="Administrators">Administrators</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Students">Students</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/imagine/imagine-home" title="Microsoft Imagine">Microsoft Imagine</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/microsoftstudentpartners" title="Microsoft Student Partners">Microsoft Student Partners</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Architects">Architects</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-overview-msdn" title="Overview">Overview</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-case-studies-msdn" title="Case studies">Case studies</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-blueprints-msdn" title="Blueprints">Blueprints</a>
- </li>
- <li class="inactive">
- <a href="http://blogs.msdn.com/b/msarchitecture/" title="Blog">Blog</a>
- </li>
- <li class="inactive">
- <a href="http://social.msdn.microsoft.com/forums/en-us/home?brandignore=true&sort=relevancedesc&searchterm=architecture+or+architect" title="Forums">Forums</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/applicationbuilder" title="ISV">ISV</a>
-
- </li>
- <li class="inactive">
- <a href="https://www.microsoft.com/bizspark" title="Startups">Startups</a>
-
- </li>
- <li class="inactive">
- <a href="https://rewards.msdn.microsoft.com/" title="TechRewards">TechRewards</a>
-
- </li>
- <li class="inactive">
- <a href="http://events.msdn.microsoft.com/" title="Events">Events</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Community">Community</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/magazine/dd767791" title="Magazine">Magazine</a>
-
- </li>
- <li class="inactive">
- <a href="https://social.msdn.microsoft.com/forums/" title="Forums">Forums</a>
-
- </li>
- <li class="inactive">
- <a href="http://blogs.msdn.com/b/developer-tools/" title="Blogs">Blogs</a>
-
- </li>
- <li class="inactive">
- <a href="http://tech-advisors.msdn.microsoft.com/en-us" title="Tech Advisors">Tech Advisors</a>
-
- </li>
- <li class="inactive">
- <a href="http://channel9.msdn.com/" title="Channel 9">Channel 9</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive current toggle">
- <a href="javascript:void(0)" title="Documentation">Documentation</a>
- <ul class="navL2">
- <li class="inactive current">
- <a href="https://msdn.microsoft.com/library" title="APIs and reference">APIs and reference</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/developer-centers-msdn" title="Dev centers">Dev centers</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive">
- <a href="https://code.msdn.microsoft.com/" title="Samples">Samples</a>
- </li>
- </ul>
- </nav>
- </div>
- </div>
- </div>
- <div class="right">
- <div data-fragmentname="SearchBox" id="Fragment_SearchBox" xmlns="http://www.w3.org/1999/xhtml">
- <div class="SearchBox">
- <form id="HeaderSearchForm" name="HeaderSearchForm" method="get">
- <button id="FakeHeaderSearchButton" value="Search" type="submit" class="header-search-button">
- <div id="search-finder" class="search-finder"></div>
- </button>
- <button id="HeaderSearchButton" style="display:none"></button>
- <div id="searchSplitter"></div>
- <div id="searchCloseIcon" class="search-clear-x"></div>
- <div id="searchTextContainer" style="width: 0;">
- <input id="HeaderSearchTextBox" name="query" type="text" maxlength="200" onfocus="Epx.Controls.SearchBox.watermarkFocus(event, this.title)" onblur="Epx.Controls.SearchBox.watermarkBlur(event, this.title)">
- </div>
- </form>
-
-
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- </header>
- </div>
-
-
-
- <div class="printExportMenus ltr">
- <a id="isd_printABook" href="http://msdn.microsoft.com/en-us/library/export/help/(d=printer)?returnurl=%2fen-us%2flibrary%2fff554695(d%3dprinter,v%3dvs.85).aspx%3flan%3dcsharp%26cc%3dn%26trm%3dtra%26view%3dbook">
- Export (<span class="count">0</span>)
- </a>
- <a id="isd_print" href="https://msdn.microsoft.com/en-us/library/ff554695(d=printer,v=vs.85).aspx?lan=csharp&cc=n&trm=tra&view=book" rel="nofollow">
- Print
- </a>
- <a id="isd_archiveControl" style="display:none;" data-include-archive="Include Previous Version" data-exclude-archive="Exclude Previous Version">
- </a>
- </div>
-
- <div class="printExportMenus ltr">
- <a id="expandCollapseAll" accesskey="e" href="javascript:void(0)" title="Expand/Collapse all sections by pressing Ctrl + Shift + e">Expand All</a>
- </div>
-
- <div id="body" ms.pgarea="body">
- <span id="tabletView_large"></span>
- <span id="tabletView_small"></span>
- <span id="mobileView"></span>
-
- <div id="content" class="content">
- <input type="hidden" id="printForPab" value="true">
-
- <div class="topic" xmlns="http://www.w3.org/1999/xhtml">
- <h1 class="title">Header files in the Windows Driver Kit</h1>
-
- <div id="mainSection">
- <div class="clsServerSDKContent">
- </div>
- <p>The <a href="https://msdn.microsoft.com/en-us/library/ff557573(v=vs.85).aspx">Windows Driver Kit (WDK)</a> contains all the header files (.h files) that you need to build kernel-mode and user-mode drivers. Header files are in the Include folder in your WDK installation folder. Example: C:\Program Files (x86)\Windows Kits\10\Include.</p>
- <p>The header files contain version information so that you can use the same set of header files regardless of which version of Windows your driver will run on.</p>
- <h2><a id="Constants_that_represent_Windows_versions"></a><a id="constants_that_represent_windows_versions"></a><a id="CONSTANTS_THAT_REPRESENT_WINDOWS_VERSIONS"></a>Constants that represent Windows versions</h2>
- <p>Header files in the WDK contain conditional statements that specify programming elements that are available only in certain versions of the Windows operating system. The versioned elements include functions, enumerations, structures, and structure members.</p>
- <p>To specify the programming elements that are available in each operating system version, the header files contain preprocessor conditionals that compare the value of NTDDI_VERSION with a set of predefined constant values that are defined in Sdkddkver.h.</p>
- <p>Here are the predefined constant values that represent versions of the Microsoft Windows operating system. </p>
- <table responsive="true">
- <tbody><tr responsive="true"><th>Constant</th><th>Operating system version</th></tr>
- <tr><td data-th="Constant">
- <p>NTDDI_WIN10</p>
- </td><td data-th="Operating system version">
- <p>Windows 10</p>
- </td></tr>
- <tr><td data-th="Constant">
- <p>NTDDI_WINBLUE</p>
- </td><td data-th="Operating system version">
- <p>Windows 8.1</p>
- </td></tr>
- <tr><td data-th="Constant">
- <p>NTDDI_WIN8</p>
- </td><td data-th="Operating system version">
- <p>Windows 8</p>
- </td></tr>
- <tr><td data-th="Constant">
- <p>NTDDI_WIN7</p>
- </td><td data-th="Operating system version">
- <p>Windows 7</p>
- </td></tr>
- <tr><td data-th="Constant">
- <p>NTDDI_WS08SP4</p>
- </td><td data-th="Operating system version">
- <p>Windows Server 2008 with SP4</p>
- </td></tr>
- <tr><td data-th="Constant">
- <p>NTDDI_WS08SP3</p>
- </td><td data-th="Operating system version">
- <p>Windows Server 2008 with SP3</p>
- </td></tr>
- <tr><td data-th="Constant">
- <p>NTDDI_WS08SP2</p>
- </td><td data-th="Operating system version">
- <p>Windows Server 2008 with SP2</p>
- </td></tr>
- <tr><td data-th="Constant">
- <p>NTDDI_WS08</p>
- </td><td data-th="Operating system version">
- <p>Windows Server 2008</p>
- </td></tr>
- </tbody></table>
- <p> </p>
- <p>You can see many examples of version-specific DDI elements in the WDK header files. This conditional declaration appears in Wdm.h, which is a header file that might be included by a kernel-mode driver.</p>
- <div id="code-snippet-1" class="codeSnippetContainer" xmlns="http://www.w3.org/1999/xhtml">
- <div class="codeSnippetContainerTabs">
- <div class="codeSnippetContainerTab codeSnippetContainerTabActive" dir="ltr">
- <a></a>
- </div>
- </div>
- <div class="codeSnippetContainerCodeContainer">
- <div class="codeSnippetToolBar"></div>
- <div class="codeSnippetContainerCode" dir="ltr">
- <div style="color:Black;"><pre>
- #if (NTDDI_VERSION >= NTDDI_WIN7)
- _Must_inspect_result_
- NTKERNELAPI
- NTSTATUS
- KeSetTargetProcessorDpcEx (
- _Inout_ PKDPC Dpc,
- _In_ PPROCESSOR_NUMBER ProcNumber
- );
- #endif
- </pre></div>
- </div>
- </div>
- </div>
- <p>In the example you can see that the <a href="https://msdn.microsoft.com/en-us/library/ff553279(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">KeSetTargetProcessorDpcEx</strong></a> function is available only in Windows 7 and later versions of Windows. </p>
- <p>This conditional declaration appears in Winspool.h, which is a header file that might be included by a user-mode driver. </p>
- <div id="code-snippet-2" class="codeSnippetContainer" xmlns="http://www.w3.org/1999/xhtml">
- <div class="codeSnippetContainerTabs">
- <div class="codeSnippetContainerTab codeSnippetContainerTabActive" dir="ltr">
- <a>C++</a>
- </div>
- </div>
- <div class="codeSnippetContainerCodeContainer">
- <div class="codeSnippetToolBar"></div>
- <div class="codeSnippetContainerCode" dir="ltr">
- <div style="color:Black;"><pre>
- #<span style="color:Blue;">if</span> (NTDDI_VERSION >= NTDDI_WIN7)
- ...
- BOOL
- WINAPI
- GetPrintExecutionData(
- _Out_ PRINT_EXECUTION_DATA *pData
- );
- #endif <span style="color:Green;">// (NTDDI_VERSION >= NTDDI_WIN7)</span>
- </pre></div>
- </div>
- </div>
- </div>
- <p>In the example can see that the <a href="https://msdn.microsoft.com/en-us/library/ee264322(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">GetPrintExecutionData</strong></a> function is available only in Windows 7 and later versions of Windows. </p>
- <h2><a id="Header_files_for_the_Kernel_Mode_Driver_Framework"></a><a id="header_files_for_the_kernel_mode_driver_framework"></a><a id="HEADER_FILES_FOR_THE_KERNEL_MODE_DRIVER_FRAMEWORK"></a>Header files for the Kernel Mode Driver Framework</h2>
- <p>The WDK supports several versions of Windows, and it also supports several versions of the Kernel Mode Driver Framework (KMDF) and User Mode Driver Framework (UMDF). The versioning information in the WDK header files pertains to Windows versions, but not to KMDF or UMDF versions. Header files for different versions of KMDF and UMDF are placed in separate directories.</p>
- <p> </p>
- <p> </p>
- <p><a href="mailto:wsddocfb@microsoft.com?subject=Documentation%20feedback%20[wdkgetstart\wdkgetstart]:%20Header%20files%20in%20the%20Windows%20Driver%20Kit%20%20RELEASE:%20(3/4/2016)&body=%0A%0APRIVACY%20STATEMENT%0A%0AWe%20use%20your%20feedback%20to%20improve%20the%20documentation.%20We%20don%27t%20use%20your%20email%20address%20for%20any%20other%20purpose,%20and%20we%27ll%20remove%20your%20email%20address%20from%20our%20system%20after%20the%20issue%20that%20you%27re%20reporting%20is%20fixed.%20While%20we%27re%20working%20to%20fix%20this%20issue,%20we%20might%20send%20you%20an%20email%20message%20to%20ask%20for%20more%20info.%20Later,%20we%20might%20also%20send%20you%20an%20email%20message%20to%20let%20you%20know%20that%20we%27ve%20addressed%20your%20feedback.%0A%0AFor%20more%20info%20about%20Microsoft%27s%20privacy%20policy,%20see%20http://privacy.microsoft.com/en-us/default.aspx." title="Send comments about this topic to Microsoft">Send comments about this topic to Microsoft</a></p>
- </div>
- </div>
-
- </div>
- </div>
- <div class="clear"></div>
-
- <input name="__RequestVerificationToken" type="hidden" value="NDOAP4ydnCeXVTkbs8_etxTOIxbnyFkDAmJiTzol8bVT7QVAQITtrc6U9NwZfF9-XUeygryaBELEdW2PHTFozuN0YgQ1">
- <input id="ratingValueSubmitUrl" type="hidden" value="https://msdn.microsoft.com/en-us/library/feedback/rate/ff554695(d=printer,v=vs.85).aspx">
- <input id="ratingAdditionalSubmitUrl" type="hidden" value="https://msdn.microsoft.com/en-us/library/feedback/additional/ff554695(d=printer,v=vs.85).aspx">
- <input id="isTopicRated" type="hidden" value="false">
- <div id="lib-footer" ms.pgarea="body">
-
-
- <link type="text/css" rel="stylesheet">
-
- <div id="ux-footer" class="" style="" dir="ltr">
-
- <div id="footerSock" class="librarySock both">
- <div id="footerSockInner">
- <a name="feedback"></a>
- <div class="rating">
- <div id="ratingSection1">
- <div class="title">
- Was this page helpful?
- </div>
- <div class="description">
- Your feedback about this content is important.<br>Let us know what you think.
- </div>
- <div class="buttons">
- <button class="button" id="ratingYes" aria-label="Yes, this page was helpful">Yes</button>
- <button class="button" id="ratingNo" aria-label="No, this page was not helpful">No</button>
- </div>
- <input id="ratingValue" type="hidden" value="">
- </div>
- <div id="ratingSection2">
- <div class="title left">
- Additional feedback?
- </div>
- <textarea id="ratingText" rows="6" cols="" maxlength="1500"></textarea>
- <div class="right">
- <div class="counter">
- <span id="feedbackTextCounter">1500</span> characters remaining
- </div>
- <div class="buttons">
- <button class="button" id="ratingSubmit" aria-label="Submit my additional feedback">Submit</button>
- <button class="button" id="ratingSkipThis" aria-label="Skip additional feedback">Skip this</button>
- </div>
- </div>
- </div>
- <div id="ratingSection3">
- <div class="title">
- Thank you!
- </div>
- <div class="description">
- We appreciate your feedback.
- </div>
- </div>
-
-
- <div id="contentFeedbackQAContainer" style="display: none;"></div>
- </div>
-
- <div class="userVoice">
- <div class="title">
- Help us improve MSDN.
- </div>
- <div class="description">
- Visit our UserVoice Page to submit and vote on ideas!
- </div>
- <div class="buttons">
- <a class="button" id="userVoiceButton" href="http://feedback.msdn.com/forums/257782-msdn-feature-suggestions/category/83975" target="_blank">Make a suggestion</a>
- </div>
- </div>
- <div class="clear"></div>
- </div>
- </div>
- <footer class="top">
- <div data-fragmentname="LeftLinks" id="Fragment_LeftLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Dev centers</div>
- <ul class="links">
- <li>
- <a href="https://dev.windows.com/" id="LeftLinks_2148_1" class="windowsBlue" xmlns="http://www.w3.org/1999/xhtml">Windows</a>
- </li>
- <li>
- <a href="http://dev.office.com/" id="LeftLinks_2148_3" class="office" xmlns="http://www.w3.org/1999/xhtml">Office</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/vstudio" id="LeftLinks_2148_4" class="visualStudio" xmlns="http://www.w3.org/1999/xhtml">Visual Studio</a>
- </li>
- <li>
- <a href="http://azure.microsoft.com/en-us/documentation/" target="_blank" id="LeftLinks_2148_12" xmlns="http://www.w3.org/1999/xhtml">Microsoft Azure</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/developer-centers-msdn" id="LeftLinks_2148_5" xmlns="http://www.w3.org/1999/xhtml">More...</a>
- </li>
- </ul>
- </div>
- </div>
- <div id="rightLinks">
- <div data-fragmentname="CenterLinks1" id="Fragment_CenterLinks1" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Learning resources</div>
- <ul class="links">
- <li>
- <a href="http://www.microsoftvirtualacademy.com/" id="CenterLinks1_2151_4" xmlns="http://www.w3.org/1999/xhtml">Microsoft Virtual Academy</a>
- </li>
- <li>
- <a href="http://channel9.msdn.com/" id="CenterLinks1_2151_5" xmlns="http://www.w3.org/1999/xhtml">Channel 9</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/magazine/" id="CenterLinks1_2151_7" xmlns="http://www.w3.org/1999/xhtml">MSDN Magazine</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks2" id="Fragment_CenterLinks2" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Community</div>
- <ul class="links">
- <li>
- <a href="https://social.msdn.microsoft.com/forums/en-us/home" id="CenterLinks2_2151_8" xmlns="http://www.w3.org/1999/xhtml">Forums</a>
- </li>
- <li>
- <a href="http://blogs.msdn.com/b/developer-tools/" id="CenterLinks2_2151_9" xmlns="http://www.w3.org/1999/xhtml">Blogs</a>
- </li>
- <li>
- <a href="http://www.codeplex.com/" id="CenterLinks2_2151_10" xmlns="http://www.w3.org/1999/xhtml">Codeplex</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks3" id="Fragment_CenterLinks3" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Support</div>
- <ul class="links">
- <li>
- <a href="https://msdn.microsoft.com/hh361695" id="CenterLinks3_2151_11" xmlns="http://www.w3.org/1999/xhtml">Self support</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks4" id="Fragment_CenterLinks4" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Programs</div>
- <ul class="links">
- <li>
- <a href="https://www.microsoft.com/bizspark/" id="CenterLinks4_2151_13" xmlns="http://www.w3.org/1999/xhtml">BizSpark (for startups)</a>
- </li>
- <li>
- <a href="https://www.dreamspark.com/" id="CenterLinks4_2151_14" xmlns="http://www.w3.org/1999/xhtml">DreamSpark</a>
- </li>
- <li>
- <a href="http://www.imaginecup.com/" id="CenterLinks4_2151_17" xmlns="http://www.w3.org/1999/xhtml">Imagine Cup</a>
- </li>
- </ul>
- </div>
- </div>
- </div>
- </footer>
- <footer class="bottom">
- <span class="localeContainer">
-
- <form class="selectLocale" id="selectLocaleForm" action="https://msdn.microsoft.com/en-us/selectlocale-dmc">
- <input type="hidden" name="fromPage" value="https%3a%2f%2fmsdn.microsoft.com%2fen-us%2flibrary%2fff554695(d%3dprinter%2cv%3dvs.85).aspx%3flan%3dCSharp%26cc%3dn%26trm%3dtra%26view%3dbook">
- <a href="http://msdn.microsoft.com/#" onclick="$('#selectLocaleForm').submit();return false;" title="Change your language">United States (English)</a>
- </form>
- </span>
- <div data-fragmentname="BottomLinks" id="Fragment_BottomLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <ul class="links horizontal">
- <li>
- <a href="https://msdn.microsoft.com/newsletter.aspx" id="BottomLinks_2148_7" xmlns="http://www.w3.org/1999/xhtml">Newsletter</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/dn529288" id="BottomLinks_2148_8" xmlns="http://www.w3.org/1999/xhtml">Privacy & cookies</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/cc300389" id="BottomLinks_2148_9" xmlns="http://www.w3.org/1999/xhtml">Terms of use</a>
- </li>
- <li>
- <a href="https://www.microsoft.com/en-us/legal/intellectualproperty/Trademarks/EN-US.aspx" id="BottomLinks_2148_10" xmlns="http://www.w3.org/1999/xhtml">Trademarks</a>
- </li>
- </ul>
- </div>
- </div>
- <span class="logoLegal">
- <span class="logo"></span>
- <span class="copyright">© 2016 Microsoft</span>
- </span>
- </footer>
- </div>
-
- </div>
- <div class="footerPrintView">
- <div class="footerCopyrightPrintView">© 2016 Microsoft</div>
- </div>
-
-
-
-
- <input id="tocPaddingPerLevel" type="hidden" value="17">
- <input id="MtpsDevice" type="hidden" value="Printer">
- <!--[CDATA[ Third party scripts and code linked to or referenced from this website are licensed to you by the parties that own such code, not by Microsoft. See ASP.NET Ajax CDN Terms of Use – http://www.asp.net/ajaxlibrary/CDN.ashx. ]]-->
-
-
-
-
-
- <noscript><div><img alt="DCSIMG" id="Img1" width="1" height="1" src="https://m.webtrends.com/dcsmgru7m99k7mqmgrhudo0k8_8c6m/njs.gif?dcsuri=/nojavascript&amp;WT.js=No" /></div></noscript>
- <div id="globalRequestVerification">
- <input name="__RequestVerificationToken" type="hidden" value="L_DNcd7E8DOypCKm58U4eCbmsUqplJBnse1z2Q6_0_BM27ciZ0MIuUahfkZYKIsQ6PhxF836fkNGWxY3JrS-RkFTQcc1">
- </div>
- </div>
-
-
-
-
-
-
- <script type="text/javascript" class="mtps-injected">
- /*<![CDATA[*/
- (function(window,document){"use strict";function preload(scripts){for(var result=[],script,e,i=0;i<scripts.length;i++)script=scripts[i],script.hasOwnProperty("url")&&(e=document.createElement("script"),e.src=script.url,script.throwaway=e),result.push(script);return result}function inject(scripts,index){var script,elem;if(index>=scripts.length){delete mtps.injectScripts;return}script=scripts[index];elem=document.createElement("script");elem.className="mtps-injected";elem.async=!1;var isLoaded=!1,timeoutId=0,injectNextFnName="",injectNext=elem.onerror=function(){isLoaded||(isLoaded=!0,inject(scripts,index+1),window.clearTimeout(timeoutId),elem.onload=elem.onerror=elem.onreadystatechange=null,injectNextFnName&&delete mtps[injectNextFnName],elem.removeEventListener&&elem.removeEventListener("load",injectNext,!1))};elem.addEventListener?elem.addEventListener("load",injectNext,!1):elem.readyState==="uninitialized"?elem.onreadystatechange=function(){(this.readyState==="loaded"||this.readyState==="complete")&&injectNext()}:elem.onload=injectNext;script.hasOwnProperty("url")?(timeoutId=window.setTimeout(injectNext,12e4),elem.src=script.url):(injectNextFnName="_injectNextScript_"+index,mtps[injectNextFnName]=injectNext,timeoutId=window.setTimeout(injectNext,2e3),elem.text="try {\n"+script.txt+"\n} finally { MTPS."+injectNextFnName+" && MTPS."+injectNextFnName+"(); }");parent.appendChild(elem)}var mtps=window.MTPS||(window.MTPS={}),parent=document.getElementsByTagName("head")[0];mtps.injectScripts=function(scripts){inject(preload(scripts),0)}})(window,document);
- MTPS.injectScripts([
- { txt: "/**/\r\n(window.MTPS || (window.MTPS = {})).cdnDomains || (window.MTPS.cdnDomains = { \r\n\t\"image\": \"https://i-msdn.sec.s-msft.com\", \r\n\t\"js\": \"https://i2-msdn.sec.s-msft.com\", \r\n\t\"css\": \"https://i-msdn.sec.s-msft.com\", \r\n\t\"ttf\": \"https://i-msdn.sec.s-msft.com\"\r\n});\r\n/**/" },
- { txt: "//\n var literalNormalizedUrl = \u0027/en-us/library/ff554695(d=printer,l=en-us,v=vs.85).aspx\u0027;\n var wt_nvr_ru = \u0027WT_NVR_RU\u0027;\n var wt_fpcdom = \u0027.microsoft.com\u0027;\n var wt_domlist = \u0027msdn.microsoft.com\u0027;\n var wt_pathlist = \u0027\u0027;\n var wt_paramlist = \u0027DCSext.mtps_devcenter\u0027;\n var wt_siteid = \u0027MSDN\u0027;\n var gDomain = \u0027m.webtrends.com\u0027;\n var gDcsId = \u0027dcsmgru7m99k7mqmgrhudo0k8_8c6m\u0027;\n var gFpc = \u0027WT_FPC\u0027;\n\n\n\n if (document.cookie.indexOf(gFpc + \"=\") == -1) {\n var wtidJs = document.createElement(\"script\");\n wtidJs.src = \"//\" + gDomain + \"/\" + gDcsId + \"/wtid.js\";\n document.getElementsByTagName(\"head\")[0].appendChild(wtidJs);\n }\n\n\n\n var detectedLocale = \u0027en-us\u0027;\n var wtsp = \u0027msdnlib_w32_com\u0027;\n var gTrackEvents = \u00270\u0027;\n/**/" },
- { txt: "//\n\n window.appInsightsId = \u00275eb1b2eb-c47a-497a-a7ac-a1c230b2882f\u0027;\n //" },
- { url: "https://i2-msdn.sec.s-msft.com/Combined.js?resources=0:Utilities,1:Layout,2:Header,1:Rating,2:Footer,0:Topic,3:PabTopic,4:webtrendsscript,0:AppInsightsPerf,0:ABTestControl,5:WEDCS,3:CmpgrpForHeader,0:livefyre,0:Comment,1:SearchBox;/Areas/Epx/Content/Scripts:0,/Areas/Epx/Themes/Base/Content:1,/Areas/Centers/Themes/StandardDevCenter/Content:2,/Areas/Library/Content:3,/Areas/Global/Content/Webtrends/resources:4,/Areas/Library/Themes/Base/Content:5\u0026amp;hashKey=30CEE944AABFEA2C5A338BDB9E000732\u0026amp;v=AE608271C0243AAA0449D3BC0FAD8EB4" },
- { url: "https://i1.services.social.microsoft.com/search/Widgets/SearchBox.jss?boxid=HeaderSearchTextBox\u0026btnid=HeaderSearchButton\u0026pgArea=header\u0026brand=Msdn\u0026loc=en-us\u0026focusOnInit=false\u0026emptyWatermark=true\u0026searchButtonTooltip=Search MSDN" },
- { url: "https://i2-msdn.sec.s-msft.com/Combined.js?resources=0:PrintExportButton,1:Toc_Fixed,1:CodeSnippet,1:TopicNotInScope,1:CollapsibleArea,1:VersionSelector,1:SurveyBroker;/Areas/Library/Themes/Base/Content:0,/Areas/Epx/Content/Scripts:1\u0026amp;hashKey=80F30894E3FB8A3295C923AEC7019CFE\u0026amp;v=AE608271C0243AAA0449D3BC0FAD8EB4" },
- { txt: "$(document).ready(function() {\n try {\n var token = $(\"#globalRequestVerification input[name=\u0027__RequestVerificationToken\u0027]\").clone();\n $(\"#siteFeedbackForm\").append(token);\n } catch(err) {\n \n }\n });" }
- ]);
- /*]]>*/
- </script>
- <link rel="stylesheet" type="text/css" href="./Windows Kernel Development Articles (2016-03-30)_files/Combined.css">
- <div id="page">
-
-
-
-
- <link type="text/css" rel="stylesheet">
-
- <input type="hidden" id="isHeaderBleeding" value="true">
- <div id="ux-header" dir="ltr" class="ltr msdn">
-
- <header>
- <span id="singleCol"></span>
- <span id="doubleCol"></span>
- <span id="isMobile"></span>
- <div>
- <div class="row topRow">
- <div class="top">
- <div class="left">
- <a class="msdnLogoImg" href="https://msdn.microsoft.com/en-us" title="MSDN home">
- <div id="msft-logo" class="msft-logo"></div>
- </a>
- <div class="GrayPipe"></div>
- <a class="DevCenterFullNameNonMegaBlade" href="https://msdn.microsoft.com/en-us">Developer Network</a>
- <a class="DevCenterFullName" href="https://msdn.microsoft.com/en-us">Developer Network</a>
- <a class="DevCenterShortName" href="https://msdn.microsoft.com/en-us">Developer</a>
- </div>
- <div class="right">
- <div id="signIn">
- <div class="profileImage"></div>
- <a class="scarabLink" href="https://login.live.com/login.srf?wa=wsignin1.0&rpsnv=12&ct=1459376415&rver=6.0.5276.0&wp=mcmbi&wlcxt=msdn%24msdn%24msdn&wreply=https%3a%2f%2fmsdn.microsoft.com%2fen-us%2flibrary%2fff554887%2528d%3dprinter%2cv%3dvs.85%2529.aspx%3flan%3dcsharp%26cc%3dn%26trm%3dtra%26view%3dbook&lc=1033&id=254354&mkt=en-us" title="Sign in">Sign in</a></div>
- <div class="auxNav">
- <div>
- <div data-fragmentname="Subscriptions" id="Fragment_Subscriptions" xmlns="http://www.w3.org/1999/xhtml">
- <a href="https://msdn.microsoft.com/subscriptions/manage/hh442900" id="Subscriptions_2153_1" xmlns="http://www.w3.org/1999/xhtml">MSDN subscriptions</a>
- </div>
- <div data-fragmentname="GetTools" id="Fragment_GetTools" xmlns="http://www.w3.org/1999/xhtml">
- <a href="http://go.microsoft.com/fwlink/?LinkId=309297&clcid=0x409&slcid=0x409&campaign=o~msft~msdn~gettools-header~dn308572" id="GetTools_2153_3" xmlns="http://www.w3.org/1999/xhtml">Get tools</a>
- </div>
- </div>
- <div>
- <div data-fragmentname="SocialLinks" id="Fragment_SocialLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <ul class="links horizontal">
- <li>
- <a href="http://www.facebook.com/microsoftdeveloper" target="_blank" id="SocialLinks_2152_4" class="facebook" xmlns="http://www.w3.org/1999/xhtml">http://www.facebook.com/microsoftdeveloper</a>
- </li>
- <li>
- <a href="https://twitter.com/msdev" target="_blank" id="SocialLinks_2152_5" class="twitter" xmlns="http://www.w3.org/1999/xhtml">https://twitter.com/msdev</a>
- </li>
- <li>
- <a href="http://plus.google.com/111221966647232053570/" target="_blank" id="SocialLinks_2152_6" class="googlePlus" xmlns="http://www.w3.org/1999/xhtml">http://plus.google.com/111221966647232053570/</a>
- </li>
- </ul>
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- <div class="row middleRow">
- <div class="expandTop">
- <div class="left"></div>
- <div class="right"></div>
- </div>
- </div>
- </div>
- <div id="buttomRowWrapper" class="bg_default">
- <div class="row buttomRow bg_default">
- <div class="bottom">
- <div class="left">
- <a id="grip" class="menu-icon" href="javascript:void(0)"></a>
-
- <div id="drawer">
- <div class="toc">
-
- <nav>
- <ul class="navL1">
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Technologies">Technologies</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/cloud-app-development-msdn" title="Cloud">Cloud</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/app-development-msdn" title="App Development">App Development</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/web-app-development-msdn" title="Web">Web</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/big-data-development-msdn" title="Data">Data</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/games-development-msdn" title="Gaming">Gaming</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/internetofthings" title="Internet of Things">Internet of Things</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Downloads">Downloads</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://www.visualstudio.com/downloads/download-visual-studio-vs" title="Visual Studio">Visual Studio</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/subscriptions" title="MSDN subscription access">MSDN subscription access</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/microsoft-sdks-msdn" title="SDKs">SDKs</a>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Trial software">Trial software</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/evalcenter" title="Free downloads">Free downloads</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/officeevaluationresources" title="Office resources">Office resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/sharepoint2013resources" title="SharePoint Server 2013 resources">SharePoint Server 2013 resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/sqlserver2014expressresources" title="SQL Server 2014 Express resources">SQL Server 2014 Express resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/windowsserver2012r2resources" title="Windows Server 2012 resources">Windows Server 2012 resources</a>
- </li>
- </ul>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Programs">Programs</a>
- <ul class="navL2">
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Visual Studio subscriptions">Visual Studio subscriptions</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/msdn-subscriptions-overview" title="Overview">Overview</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/benefits-overview" title="Benefits">Benefits</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/msdn-subscriptions-administration" title="Administrators">Administrators</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Students">Students</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/imagine/imagine-home" title="Microsoft Imagine">Microsoft Imagine</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/microsoftstudentpartners" title="Microsoft Student Partners">Microsoft Student Partners</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Architects">Architects</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-overview-msdn" title="Overview">Overview</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-case-studies-msdn" title="Case studies">Case studies</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-blueprints-msdn" title="Blueprints">Blueprints</a>
- </li>
- <li class="inactive">
- <a href="http://blogs.msdn.com/b/msarchitecture/" title="Blog">Blog</a>
- </li>
- <li class="inactive">
- <a href="http://social.msdn.microsoft.com/forums/en-us/home?brandignore=true&sort=relevancedesc&searchterm=architecture+or+architect" title="Forums">Forums</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/applicationbuilder" title="ISV">ISV</a>
-
- </li>
- <li class="inactive">
- <a href="https://www.microsoft.com/bizspark" title="Startups">Startups</a>
-
- </li>
- <li class="inactive">
- <a href="https://rewards.msdn.microsoft.com/" title="TechRewards">TechRewards</a>
-
- </li>
- <li class="inactive">
- <a href="http://events.msdn.microsoft.com/" title="Events">Events</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Community">Community</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/magazine/dd767791" title="Magazine">Magazine</a>
-
- </li>
- <li class="inactive">
- <a href="https://social.msdn.microsoft.com/forums/" title="Forums">Forums</a>
-
- </li>
- <li class="inactive">
- <a href="http://blogs.msdn.com/b/developer-tools/" title="Blogs">Blogs</a>
-
- </li>
- <li class="inactive">
- <a href="http://tech-advisors.msdn.microsoft.com/en-us" title="Tech Advisors">Tech Advisors</a>
-
- </li>
- <li class="inactive">
- <a href="http://channel9.msdn.com/" title="Channel 9">Channel 9</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive current toggle">
- <a href="javascript:void(0)" title="Documentation">Documentation</a>
- <ul class="navL2">
- <li class="inactive current">
- <a href="https://msdn.microsoft.com/library" title="APIs and reference">APIs and reference</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/developer-centers-msdn" title="Dev centers">Dev centers</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive">
- <a href="https://code.msdn.microsoft.com/" title="Samples">Samples</a>
- </li>
- </ul>
- </nav>
- </div>
- </div>
- </div>
- <div class="right">
- <div data-fragmentname="SearchBox" id="Fragment_SearchBox" xmlns="http://www.w3.org/1999/xhtml">
- <div class="SearchBox">
- <form id="HeaderSearchForm" name="HeaderSearchForm" method="get">
- <button id="FakeHeaderSearchButton" value="Search" type="submit" class="header-search-button">
- <div id="search-finder" class="search-finder"></div>
- </button>
- <button id="HeaderSearchButton" style="display:none"></button>
- <div id="searchSplitter"></div>
- <div id="searchCloseIcon" class="search-clear-x"></div>
- <div id="searchTextContainer" style="width: 0;">
- <input id="HeaderSearchTextBox" name="query" type="text" maxlength="200" onfocus="Epx.Controls.SearchBox.watermarkFocus(event, this.title)" onblur="Epx.Controls.SearchBox.watermarkBlur(event, this.title)">
- </div>
- </form>
-
-
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- </header>
- </div>
-
-
-
- <div class="printExportMenus ltr">
- <a id="isd_printABook" href="http://msdn.microsoft.com/en-us/library/export/help/(d=printer)?returnurl=%2fen-us%2flibrary%2fff554887(d%3dprinter,v%3dvs.85).aspx%3flan%3dcsharp%26cc%3dn%26trm%3dtra%26view%3dbook">
- Export (<span class="count">0</span>)
- </a>
- <a id="isd_print" href="https://msdn.microsoft.com/en-us/library/ff554887(d=printer,v=vs.85).aspx?lan=csharp&cc=n&trm=tra&view=book" rel="nofollow">
- Print
- </a>
- <a id="isd_archiveControl" style="display:none;" data-include-archive="Include Previous Version" data-exclude-archive="Exclude Previous Version">
- </a>
- </div>
-
- <div class="printExportMenus ltr">
- <a id="expandCollapseAll" accesskey="e" href="javascript:void(0)" title="Expand/Collapse all sections by pressing Ctrl + Shift + e">Expand All</a>
- </div>
-
- <div id="body" ms.pgarea="body">
- <span id="tabletView_large"></span>
- <span id="tabletView_small"></span>
- <span id="mobileView"></span>
-
- <div id="content" class="content">
- <input type="hidden" id="printForPab" value="true">
-
- <div class="topic" xmlns="http://www.w3.org/1999/xhtml">
- <h1 class="title">Writing drivers for different versions of Windows</h1>
-
- <div id="mainSection">
- <div class="clsServerSDKContent">
- </div>
- <p>When you create a driver project, you specify the minimum target operating system, which is the minimum version of Windows that your driver will run on. For example, you could specify that Windows 7 is the minimum target operating system. In that case, your driver would run on Windows 7 and later versions of Windows.</p>
- <div class="alert"><strong>Note</strong> If you develop a driver for a particular minimum version of Windows and you want your driver to work on later versions of Windows, you must not use any undocumented functions, and you must not use documented functions in any way other than how it is described in the documentation. Otherwise your driver might fail to run on the later versions of Windows. Even if you have been careful to use only documented functions, you should test your driver on the new version of Windows each time one is released.</div>
- <div> </div>
- <h2><a id="Writing_a_multiversion_driver_using_only_common_features"></a><a id="writing_a_multiversion_driver_using_only_common_features"></a><a id="WRITING_A_MULTIVERSION_DRIVER_USING_ONLY_COMMON_FEATURES"></a>Writing a multiversion driver using only common features</h2>
- <p>When you design a driver that will run on multiple versions of Windows, the simplest approach is to allow the driver to use only DDI functions and structures that are common to all versions of Windows that the driver will run on. In this situation, you set the minimum target operating system to the earliest version of Windows that the driver will support.</p>
- <p>For example, to support all versions of Windows, starting with Windows 7, you should:</p>
- <ol>
- <li>
- <p>Design and implement the driver so that it uses only those features that are present in Windows 7. </p>
- </li>
- <li>
- <p>When you build your driver, specify Windows 7 as the minimum target operating system.</p>
- </li>
- </ol>
- <p>While this process is simple, it might restrict the driver to use only a subset of the functionality that is available on later versions of Windows. </p>
- <h2><a id="Writing_a_multiversion_driver_that_uses_version-dependent_features"></a><a id="writing_a_multiversion_driver_that_uses_version-dependent_features"></a><a id="WRITING_A_MULTIVERSION_DRIVER_THAT_USES_VERSION-DEPENDENT_FEATURES"></a>Writing a multiversion driver that uses version-dependent features</h2>
- <p>A kernel-mode driver can dynamically determine which version of Windows it is running on and choose to use features that are available in that version. For example, a driver that must support all versions of Windows, starting with Windows 7, can determine, at run time, the version of Windows that it is running on. If the driver is running on Windows 7, it must use only the DDI functions that Windows 7 supports. However, the same driver can use additional DDI functions that are unique to Windows 8, for example, when its run-time check determines that it is running on Windows 8.</p>
- <h3><a id="determining_the_windows_version"></a><a id="DETERMINING_THE_WINDOWS_VERSION"></a>Determining the Windows version</h3>
- <p>
- <a href="https://msdn.microsoft.com/en-us/library/ff561954(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">RtlIsNtDdiVersionAvailable</strong></a> is a function that drivers can use to determine, at run time, if the features that are provided by a particular version of Windows are available. The prototype for this function is as follows:</p>
- <div id="code-snippet-1" class="codeSnippetContainer" xmlns="http://www.w3.org/1999/xhtml">
- <div class="codeSnippetContainerTabs">
- <div class="codeSnippetContainerTab codeSnippetContainerTabActive" dir="ltr">
- <a></a>
- </div>
- </div>
- <div class="codeSnippetContainerCodeContainer">
- <div class="codeSnippetToolBar"></div>
- <div class="codeSnippetContainerCode" dir="ltr">
- <div style="color:Black;"><pre>
- BOOLEAN RtlIsNtDdiVersionAvailable(IN ULONG Version)
- </pre></div>
- </div>
- </div>
- </div>
- <p>In this prototype, <em>Version</em> is a value that indicates the required version of the Windows DDI. This value must be one of the DDI version constants, defined in sdkddkver.h, such as NTDDI_WIN8 or NTDDI_WIN7.</p>
- <p>
- <a href="https://msdn.microsoft.com/en-us/library/ff561954(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">RtlIsNtDdiVersionAvailable</strong></a> returns TRUE when the caller is running on a version of Windows that is the same as, or later than, the one that is specified by <em>Version.</em></p>
- <p>Your driver can also check for a specific service pack by calling the <a href="https://msdn.microsoft.com/en-us/library/ff561956(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">RtlIsServicePackVersionInstalled</strong></a> function. The prototype for this function is as follows:</p>
- <div id="code-snippet-2" class="codeSnippetContainer" xmlns="http://www.w3.org/1999/xhtml">
- <div class="codeSnippetContainerTabs">
- <div class="codeSnippetContainerTab codeSnippetContainerTabActive" dir="ltr">
- <a></a>
- </div>
- </div>
- <div class="codeSnippetContainerCodeContainer">
- <div class="codeSnippetToolBar"></div>
- <div class="codeSnippetContainerCode" dir="ltr">
- <div style="color:Black;"><pre>
- BOOLEAN RtlIsServicePackVersionInstalled(IN ULONG Version)
- </pre></div>
- </div>
- </div>
- </div>
- <p>In this prototype, <em>Version</em> is a value that indicates the required Windows version and service pack. This value must be one of the DDI version constants, defined in sdkddkver.h, such as NTDDI_WS08SP3.</p>
- <p>Note that <a href="https://msdn.microsoft.com/en-us/library/ff561956(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">RtlIsServicePackVersionInstalled</strong></a> returns TRUE only when the operating system version exactly matches the specified version. Thus, a call to <strong>RtlIsServicePackVersionInstalled</strong> with <em>Version</em> set to NTDDI_WS08SP3 will fail if the driver is not running on Windows Server 2008 with SP4.</p>
- <h3><a id="conditionally_calling_windows_version_dependent_functions"></a><a id="CONDITIONALLY_CALLING_WINDOWS_VERSION_DEPENDENT_FUNCTIONS"></a>Conditionally calling Windows version-dependent functions</h3>
- <p>After a driver determines that a specific operating system version is available on the computer, the driver can use the <a href="https://msdn.microsoft.com/en-us/library/ff554563(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">MmGetSystemRoutineAddress</strong></a> function to dynamically locate the routine and call it through a pointer. This function is available in Windows 7 and later operating system versions.</p>
- <div class="alert"><strong>Note</strong> To help preserve type checking and prevent unintentional errors, you should create a typedef that mirrors the original function type. </div>
- <div> </div>
- <h3><a id="example__determining_the_windows_version_and_conditionally_calling_a_v"></a><a id="EXAMPLE__DETERMINING_THE_WINDOWS_VERSION_AND_CONDITIONALLY_CALLING_A_V"></a>Example: Determining the Windows version and conditionally calling a version-dependent function</h3>
- <p>This code example, which is from a driver's header file, defines the PAISQSL type as a pointer to the <a href="https://msdn.microsoft.com/en-us/library/ff551899(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">KeAcquireInStackQueuedSpinLock</strong></a> function. The example then declares a <code>AcquireInStackQueuedSpinLock</code> variable with this type.</p>
- <div id="code-snippet-3" class="codeSnippetContainer" xmlns="http://www.w3.org/1999/xhtml">
- <div class="codeSnippetContainerTabs">
- <div class="codeSnippetContainerTab codeSnippetContainerTabActive" dir="ltr">
- <a></a>
- </div>
- </div>
- <div class="codeSnippetContainerCodeContainer">
- <div class="codeSnippetToolBar"></div>
- <div class="codeSnippetContainerCode" dir="ltr">
- <div style="color:Black;"><pre>
- ...
- //
- // Pointer to the ordered spin lock function.
- // This function is only available on Windows 7 and
- // later systems
- typedef (* PAISQSL) (KeAcquireInStackQueuedSpinLock);
- PAISQSL AcquireInStackQueued = NULL;
- ...
-
- </pre></div>
- </div>
- </div>
- </div>
- <p>This code example, which is from the driver's initialization code, determines whether the driver is running on Windows 7 or a later operating system. If it is, the code retrieves a pointer to <a href="https://msdn.microsoft.com/en-us/library/ff551899(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">KeAcquireInStackQueuedSpinLock</strong></a>. </p>
- <div id="code-snippet-4" class="codeSnippetContainer" xmlns="http://www.w3.org/1999/xhtml">
- <div class="codeSnippetContainerTabs">
- <div class="codeSnippetContainerTab codeSnippetContainerTabActive" dir="ltr">
- <a></a>
- </div>
- </div>
- <div class="codeSnippetContainerCodeContainer">
- <div class="codeSnippetToolBar"></div>
- <div class="codeSnippetContainerCode" dir="ltr">
- <div style="color:Black;"><pre>
- ...
-
- //
- // Are we running on Windows 7 or later?
- //
- if (RtlIsNtDdiVersionAvailable(NTDDI_WIN7) ) {
-
- //
- // Yes... Windows 7 or later it is!
- //
- RtlInitUnicodeString(&funcName,
- L"KeAcquireInStackQueuedSpinLock");
-
- //
- // Get a pointer to Windows implementation
- // of KeAcquireInStackQueuedSpinLock into our
- // variable "AcquireInStackQueued"
- AcquireInStackQueued = (PAISQSL)
- MmGetSystemRoutineAddress(&funcName);
- }
-
- ...
- // Acquire a spin lock.
-
- if( NULL != AcquireInStackQueued) {
- (AcquireInStackQueued)(&SpinLock, &lockHandle);
- } else {
- KeAcquireSpinLock(&SpinLock);
- }
-
- </pre></div>
- </div>
- </div>
- </div>
- <p>In the example the driver calls <a href="https://msdn.microsoft.com/en-us/library/ff561954(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">RtlIsNtDdiVersionAvailable</strong></a> to determine whether the driver is running on Windows 7 or later. If the version is Windows 7 or later, the driver calls <a href="https://msdn.microsoft.com/en-us/library/ff554563(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">MmGetSystemRoutineAddress</strong></a> to get a pointer to the <a href="https://msdn.microsoft.com/en-us/library/ff551899(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">KeAcquireInStackQueuedSpinLock</strong></a> function and stores this pointer in the variable named <code>AcquireInStackQueued</code> (which was declared as a PAISQSL type).</p>
- <p>Later, when the driver must acquire a spin lock, it checks to see whether it has received a pointer to the <a href="https://msdn.microsoft.com/en-us/library/ff551899(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">KeAcquireInStackQueuedSpinLock</strong></a> function. If the driver has received this pointer, the driver uses the pointer to call <strong>KeAcquireInStackQueuedSpinLock</strong>. If the pointer to <strong>KeAcquireInStackQueuedSpinLock</strong> is null, the driver uses <a href="https://msdn.microsoft.com/en-us/library/ff551917(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">KeAcquireSpinLock</strong></a> to acquire the spin lock.</p>
- <p> </p>
- <p> </p>
- <p><a href="mailto:wsddocfb@microsoft.com?subject=Documentation%20feedback%20[wdkgetstart\wdkgetstart]:%20Writing%20drivers%20for%20different%20versions%20of%20Windows%20%20RELEASE:%20(3/4/2016)&body=%0A%0APRIVACY%20STATEMENT%0A%0AWe%20use%20your%20feedback%20to%20improve%20the%20documentation.%20We%20don%27t%20use%20your%20email%20address%20for%20any%20other%20purpose,%20and%20we%27ll%20remove%20your%20email%20address%20from%20our%20system%20after%20the%20issue%20that%20you%27re%20reporting%20is%20fixed.%20While%20we%27re%20working%20to%20fix%20this%20issue,%20we%20might%20send%20you%20an%20email%20message%20to%20ask%20for%20more%20info.%20Later,%20we%20might%20also%20send%20you%20an%20email%20message%20to%20let%20you%20know%20that%20we%27ve%20addressed%20your%20feedback.%0A%0AFor%20more%20info%20about%20Microsoft%27s%20privacy%20policy,%20see%20http://privacy.microsoft.com/en-us/default.aspx." title="Send comments about this topic to Microsoft">Send comments about this topic to Microsoft</a></p>
- </div>
- </div>
-
- </div>
- </div>
- <div class="clear"></div>
-
- <input name="__RequestVerificationToken" type="hidden" value="dZZNelX9yaiOV34zTyWsGLcf6Xdbozpvu9O1UxNmf22OxtGr2e-p3Do81mDONBD4U5FfYRKBN2RQnQO0xjm8EIO4hUk1">
- <input id="ratingValueSubmitUrl" type="hidden" value="https://msdn.microsoft.com/en-us/library/feedback/rate/ff554887(d=printer,v=vs.85).aspx">
- <input id="ratingAdditionalSubmitUrl" type="hidden" value="https://msdn.microsoft.com/en-us/library/feedback/additional/ff554887(d=printer,v=vs.85).aspx">
- <input id="isTopicRated" type="hidden" value="false">
- <div id="lib-footer" ms.pgarea="body">
-
-
- <link type="text/css" rel="stylesheet">
-
- <div id="ux-footer" class="" style="" dir="ltr">
-
- <div id="footerSock" class="librarySock both">
- <div id="footerSockInner">
- <a name="feedback"></a>
- <div class="rating">
- <div id="ratingSection1">
- <div class="title">
- Was this page helpful?
- </div>
- <div class="description">
- Your feedback about this content is important.<br>Let us know what you think.
- </div>
- <div class="buttons">
- <button class="button" id="ratingYes" aria-label="Yes, this page was helpful">Yes</button>
- <button class="button" id="ratingNo" aria-label="No, this page was not helpful">No</button>
- </div>
- <input id="ratingValue" type="hidden" value="">
- </div>
- <div id="ratingSection2">
- <div class="title left">
- Additional feedback?
- </div>
- <textarea id="ratingText" rows="6" cols="" maxlength="1500"></textarea>
- <div class="right">
- <div class="counter">
- <span id="feedbackTextCounter">1500</span> characters remaining
- </div>
- <div class="buttons">
- <button class="button" id="ratingSubmit" aria-label="Submit my additional feedback">Submit</button>
- <button class="button" id="ratingSkipThis" aria-label="Skip additional feedback">Skip this</button>
- </div>
- </div>
- </div>
- <div id="ratingSection3">
- <div class="title">
- Thank you!
- </div>
- <div class="description">
- We appreciate your feedback.
- </div>
- </div>
-
-
- <div id="contentFeedbackQAContainer" style="display: none;"></div>
- </div>
-
- <div class="userVoice">
- <div class="title">
- Help us improve MSDN.
- </div>
- <div class="description">
- Visit our UserVoice Page to submit and vote on ideas!
- </div>
- <div class="buttons">
- <a class="button" id="userVoiceButton" href="http://feedback.msdn.com/forums/257782-msdn-feature-suggestions/category/83975" target="_blank">Make a suggestion</a>
- </div>
- </div>
- <div class="clear"></div>
- </div>
- </div>
- <footer class="top">
- <div data-fragmentname="LeftLinks" id="Fragment_LeftLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Dev centers</div>
- <ul class="links">
- <li>
- <a href="https://dev.windows.com/" id="LeftLinks_2148_1" class="windowsBlue" xmlns="http://www.w3.org/1999/xhtml">Windows</a>
- </li>
- <li>
- <a href="http://dev.office.com/" id="LeftLinks_2148_3" class="office" xmlns="http://www.w3.org/1999/xhtml">Office</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/vstudio" id="LeftLinks_2148_4" class="visualStudio" xmlns="http://www.w3.org/1999/xhtml">Visual Studio</a>
- </li>
- <li>
- <a href="http://azure.microsoft.com/en-us/documentation/" target="_blank" id="LeftLinks_2148_12" xmlns="http://www.w3.org/1999/xhtml">Microsoft Azure</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/developer-centers-msdn" id="LeftLinks_2148_5" xmlns="http://www.w3.org/1999/xhtml">More...</a>
- </li>
- </ul>
- </div>
- </div>
- <div id="rightLinks">
- <div data-fragmentname="CenterLinks1" id="Fragment_CenterLinks1" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Learning resources</div>
- <ul class="links">
- <li>
- <a href="http://www.microsoftvirtualacademy.com/" id="CenterLinks1_2151_4" xmlns="http://www.w3.org/1999/xhtml">Microsoft Virtual Academy</a>
- </li>
- <li>
- <a href="http://channel9.msdn.com/" id="CenterLinks1_2151_5" xmlns="http://www.w3.org/1999/xhtml">Channel 9</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/magazine/" id="CenterLinks1_2151_7" xmlns="http://www.w3.org/1999/xhtml">MSDN Magazine</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks2" id="Fragment_CenterLinks2" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Community</div>
- <ul class="links">
- <li>
- <a href="https://social.msdn.microsoft.com/forums/en-us/home" id="CenterLinks2_2151_8" xmlns="http://www.w3.org/1999/xhtml">Forums</a>
- </li>
- <li>
- <a href="http://blogs.msdn.com/b/developer-tools/" id="CenterLinks2_2151_9" xmlns="http://www.w3.org/1999/xhtml">Blogs</a>
- </li>
- <li>
- <a href="http://www.codeplex.com/" id="CenterLinks2_2151_10" xmlns="http://www.w3.org/1999/xhtml">Codeplex</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks3" id="Fragment_CenterLinks3" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Support</div>
- <ul class="links">
- <li>
- <a href="https://msdn.microsoft.com/hh361695" id="CenterLinks3_2151_11" xmlns="http://www.w3.org/1999/xhtml">Self support</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks4" id="Fragment_CenterLinks4" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Programs</div>
- <ul class="links">
- <li>
- <a href="https://www.microsoft.com/bizspark/" id="CenterLinks4_2151_13" xmlns="http://www.w3.org/1999/xhtml">BizSpark (for startups)</a>
- </li>
- <li>
- <a href="https://www.dreamspark.com/" id="CenterLinks4_2151_14" xmlns="http://www.w3.org/1999/xhtml">DreamSpark</a>
- </li>
- <li>
- <a href="http://www.imaginecup.com/" id="CenterLinks4_2151_17" xmlns="http://www.w3.org/1999/xhtml">Imagine Cup</a>
- </li>
- </ul>
- </div>
- </div>
- </div>
- </footer>
- <footer class="bottom">
- <span class="localeContainer">
-
- <form class="selectLocale" id="selectLocaleForm" action="https://msdn.microsoft.com/en-us/selectlocale-dmc">
- <input type="hidden" name="fromPage" value="https%3a%2f%2fmsdn.microsoft.com%2fen-us%2flibrary%2fff554887(d%3dprinter%2cv%3dvs.85).aspx%3flan%3dCSharp%26cc%3dn%26trm%3dtra%26view%3dbook">
- <a href="http://msdn.microsoft.com/#" onclick="$('#selectLocaleForm').submit();return false;" title="Change your language">United States (English)</a>
- </form>
- </span>
- <div data-fragmentname="BottomLinks" id="Fragment_BottomLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <ul class="links horizontal">
- <li>
- <a href="https://msdn.microsoft.com/newsletter.aspx" id="BottomLinks_2148_7" xmlns="http://www.w3.org/1999/xhtml">Newsletter</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/dn529288" id="BottomLinks_2148_8" xmlns="http://www.w3.org/1999/xhtml">Privacy & cookies</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/cc300389" id="BottomLinks_2148_9" xmlns="http://www.w3.org/1999/xhtml">Terms of use</a>
- </li>
- <li>
- <a href="https://www.microsoft.com/en-us/legal/intellectualproperty/Trademarks/EN-US.aspx" id="BottomLinks_2148_10" xmlns="http://www.w3.org/1999/xhtml">Trademarks</a>
- </li>
- </ul>
- </div>
- </div>
- <span class="logoLegal">
- <span class="logo"></span>
- <span class="copyright">© 2016 Microsoft</span>
- </span>
- </footer>
- </div>
-
- </div>
- <div class="footerPrintView">
- <div class="footerCopyrightPrintView">© 2016 Microsoft</div>
- </div>
-
-
-
-
- <input id="tocPaddingPerLevel" type="hidden" value="17">
- <input id="MtpsDevice" type="hidden" value="Printer">
- <!--[CDATA[ Third party scripts and code linked to or referenced from this website are licensed to you by the parties that own such code, not by Microsoft. See ASP.NET Ajax CDN Terms of Use – http://www.asp.net/ajaxlibrary/CDN.ashx. ]]-->
-
-
-
-
-
- <noscript><div><img alt="DCSIMG" id="Img1" width="1" height="1" src="https://m.webtrends.com/dcsmgru7m99k7mqmgrhudo0k8_8c6m/njs.gif?dcsuri=/nojavascript&amp;WT.js=No" /></div></noscript>
- <div id="globalRequestVerification">
- <input name="__RequestVerificationToken" type="hidden" value="dGTGdAuZv1Dw-RKn4XPQ10DD0hz77r3UT5zU9c9Mrj8sCntf_YyDobkMFMYB-vKJjLDUDmSimu42KrDGbynV1wnaP3w1">
- </div>
- </div>
-
-
-
-
-
-
- <script type="text/javascript" class="mtps-injected">
- /*<![CDATA[*/
- (function(window,document){"use strict";function preload(scripts){for(var result=[],script,e,i=0;i<scripts.length;i++)script=scripts[i],script.hasOwnProperty("url")&&(e=document.createElement("script"),e.src=script.url,script.throwaway=e),result.push(script);return result}function inject(scripts,index){var script,elem;if(index>=scripts.length){delete mtps.injectScripts;return}script=scripts[index];elem=document.createElement("script");elem.className="mtps-injected";elem.async=!1;var isLoaded=!1,timeoutId=0,injectNextFnName="",injectNext=elem.onerror=function(){isLoaded||(isLoaded=!0,inject(scripts,index+1),window.clearTimeout(timeoutId),elem.onload=elem.onerror=elem.onreadystatechange=null,injectNextFnName&&delete mtps[injectNextFnName],elem.removeEventListener&&elem.removeEventListener("load",injectNext,!1))};elem.addEventListener?elem.addEventListener("load",injectNext,!1):elem.readyState==="uninitialized"?elem.onreadystatechange=function(){(this.readyState==="loaded"||this.readyState==="complete")&&injectNext()}:elem.onload=injectNext;script.hasOwnProperty("url")?(timeoutId=window.setTimeout(injectNext,12e4),elem.src=script.url):(injectNextFnName="_injectNextScript_"+index,mtps[injectNextFnName]=injectNext,timeoutId=window.setTimeout(injectNext,2e3),elem.text="try {\n"+script.txt+"\n} finally { MTPS."+injectNextFnName+" && MTPS."+injectNextFnName+"(); }");parent.appendChild(elem)}var mtps=window.MTPS||(window.MTPS={}),parent=document.getElementsByTagName("head")[0];mtps.injectScripts=function(scripts){inject(preload(scripts),0)}})(window,document);
- MTPS.injectScripts([
- { txt: "/**/\r\n(window.MTPS || (window.MTPS = {})).cdnDomains || (window.MTPS.cdnDomains = { \r\n\t\"image\": \"https://i-msdn.sec.s-msft.com\", \r\n\t\"js\": \"https://i2-msdn.sec.s-msft.com\", \r\n\t\"css\": \"https://i-msdn.sec.s-msft.com\", \r\n\t\"ttf\": \"https://i-msdn.sec.s-msft.com\"\r\n});\r\n/**/" },
- { txt: "//\n var literalNormalizedUrl = \u0027/en-us/library/ff554887(d=printer,l=en-us,v=vs.85).aspx\u0027;\n var wt_nvr_ru = \u0027WT_NVR_RU\u0027;\n var wt_fpcdom = \u0027.microsoft.com\u0027;\n var wt_domlist = \u0027msdn.microsoft.com\u0027;\n var wt_pathlist = \u0027\u0027;\n var wt_paramlist = \u0027DCSext.mtps_devcenter\u0027;\n var wt_siteid = \u0027MSDN\u0027;\n var gDomain = \u0027m.webtrends.com\u0027;\n var gDcsId = \u0027dcsmgru7m99k7mqmgrhudo0k8_8c6m\u0027;\n var gFpc = \u0027WT_FPC\u0027;\n\n\n\n if (document.cookie.indexOf(gFpc + \"=\") == -1) {\n var wtidJs = document.createElement(\"script\");\n wtidJs.src = \"//\" + gDomain + \"/\" + gDcsId + \"/wtid.js\";\n document.getElementsByTagName(\"head\")[0].appendChild(wtidJs);\n }\n\n\n\n var detectedLocale = \u0027en-us\u0027;\n var wtsp = \u0027msdnlib_w32_com\u0027;\n var gTrackEvents = \u00270\u0027;\n/**/" },
- { txt: "//\n\n window.appInsightsId = \u00275eb1b2eb-c47a-497a-a7ac-a1c230b2882f\u0027;\n //" },
- { url: "https://i2-msdn.sec.s-msft.com/Combined.js?resources=0:Utilities,1:Layout,2:Header,1:Rating,2:Footer,0:Topic,3:PabTopic,4:webtrendsscript,0:AppInsightsPerf,0:ABTestControl,5:WEDCS,3:CmpgrpForHeader,0:livefyre,0:Comment,1:SearchBox;/Areas/Epx/Content/Scripts:0,/Areas/Epx/Themes/Base/Content:1,/Areas/Centers/Themes/StandardDevCenter/Content:2,/Areas/Library/Content:3,/Areas/Global/Content/Webtrends/resources:4,/Areas/Library/Themes/Base/Content:5\u0026amp;hashKey=30CEE944AABFEA2C5A338BDB9E000732\u0026amp;v=AE608271C0243AAA0449D3BC0FAD8EB4" },
- { url: "https://i1.services.social.microsoft.com/search/Widgets/SearchBox.jss?boxid=HeaderSearchTextBox\u0026btnid=HeaderSearchButton\u0026pgArea=header\u0026brand=Msdn\u0026loc=en-us\u0026focusOnInit=false\u0026emptyWatermark=true\u0026searchButtonTooltip=Search MSDN" },
- { url: "https://i2-msdn.sec.s-msft.com/Combined.js?resources=0:PrintExportButton,1:Toc_Fixed,1:CodeSnippet,1:TopicNotInScope,1:CollapsibleArea,1:VersionSelector,1:SurveyBroker;/Areas/Library/Themes/Base/Content:0,/Areas/Epx/Content/Scripts:1\u0026amp;hashKey=80F30894E3FB8A3295C923AEC7019CFE\u0026amp;v=AE608271C0243AAA0449D3BC0FAD8EB4" },
- { txt: "$(document).ready(function() {\n try {\n var token = $(\"#globalRequestVerification input[name=\u0027__RequestVerificationToken\u0027]\").clone();\n $(\"#siteFeedbackForm\").append(token);\n } catch(err) {\n \n }\n });" }
- ]);
- /*]]>*/
- </script>
- <link rel="stylesheet" type="text/css" href="./Windows Kernel Development Articles (2016-03-30)_files/Combined.css">
- <div id="page">
-
-
-
-
- <link type="text/css" rel="stylesheet">
-
- <input type="hidden" id="isHeaderBleeding" value="true">
- <div id="ux-header" dir="ltr" class="ltr msdn">
-
- <header>
- <span id="singleCol"></span>
- <span id="doubleCol"></span>
- <span id="isMobile"></span>
- <div>
- <div class="row topRow">
- <div class="top">
- <div class="left">
- <a class="msdnLogoImg" href="https://msdn.microsoft.com/en-us" title="MSDN home">
- <div id="msft-logo" class="msft-logo"></div>
- </a>
- <div class="GrayPipe"></div>
- <a class="DevCenterFullNameNonMegaBlade" href="https://msdn.microsoft.com/en-us">Developer Network</a>
- <a class="DevCenterFullName" href="https://msdn.microsoft.com/en-us">Developer Network</a>
- <a class="DevCenterShortName" href="https://msdn.microsoft.com/en-us">Developer</a>
- </div>
- <div class="right">
- <div id="signIn">
- <div class="profileImage"></div>
- <a class="scarabLink" href="https://login.live.com/login.srf?wa=wsignin1.0&rpsnv=12&ct=1459376416&rver=6.0.5276.0&wp=mcmbi&wlcxt=msdn%24msdn%24msdn&wreply=https%3a%2f%2fmsdn.microsoft.com%2fen-us%2flibrary%2fff554836%2528d%3dprinter%2cv%3dvs.85%2529.aspx%3flan%3dcsharp%26cc%3dn%26trm%3dtra%26view%3dbook&lc=1033&id=254354&mkt=en-us" title="Sign in">Sign in</a></div>
- <div class="auxNav">
- <div>
- <div data-fragmentname="Subscriptions" id="Fragment_Subscriptions" xmlns="http://www.w3.org/1999/xhtml">
- <a href="https://msdn.microsoft.com/subscriptions/manage/hh442900" id="Subscriptions_2153_1" xmlns="http://www.w3.org/1999/xhtml">MSDN subscriptions</a>
- </div>
- <div data-fragmentname="GetTools" id="Fragment_GetTools" xmlns="http://www.w3.org/1999/xhtml">
- <a href="http://go.microsoft.com/fwlink/?LinkId=309297&clcid=0x409&slcid=0x409&campaign=o~msft~msdn~gettools-header~dn308572" id="GetTools_2153_3" xmlns="http://www.w3.org/1999/xhtml">Get tools</a>
- </div>
- </div>
- <div>
- <div data-fragmentname="SocialLinks" id="Fragment_SocialLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <ul class="links horizontal">
- <li>
- <a href="http://www.facebook.com/microsoftdeveloper" target="_blank" id="SocialLinks_2152_4" class="facebook" xmlns="http://www.w3.org/1999/xhtml">http://www.facebook.com/microsoftdeveloper</a>
- </li>
- <li>
- <a href="https://twitter.com/msdev" target="_blank" id="SocialLinks_2152_5" class="twitter" xmlns="http://www.w3.org/1999/xhtml">https://twitter.com/msdev</a>
- </li>
- <li>
- <a href="http://plus.google.com/111221966647232053570/" target="_blank" id="SocialLinks_2152_6" class="googlePlus" xmlns="http://www.w3.org/1999/xhtml">http://plus.google.com/111221966647232053570/</a>
- </li>
- </ul>
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- <div class="row middleRow">
- <div class="expandTop">
- <div class="left"></div>
- <div class="right"></div>
- </div>
- </div>
- </div>
- <div id="buttomRowWrapper" class="bg_default">
- <div class="row buttomRow bg_default">
- <div class="bottom">
- <div class="left">
- <a id="grip" class="menu-icon" href="javascript:void(0)"></a>
-
- <div id="drawer">
- <div class="toc">
-
- <nav>
- <ul class="navL1">
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Technologies">Technologies</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/cloud-app-development-msdn" title="Cloud">Cloud</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/app-development-msdn" title="App Development">App Development</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/web-app-development-msdn" title="Web">Web</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/big-data-development-msdn" title="Data">Data</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/games-development-msdn" title="Gaming">Gaming</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/internetofthings" title="Internet of Things">Internet of Things</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Downloads">Downloads</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://www.visualstudio.com/downloads/download-visual-studio-vs" title="Visual Studio">Visual Studio</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/subscriptions" title="MSDN subscription access">MSDN subscription access</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/microsoft-sdks-msdn" title="SDKs">SDKs</a>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Trial software">Trial software</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/evalcenter" title="Free downloads">Free downloads</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/officeevaluationresources" title="Office resources">Office resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/sharepoint2013resources" title="SharePoint Server 2013 resources">SharePoint Server 2013 resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/sqlserver2014expressresources" title="SQL Server 2014 Express resources">SQL Server 2014 Express resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/windowsserver2012r2resources" title="Windows Server 2012 resources">Windows Server 2012 resources</a>
- </li>
- </ul>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Programs">Programs</a>
- <ul class="navL2">
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Visual Studio subscriptions">Visual Studio subscriptions</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/msdn-subscriptions-overview" title="Overview">Overview</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/benefits-overview" title="Benefits">Benefits</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/msdn-subscriptions-administration" title="Administrators">Administrators</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Students">Students</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/imagine/imagine-home" title="Microsoft Imagine">Microsoft Imagine</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/microsoftstudentpartners" title="Microsoft Student Partners">Microsoft Student Partners</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Architects">Architects</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-overview-msdn" title="Overview">Overview</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-case-studies-msdn" title="Case studies">Case studies</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-blueprints-msdn" title="Blueprints">Blueprints</a>
- </li>
- <li class="inactive">
- <a href="http://blogs.msdn.com/b/msarchitecture/" title="Blog">Blog</a>
- </li>
- <li class="inactive">
- <a href="http://social.msdn.microsoft.com/forums/en-us/home?brandignore=true&sort=relevancedesc&searchterm=architecture+or+architect" title="Forums">Forums</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/applicationbuilder" title="ISV">ISV</a>
-
- </li>
- <li class="inactive">
- <a href="https://www.microsoft.com/bizspark" title="Startups">Startups</a>
-
- </li>
- <li class="inactive">
- <a href="https://rewards.msdn.microsoft.com/" title="TechRewards">TechRewards</a>
-
- </li>
- <li class="inactive">
- <a href="http://events.msdn.microsoft.com/" title="Events">Events</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Community">Community</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/magazine/dd767791" title="Magazine">Magazine</a>
-
- </li>
- <li class="inactive">
- <a href="https://social.msdn.microsoft.com/forums/" title="Forums">Forums</a>
-
- </li>
- <li class="inactive">
- <a href="http://blogs.msdn.com/b/developer-tools/" title="Blogs">Blogs</a>
-
- </li>
- <li class="inactive">
- <a href="http://tech-advisors.msdn.microsoft.com/en-us" title="Tech Advisors">Tech Advisors</a>
-
- </li>
- <li class="inactive">
- <a href="http://channel9.msdn.com/" title="Channel 9">Channel 9</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive current toggle">
- <a href="javascript:void(0)" title="Documentation">Documentation</a>
- <ul class="navL2">
- <li class="inactive current">
- <a href="https://msdn.microsoft.com/library" title="APIs and reference">APIs and reference</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/developer-centers-msdn" title="Dev centers">Dev centers</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive">
- <a href="https://code.msdn.microsoft.com/" title="Samples">Samples</a>
- </li>
- </ul>
- </nav>
- </div>
- </div>
- </div>
- <div class="right">
- <div data-fragmentname="SearchBox" id="Fragment_SearchBox" xmlns="http://www.w3.org/1999/xhtml">
- <div class="SearchBox">
- <form id="HeaderSearchForm" name="HeaderSearchForm" method="get">
- <button id="FakeHeaderSearchButton" value="Search" type="submit" class="header-search-button">
- <div id="search-finder" class="search-finder"></div>
- </button>
- <button id="HeaderSearchButton" style="display:none"></button>
- <div id="searchSplitter"></div>
- <div id="searchCloseIcon" class="search-clear-x"></div>
- <div id="searchTextContainer" style="width: 0;">
- <input id="HeaderSearchTextBox" name="query" type="text" maxlength="200" onfocus="Epx.Controls.SearchBox.watermarkFocus(event, this.title)" onblur="Epx.Controls.SearchBox.watermarkBlur(event, this.title)">
- </div>
- </form>
-
-
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- </header>
- </div>
-
-
-
- <div class="printExportMenus ltr">
- <a id="isd_printABook" href="http://msdn.microsoft.com/en-us/library/export/help/(d=printer)?returnurl=%2fen-us%2flibrary%2fff554836(d%3dprinter,v%3dvs.85).aspx%3flan%3dcsharp%26cc%3dn%26trm%3dtra%26view%3dbook">
- Export (<span class="count">0</span>)
- </a>
- <a id="isd_print" href="https://msdn.microsoft.com/en-us/library/ff554836(d=printer,v=vs.85).aspx?lan=csharp&cc=n&trm=tra&view=book" rel="nofollow">
- Print
- </a>
- <a id="isd_archiveControl" style="display:none;" data-include-archive="Include Previous Version" data-exclude-archive="Exclude Previous Version">
- </a>
- </div>
-
- <div class="printExportMenus ltr">
- <a id="expandCollapseAll" accesskey="e" href="javascript:void(0)" title="Expand/Collapse all sections by pressing Ctrl + Shift + e">Expand All</a>
- </div>
-
- <div id="body" ms.pgarea="body">
- <span id="tabletView_large"></span>
- <span id="tabletView_small"></span>
- <span id="mobileView"></span>
-
- <div id="content" class="content">
- <input type="hidden" id="printForPab" value="true">
-
- <div class="topic" xmlns="http://www.w3.org/1999/xhtml">
- <h1 class="title">User mode and kernel mode</h1>
-
- <div id="mainSection">
- <div class="clsServerSDKContent">
- </div>
- <p>A processor in a computer running Windows has two different modes: <em>user mode</em> and <em>kernel mode</em>. The processor switches between the two modes depending on what type of code is running on the processor. Applications run in user mode, and core operating system components run in kernel mode. While many drivers run in kernel mode, some drivers may run in user mode.</p>
- <p>When you start a user-mode application, Windows creates a <em>process</em> for the application. The process provides the application with a private <em>virtual address space</em> and a private <em>handle table</em>. Because an application's virtual address space is private, one application cannot alter data that belongs to another application. Each application runs in isolation, and if an application crashes, the crash is limited to that one application. Other applications and the operating system are not affected by the crash.</p>
- <p>In addition to being private, the virtual address space of a user-mode application is limited. A processor running in user mode cannot access virtual addresses that are reserved for the operating system. Limiting the virtual address space of a user-mode application prevents the application from altering, and possibly damaging, critical operating system data.</p>
- <p>All code that runs in kernel mode shares a single virtual address space. This means that a kernel-mode driver is not isolated from other drivers and the operating system itself. If a kernel-mode driver accidentally writes to the wrong virtual address, data that belongs to the operating system or another driver could be compromised. If a kernel-mode driver crashes, the entire operating system crashes.</p>
- <p>This diagram illustrates communication between user-mode and kernel-mode components.</p><img id="UserAndKernelMode01" alt="Block diagram of user-mode and kernel-mode components" src="./Windows Kernel Development Articles (2016-03-30)_files/IC535109.png" title="Block diagram of user-mode and kernel-mode components" xmlns=""><h2><a id="related_topics"></a>Related topics</h2>
- <dl>
- <dt>
- <a href="https://msdn.microsoft.com/en-us/library/hh439648(v=vs.85).aspx">Virtual Address Spaces</a>
- </dt>
- </dl>
- <p> </p>
- <p> </p>
- <p><a href="mailto:wsddocfb@microsoft.com?subject=Documentation%20feedback%20[wdkgetstart\wdkgetstart]:%20User%20mode%20and%20kernel%20mode%20%20RELEASE:%20(3/4/2016)&body=%0A%0APRIVACY%20STATEMENT%0A%0AWe%20use%20your%20feedback%20to%20improve%20the%20documentation.%20We%20don%27t%20use%20your%20email%20address%20for%20any%20other%20purpose,%20and%20we%27ll%20remove%20your%20email%20address%20from%20our%20system%20after%20the%20issue%20that%20you%27re%20reporting%20is%20fixed.%20While%20we%27re%20working%20to%20fix%20this%20issue,%20we%20might%20send%20you%20an%20email%20message%20to%20ask%20for%20more%20info.%20Later,%20we%20might%20also%20send%20you%20an%20email%20message%20to%20let%20you%20know%20that%20we%27ve%20addressed%20your%20feedback.%0A%0AFor%20more%20info%20about%20Microsoft%27s%20privacy%20policy,%20see%20http://privacy.microsoft.com/en-us/default.aspx." title="Send comments about this topic to Microsoft">Send comments about this topic to Microsoft</a></p>
- </div>
- </div>
-
- </div>
- </div>
- <div class="clear"></div>
-
- <input name="__RequestVerificationToken" type="hidden" value="1HT-Fl1br4F22hULe4HdQ5nlS2eg-g34sKYbo8IFxTbjaQ705E4eaESjWLry9TLqkpk-VM7Ana81ZQ_5CIVEmPGuDHA1">
- <input id="ratingValueSubmitUrl" type="hidden" value="https://msdn.microsoft.com/en-us/library/feedback/rate/ff554836(d=printer,v=vs.85).aspx">
- <input id="ratingAdditionalSubmitUrl" type="hidden" value="https://msdn.microsoft.com/en-us/library/feedback/additional/ff554836(d=printer,v=vs.85).aspx">
- <input id="isTopicRated" type="hidden" value="false">
- <div id="lib-footer" ms.pgarea="body">
-
-
- <link type="text/css" rel="stylesheet">
-
- <div id="ux-footer" class="" style="" dir="ltr">
-
- <div id="footerSock" class="librarySock both">
- <div id="footerSockInner">
- <a name="feedback"></a>
- <div class="rating">
- <div id="ratingSection1">
- <div class="title">
- Was this page helpful?
- </div>
- <div class="description">
- Your feedback about this content is important.<br>Let us know what you think.
- </div>
- <div class="buttons">
- <button class="button" id="ratingYes" aria-label="Yes, this page was helpful">Yes</button>
- <button class="button" id="ratingNo" aria-label="No, this page was not helpful">No</button>
- </div>
- <input id="ratingValue" type="hidden" value="">
- </div>
- <div id="ratingSection2">
- <div class="title left">
- Additional feedback?
- </div>
- <textarea id="ratingText" rows="6" cols="" maxlength="1500"></textarea>
- <div class="right">
- <div class="counter">
- <span id="feedbackTextCounter">1500</span> characters remaining
- </div>
- <div class="buttons">
- <button class="button" id="ratingSubmit" aria-label="Submit my additional feedback">Submit</button>
- <button class="button" id="ratingSkipThis" aria-label="Skip additional feedback">Skip this</button>
- </div>
- </div>
- </div>
- <div id="ratingSection3">
- <div class="title">
- Thank you!
- </div>
- <div class="description">
- We appreciate your feedback.
- </div>
- </div>
-
-
- <div id="contentFeedbackQAContainer" style="display: none;"></div>
- </div>
-
- <div class="userVoice">
- <div class="title">
- Help us improve MSDN.
- </div>
- <div class="description">
- Visit our UserVoice Page to submit and vote on ideas!
- </div>
- <div class="buttons">
- <a class="button" id="userVoiceButton" href="http://feedback.msdn.com/forums/257782-msdn-feature-suggestions/category/83975" target="_blank">Make a suggestion</a>
- </div>
- </div>
- <div class="clear"></div>
- </div>
- </div>
- <footer class="top">
- <div data-fragmentname="LeftLinks" id="Fragment_LeftLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Dev centers</div>
- <ul class="links">
- <li>
- <a href="https://dev.windows.com/" id="LeftLinks_2148_1" class="windowsBlue" xmlns="http://www.w3.org/1999/xhtml">Windows</a>
- </li>
- <li>
- <a href="http://dev.office.com/" id="LeftLinks_2148_3" class="office" xmlns="http://www.w3.org/1999/xhtml">Office</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/vstudio" id="LeftLinks_2148_4" class="visualStudio" xmlns="http://www.w3.org/1999/xhtml">Visual Studio</a>
- </li>
- <li>
- <a href="http://azure.microsoft.com/en-us/documentation/" target="_blank" id="LeftLinks_2148_12" xmlns="http://www.w3.org/1999/xhtml">Microsoft Azure</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/developer-centers-msdn" id="LeftLinks_2148_5" xmlns="http://www.w3.org/1999/xhtml">More...</a>
- </li>
- </ul>
- </div>
- </div>
- <div id="rightLinks">
- <div data-fragmentname="CenterLinks1" id="Fragment_CenterLinks1" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Learning resources</div>
- <ul class="links">
- <li>
- <a href="http://www.microsoftvirtualacademy.com/" id="CenterLinks1_2151_4" xmlns="http://www.w3.org/1999/xhtml">Microsoft Virtual Academy</a>
- </li>
- <li>
- <a href="http://channel9.msdn.com/" id="CenterLinks1_2151_5" xmlns="http://www.w3.org/1999/xhtml">Channel 9</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/magazine/" id="CenterLinks1_2151_7" xmlns="http://www.w3.org/1999/xhtml">MSDN Magazine</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks2" id="Fragment_CenterLinks2" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Community</div>
- <ul class="links">
- <li>
- <a href="https://social.msdn.microsoft.com/forums/en-us/home" id="CenterLinks2_2151_8" xmlns="http://www.w3.org/1999/xhtml">Forums</a>
- </li>
- <li>
- <a href="http://blogs.msdn.com/b/developer-tools/" id="CenterLinks2_2151_9" xmlns="http://www.w3.org/1999/xhtml">Blogs</a>
- </li>
- <li>
- <a href="http://www.codeplex.com/" id="CenterLinks2_2151_10" xmlns="http://www.w3.org/1999/xhtml">Codeplex</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks3" id="Fragment_CenterLinks3" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Support</div>
- <ul class="links">
- <li>
- <a href="https://msdn.microsoft.com/hh361695" id="CenterLinks3_2151_11" xmlns="http://www.w3.org/1999/xhtml">Self support</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks4" id="Fragment_CenterLinks4" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Programs</div>
- <ul class="links">
- <li>
- <a href="https://www.microsoft.com/bizspark/" id="CenterLinks4_2151_13" xmlns="http://www.w3.org/1999/xhtml">BizSpark (for startups)</a>
- </li>
- <li>
- <a href="https://www.dreamspark.com/" id="CenterLinks4_2151_14" xmlns="http://www.w3.org/1999/xhtml">DreamSpark</a>
- </li>
- <li>
- <a href="http://www.imaginecup.com/" id="CenterLinks4_2151_17" xmlns="http://www.w3.org/1999/xhtml">Imagine Cup</a>
- </li>
- </ul>
- </div>
- </div>
- </div>
- </footer>
- <footer class="bottom">
- <span class="localeContainer">
-
- <form class="selectLocale" id="selectLocaleForm" action="https://msdn.microsoft.com/en-us/selectlocale-dmc">
- <input type="hidden" name="fromPage" value="https%3a%2f%2fmsdn.microsoft.com%2fen-us%2flibrary%2fff554836(d%3dprinter%2cv%3dvs.85).aspx%3flan%3dCSharp%26cc%3dn%26trm%3dtra%26view%3dbook">
- <a href="http://msdn.microsoft.com/#" onclick="$('#selectLocaleForm').submit();return false;" title="Change your language">United States (English)</a>
- </form>
- </span>
- <div data-fragmentname="BottomLinks" id="Fragment_BottomLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <ul class="links horizontal">
- <li>
- <a href="https://msdn.microsoft.com/newsletter.aspx" id="BottomLinks_2148_7" xmlns="http://www.w3.org/1999/xhtml">Newsletter</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/dn529288" id="BottomLinks_2148_8" xmlns="http://www.w3.org/1999/xhtml">Privacy & cookies</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/cc300389" id="BottomLinks_2148_9" xmlns="http://www.w3.org/1999/xhtml">Terms of use</a>
- </li>
- <li>
- <a href="https://www.microsoft.com/en-us/legal/intellectualproperty/Trademarks/EN-US.aspx" id="BottomLinks_2148_10" xmlns="http://www.w3.org/1999/xhtml">Trademarks</a>
- </li>
- </ul>
- </div>
- </div>
- <span class="logoLegal">
- <span class="logo"></span>
- <span class="copyright">© 2016 Microsoft</span>
- </span>
- </footer>
- </div>
-
- </div>
- <div class="footerPrintView">
- <div class="footerCopyrightPrintView">© 2016 Microsoft</div>
- </div>
-
-
-
-
- <input id="tocPaddingPerLevel" type="hidden" value="17">
- <input id="MtpsDevice" type="hidden" value="Printer">
- <!--[CDATA[ Third party scripts and code linked to or referenced from this website are licensed to you by the parties that own such code, not by Microsoft. See ASP.NET Ajax CDN Terms of Use – http://www.asp.net/ajaxlibrary/CDN.ashx. ]]-->
-
-
-
-
-
- <noscript><div><img alt="DCSIMG" id="Img1" width="1" height="1" src="https://m.webtrends.com/dcsmgru7m99k7mqmgrhudo0k8_8c6m/njs.gif?dcsuri=/nojavascript&amp;WT.js=No" /></div></noscript>
- <div id="globalRequestVerification">
- <input name="__RequestVerificationToken" type="hidden" value="yY9QaV5wxiQXWunZwglMNq3sBluYn47snmgR9GvGdJqLFgoVRF7H_VcShsbt3TjPL548T2nP35TkiMKrbfQhLFHIf781">
- </div>
- </div>
-
-
-
-
-
-
- <script type="text/javascript" class="mtps-injected">
- /*<![CDATA[*/
- (function(window,document){"use strict";function preload(scripts){for(var result=[],script,e,i=0;i<scripts.length;i++)script=scripts[i],script.hasOwnProperty("url")&&(e=document.createElement("script"),e.src=script.url,script.throwaway=e),result.push(script);return result}function inject(scripts,index){var script,elem;if(index>=scripts.length){delete mtps.injectScripts;return}script=scripts[index];elem=document.createElement("script");elem.className="mtps-injected";elem.async=!1;var isLoaded=!1,timeoutId=0,injectNextFnName="",injectNext=elem.onerror=function(){isLoaded||(isLoaded=!0,inject(scripts,index+1),window.clearTimeout(timeoutId),elem.onload=elem.onerror=elem.onreadystatechange=null,injectNextFnName&&delete mtps[injectNextFnName],elem.removeEventListener&&elem.removeEventListener("load",injectNext,!1))};elem.addEventListener?elem.addEventListener("load",injectNext,!1):elem.readyState==="uninitialized"?elem.onreadystatechange=function(){(this.readyState==="loaded"||this.readyState==="complete")&&injectNext()}:elem.onload=injectNext;script.hasOwnProperty("url")?(timeoutId=window.setTimeout(injectNext,12e4),elem.src=script.url):(injectNextFnName="_injectNextScript_"+index,mtps[injectNextFnName]=injectNext,timeoutId=window.setTimeout(injectNext,2e3),elem.text="try {\n"+script.txt+"\n} finally { MTPS."+injectNextFnName+" && MTPS."+injectNextFnName+"(); }");parent.appendChild(elem)}var mtps=window.MTPS||(window.MTPS={}),parent=document.getElementsByTagName("head")[0];mtps.injectScripts=function(scripts){inject(preload(scripts),0)}})(window,document);
- MTPS.injectScripts([
- { txt: "/**/\r\n(window.MTPS || (window.MTPS = {})).cdnDomains || (window.MTPS.cdnDomains = { \r\n\t\"image\": \"https://i-msdn.sec.s-msft.com\", \r\n\t\"js\": \"https://i2-msdn.sec.s-msft.com\", \r\n\t\"css\": \"https://i-msdn.sec.s-msft.com\", \r\n\t\"ttf\": \"https://i-msdn.sec.s-msft.com\"\r\n});\r\n/**/" },
- { txt: "//\n var literalNormalizedUrl = \u0027/en-us/library/ff554836(d=printer,l=en-us,v=vs.85).aspx\u0027;\n var wt_nvr_ru = \u0027WT_NVR_RU\u0027;\n var wt_fpcdom = \u0027.microsoft.com\u0027;\n var wt_domlist = \u0027msdn.microsoft.com\u0027;\n var wt_pathlist = \u0027\u0027;\n var wt_paramlist = \u0027DCSext.mtps_devcenter\u0027;\n var wt_siteid = \u0027MSDN\u0027;\n var gDomain = \u0027m.webtrends.com\u0027;\n var gDcsId = \u0027dcsmgru7m99k7mqmgrhudo0k8_8c6m\u0027;\n var gFpc = \u0027WT_FPC\u0027;\n\n\n\n if (document.cookie.indexOf(gFpc + \"=\") == -1) {\n var wtidJs = document.createElement(\"script\");\n wtidJs.src = \"//\" + gDomain + \"/\" + gDcsId + \"/wtid.js\";\n document.getElementsByTagName(\"head\")[0].appendChild(wtidJs);\n }\n\n\n\n var detectedLocale = \u0027en-us\u0027;\n var wtsp = \u0027msdnlib_w32_com\u0027;\n var gTrackEvents = \u00270\u0027;\n/**/" },
- { txt: "//\n\n window.appInsightsId = \u00275eb1b2eb-c47a-497a-a7ac-a1c230b2882f\u0027;\n //" },
- { url: "https://i2-msdn.sec.s-msft.com/Combined.js?resources=0:Utilities,1:Layout,2:Header,1:Rating,2:Footer,0:Topic,3:PabTopic,4:webtrendsscript,0:AppInsightsPerf,0:ABTestControl,5:WEDCS,3:CmpgrpForHeader,0:livefyre,0:Comment,1:SearchBox;/Areas/Epx/Content/Scripts:0,/Areas/Epx/Themes/Base/Content:1,/Areas/Centers/Themes/StandardDevCenter/Content:2,/Areas/Library/Content:3,/Areas/Global/Content/Webtrends/resources:4,/Areas/Library/Themes/Base/Content:5\u0026amp;hashKey=30CEE944AABFEA2C5A338BDB9E000732\u0026amp;v=AE608271C0243AAA0449D3BC0FAD8EB4" },
- { url: "https://i1.services.social.microsoft.com/search/Widgets/SearchBox.jss?boxid=HeaderSearchTextBox\u0026btnid=HeaderSearchButton\u0026pgArea=header\u0026brand=Msdn\u0026loc=en-us\u0026focusOnInit=false\u0026emptyWatermark=true\u0026searchButtonTooltip=Search MSDN" },
- { url: "https://i2-msdn.sec.s-msft.com/Combined.js?resources=0:PrintExportButton,1:Toc_Fixed,1:CodeSnippet,1:TopicNotInScope,1:CollapsibleArea,1:VersionSelector,1:SurveyBroker;/Areas/Library/Themes/Base/Content:0,/Areas/Epx/Content/Scripts:1\u0026amp;hashKey=80F30894E3FB8A3295C923AEC7019CFE\u0026amp;v=AE608271C0243AAA0449D3BC0FAD8EB4" },
- { txt: "$(document).ready(function() {\n try {\n var token = $(\"#globalRequestVerification input[name=\u0027__RequestVerificationToken\u0027]\").clone();\n $(\"#siteFeedbackForm\").append(token);\n } catch(err) {\n \n }\n });" }
- ]);
- /*]]>*/
- </script>
- <link rel="stylesheet" type="text/css" href="./Windows Kernel Development Articles (2016-03-30)_files/Combined.css">
- <div id="page">
-
-
-
-
- <link type="text/css" rel="stylesheet">
-
- <input type="hidden" id="isHeaderBleeding" value="true">
- <div id="ux-header" dir="ltr" class="ltr msdn">
-
- <header>
- <span id="singleCol"></span>
- <span id="doubleCol"></span>
- <span id="isMobile"></span>
- <div>
- <div class="row topRow">
- <div class="top">
- <div class="left">
- <a class="msdnLogoImg" href="https://msdn.microsoft.com/en-us" title="MSDN home">
- <div id="msft-logo" class="msft-logo"></div>
- </a>
- <div class="GrayPipe"></div>
- <a class="DevCenterFullNameNonMegaBlade" href="https://msdn.microsoft.com/en-us">Developer Network</a>
- <a class="DevCenterFullName" href="https://msdn.microsoft.com/en-us">Developer Network</a>
- <a class="DevCenterShortName" href="https://msdn.microsoft.com/en-us">Developer</a>
- </div>
- <div class="right">
- <div id="signIn">
- <div class="profileImage"></div>
- <a class="scarabLink" href="https://login.live.com/login.srf?wa=wsignin1.0&rpsnv=12&ct=1459376417&rver=6.0.5276.0&wp=mcmbi&wlcxt=msdn%24msdn%24msdn&wreply=https%3a%2f%2fmsdn.microsoft.com%2fen-us%2flibrary%2fhh439648%2528d%3dprinter%2cv%3dvs.85%2529.aspx%3flan%3dcsharp%26cc%3dn%26trm%3dtra%26view%3dbook&lc=1033&id=254354&mkt=en-us" title="Sign in">Sign in</a></div>
- <div class="auxNav">
- <div>
- <div data-fragmentname="Subscriptions" id="Fragment_Subscriptions" xmlns="http://www.w3.org/1999/xhtml">
- <a href="https://msdn.microsoft.com/subscriptions/manage/hh442900" id="Subscriptions_2153_1" xmlns="http://www.w3.org/1999/xhtml">MSDN subscriptions</a>
- </div>
- <div data-fragmentname="GetTools" id="Fragment_GetTools" xmlns="http://www.w3.org/1999/xhtml">
- <a href="http://go.microsoft.com/fwlink/?LinkId=309297&clcid=0x409&slcid=0x409&campaign=o~msft~msdn~gettools-header~dn308572" id="GetTools_2153_3" xmlns="http://www.w3.org/1999/xhtml">Get tools</a>
- </div>
- </div>
- <div>
- <div data-fragmentname="SocialLinks" id="Fragment_SocialLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <ul class="links horizontal">
- <li>
- <a href="http://www.facebook.com/microsoftdeveloper" target="_blank" id="SocialLinks_2152_4" class="facebook" xmlns="http://www.w3.org/1999/xhtml">http://www.facebook.com/microsoftdeveloper</a>
- </li>
- <li>
- <a href="https://twitter.com/msdev" target="_blank" id="SocialLinks_2152_5" class="twitter" xmlns="http://www.w3.org/1999/xhtml">https://twitter.com/msdev</a>
- </li>
- <li>
- <a href="http://plus.google.com/111221966647232053570/" target="_blank" id="SocialLinks_2152_6" class="googlePlus" xmlns="http://www.w3.org/1999/xhtml">http://plus.google.com/111221966647232053570/</a>
- </li>
- </ul>
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- <div class="row middleRow">
- <div class="expandTop">
- <div class="left"></div>
- <div class="right"></div>
- </div>
- </div>
- </div>
- <div id="buttomRowWrapper" class="bg_default">
- <div class="row buttomRow bg_default">
- <div class="bottom">
- <div class="left">
- <a id="grip" class="menu-icon" href="javascript:void(0)"></a>
-
- <div id="drawer">
- <div class="toc">
-
- <nav>
- <ul class="navL1">
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Technologies">Technologies</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/cloud-app-development-msdn" title="Cloud">Cloud</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/app-development-msdn" title="App Development">App Development</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/web-app-development-msdn" title="Web">Web</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/big-data-development-msdn" title="Data">Data</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/games-development-msdn" title="Gaming">Gaming</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/internetofthings" title="Internet of Things">Internet of Things</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Downloads">Downloads</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://www.visualstudio.com/downloads/download-visual-studio-vs" title="Visual Studio">Visual Studio</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/subscriptions" title="MSDN subscription access">MSDN subscription access</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/microsoft-sdks-msdn" title="SDKs">SDKs</a>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Trial software">Trial software</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/evalcenter" title="Free downloads">Free downloads</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/officeevaluationresources" title="Office resources">Office resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/sharepoint2013resources" title="SharePoint Server 2013 resources">SharePoint Server 2013 resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/sqlserver2014expressresources" title="SQL Server 2014 Express resources">SQL Server 2014 Express resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/windowsserver2012r2resources" title="Windows Server 2012 resources">Windows Server 2012 resources</a>
- </li>
- </ul>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Programs">Programs</a>
- <ul class="navL2">
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Visual Studio subscriptions">Visual Studio subscriptions</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/msdn-subscriptions-overview" title="Overview">Overview</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/benefits-overview" title="Benefits">Benefits</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/msdn-subscriptions-administration" title="Administrators">Administrators</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Students">Students</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/imagine/imagine-home" title="Microsoft Imagine">Microsoft Imagine</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/microsoftstudentpartners" title="Microsoft Student Partners">Microsoft Student Partners</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Architects">Architects</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-overview-msdn" title="Overview">Overview</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-case-studies-msdn" title="Case studies">Case studies</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-blueprints-msdn" title="Blueprints">Blueprints</a>
- </li>
- <li class="inactive">
- <a href="http://blogs.msdn.com/b/msarchitecture/" title="Blog">Blog</a>
- </li>
- <li class="inactive">
- <a href="http://social.msdn.microsoft.com/forums/en-us/home?brandignore=true&sort=relevancedesc&searchterm=architecture+or+architect" title="Forums">Forums</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/applicationbuilder" title="ISV">ISV</a>
-
- </li>
- <li class="inactive">
- <a href="https://www.microsoft.com/bizspark" title="Startups">Startups</a>
-
- </li>
- <li class="inactive">
- <a href="https://rewards.msdn.microsoft.com/" title="TechRewards">TechRewards</a>
-
- </li>
- <li class="inactive">
- <a href="http://events.msdn.microsoft.com/" title="Events">Events</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Community">Community</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/magazine/dd767791" title="Magazine">Magazine</a>
-
- </li>
- <li class="inactive">
- <a href="https://social.msdn.microsoft.com/forums/" title="Forums">Forums</a>
-
- </li>
- <li class="inactive">
- <a href="http://blogs.msdn.com/b/developer-tools/" title="Blogs">Blogs</a>
-
- </li>
- <li class="inactive">
- <a href="http://tech-advisors.msdn.microsoft.com/en-us" title="Tech Advisors">Tech Advisors</a>
-
- </li>
- <li class="inactive">
- <a href="http://channel9.msdn.com/" title="Channel 9">Channel 9</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive current toggle">
- <a href="javascript:void(0)" title="Documentation">Documentation</a>
- <ul class="navL2">
- <li class="inactive current">
- <a href="https://msdn.microsoft.com/library" title="APIs and reference">APIs and reference</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/developer-centers-msdn" title="Dev centers">Dev centers</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive">
- <a href="https://code.msdn.microsoft.com/" title="Samples">Samples</a>
- </li>
- </ul>
- </nav>
- </div>
- </div>
- </div>
- <div class="right">
- <div data-fragmentname="SearchBox" id="Fragment_SearchBox" xmlns="http://www.w3.org/1999/xhtml">
- <div class="SearchBox">
- <form id="HeaderSearchForm" name="HeaderSearchForm" method="get">
- <button id="FakeHeaderSearchButton" value="Search" type="submit" class="header-search-button">
- <div id="search-finder" class="search-finder"></div>
- </button>
- <button id="HeaderSearchButton" style="display:none"></button>
- <div id="searchSplitter"></div>
- <div id="searchCloseIcon" class="search-clear-x"></div>
- <div id="searchTextContainer" style="width: 0;">
- <input id="HeaderSearchTextBox" name="query" type="text" maxlength="200" onfocus="Epx.Controls.SearchBox.watermarkFocus(event, this.title)" onblur="Epx.Controls.SearchBox.watermarkBlur(event, this.title)">
- </div>
- </form>
-
-
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- </header>
- </div>
-
-
-
- <div class="printExportMenus ltr">
- <a id="isd_printABook" href="http://msdn.microsoft.com/en-us/library/export/help/(d=printer)?returnurl=%2fen-us%2flibrary%2fhh439648(d%3dprinter,v%3dvs.85).aspx%3flan%3dcsharp%26cc%3dn%26trm%3dtra%26view%3dbook">
- Export (<span class="count">0</span>)
- </a>
- <a id="isd_print" href="https://msdn.microsoft.com/en-us/library/hh439648(d=printer,v=vs.85).aspx?lan=csharp&cc=n&trm=tra&view=book" rel="nofollow">
- Print
- </a>
- <a id="isd_archiveControl" style="display:none;" data-include-archive="Include Previous Version" data-exclude-archive="Exclude Previous Version">
- </a>
- </div>
-
- <div class="printExportMenus ltr">
- <a id="expandCollapseAll" accesskey="e" href="javascript:void(0)" title="Expand/Collapse all sections by pressing Ctrl + Shift + e">Expand All</a>
- </div>
-
- <div id="body" ms.pgarea="body">
- <span id="tabletView_large"></span>
- <span id="tabletView_small"></span>
- <span id="mobileView"></span>
-
- <div id="content" class="content">
- <input type="hidden" id="printForPab" value="true">
-
- <div class="topic" xmlns="http://www.w3.org/1999/xhtml">
- <h1 class="title">Virtual address spaces</h1>
-
- <div id="mainSection">
- <div class="clsServerSDKContent">
- </div>
- <p>When a processor reads or writes to a memory location, it uses a virtual address. As part of the read or write operation, the processor translates the virtual address to a physical address. Accessing memory through a virtual address has these advantages:</p>
- <ul>
- <li>
- <p>A program can use a contiguous range of virtual addresses to access a large memory buffer that is not contiguous in physical memory.</p>
- </li>
- <li>
- <p> A program can use a range of virtual addresses to access a memory buffer that is larger than the available physical memory. As the supply of physical memory becomes small, the memory manager saves pages of physical memory (typically 4 kilobytes in size) to a disk file. Pages of data or code are moved between physical memory and the disk as needed.</p>
- </li>
- <li>
- <p>The virtual addresses used by different processes are isolated from each other. The code in one process cannot alter the physical memory that is being used by another process or the operating system.</p>
- </li>
- </ul>
- <p>The range of virtual addresses that is available to a process is called the <em>virtual address space</em> for the process. Each user-mode process has its own private virtual address space.
- For a 32-bit process, the virtual address space is usually the 2-gigabyte range 0x00000000 through 0x7FFFFFFF. For a 64-bit process, the virtual address space is the 8-terabyte range 0x000'00000000 through 0x7FF'FFFFFFFF. A range of virtual addresses is sometimes called a range of <em>virtual memory</em>.</p>
- <p>This diagram illustrates some of the key features of virtual address spaces.</p><img id="virtualaddressspace01" alt="Diagram of virtual address spaces for two processes" src="./Windows Kernel Development Articles (2016-03-30)_files/IC535110.png" title="Diagram of virtual address spaces for two processes" xmlns=""><p>The diagram shows the virtual address spaces for two 64-bit processes: Notepad.exe and MyApp.exe. Each process has its own virtual address space that goes from 0x000'0000000 through 0x7FF'FFFFFFFF. Each shaded block represents one page (4 kilobytes in size) of virtual or physical memory. Notice that the Notepad process uses three contiguous pages of virtual addresses, starting at 0x7F7'93950000. But those three contiguous pages of virtual addresses are mapped to noncontiguous pages in physical memory. Also notice that both processes use a page of virtual memory beginning at 0x7F7'93950000, but those virtual pages are mapped to different pages of physical memory.</p>
- <h2><a id="User_space_and_system_space"></a><a id="user_space_and_system_space"></a><a id="USER_SPACE_AND_SYSTEM_SPACE"></a>User space and system space</h2>
- <p>Processes like Notepad.exe and MyApp.exe run in user mode. Core operating system components and many drivers run in the more privileged kernel mode. For more information about processor modes, see <a href="https://msdn.microsoft.com/en-us/library/ff554836(v=vs.85).aspx">User mode and kernel mode</a>. Each user-mode process has its own private virtual address space, but all code that runs in kernel mode shares a single virtual address space called <em>system space</em>. The virtual address space for the current user-mode process is called <em>user space</em>.</p>
- <p>In 32-bit Windows, the total available virtual address space is 2^32 bytes (4 gigabytes). Usually the lower 2 gigabytes are used for user space, and the upper 2 gigabytes are used for system space.</p><img id="VirtualAddressSpace02" alt="Diagram of system space" src="./Windows Kernel Development Articles (2016-03-30)_files/IC535111.png" title="Diagram of system space" xmlns=""><p>In 32-bit Windows, you have the option of specifying (at boot time) that more than 2 gigabytes are available for user space. The consequence is that fewer virtual addresses are available for system space. You can increase the size of user space to as much as 3 gigabytes, in which case only 1 gigabyte is available for system space. To increase the size of user space, use <a href="https://msdn.microsoft.com/en-us/library/ff542202(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">BCDEdit /set increaseuserva</strong></a>.</p>
- <p>In 64-bit Windows, the theoretical amount of virtual address space is 2^64 bytes (16 exabytes), but only a small portion of the 16-exabyte range is actually used. The 8-terabyte range from 0x000'00000000 through 0x7FF'FFFFFFFF is used for user space, and portions of the 248-terabyte range from 0xFFFF0800'00000000 through 0xFFFFFFFF'FFFFFFFF are used for system space.</p><img id="VirtualAddressSpace03" alt="Diagram of paged pool and nonpaged pool" src="./Windows Kernel Development Articles (2016-03-30)_files/IC535112.png" title="Diagram of paged pool and nonpaged pool" xmlns=""><p>Code running in user mode has access to user space but does not have access to system space. This restriction prevents user-mode code from reading or altering protected operating system data structures. Code running in kernel mode has access to both user space and system space. That is, code running in kernel mode has access to system space and the virtual address space of the current user-mode process.</p>
- <p>Drivers that run in kernel mode must be very careful about directly reading from or writing to addresses in user space. This scenario illustrates why.</p>
- <ol>
- <li>
- <p>A user-mode program initiates a request to read some data from a device. The program supplies the starting address of a buffer to receive the data.</p>
- </li>
- <li>
- <p>A device driver routine, running in kernel mode, starts the read operation and returns control to its caller.</p>
- </li>
- <li>Later the device interrupts whatever thread is currently running to say that the read operation is complete. The interrupt is handled by kernel-mode driver routines running on this arbitrary thread, which belongs to an arbitrary process.</li>
- <li>At this point, the driver must not write the data to the starting address that the user-mode program supplied in Step 1. This address is in the virtual address space of the process that initiated the request, which is most likely not the same as the current process.</li>
- </ol>
- <h2><a id="Paged_pool_and_Nonpaged_pool"></a><a id="paged_pool_and_nonpaged_pool"></a><a id="PAGED_POOL_AND_NONPAGED_POOL"></a>Paged pool and Nonpaged pool</h2>
- <p>In user space, all physical memory pages can be paged out to a disk file as needed. In system space, some physical pages can be paged out and others cannot. System space has two regions for dynamically allocating memory: paged pool and nonpaged pool. In 64-bit Windows, paged pool is the 128-gigabyte range of virtual addresses that goes from 0xFFFFA800'00000000 through 0xFFFFA81F'FFFFFFFF. Nonpaged pool is the 128-gigabyte range of virtual addresses that goes from 0xFFFFAC00'00000000 through 0xFFFFAC1F'FFFFFFFF.</p>
- <p>Memory that is allocated in paged pool can be paged out to a disk file as needed. Memory that is allocated in nonpaged pool can never be paged out to a disk file.</p><img id="VirtualAddressSpace04" alt="Diagram comparing memory allocation in paged pool to that in nonpaged pool" src="./Windows Kernel Development Articles (2016-03-30)_files/IC535113.png" title="Diagram comparing memory allocation in paged pool to that in nonpaged pool" xmlns=""><h2><a id="related_topics"></a>Related topics</h2>
- <dl>
- <dt>
- <a href="https://msdn.microsoft.com/en-us/library/ff554836(v=vs.85).aspx">User mode and kernel mode</a>
- </dt>
- </dl>
- <p> </p>
- <p> </p>
- <p><a href="mailto:wsddocfb@microsoft.com?subject=Documentation%20feedback%20[wdkgetstart\wdkgetstart]:%20Virtual%20address%20spaces%20%20RELEASE:%20(3/4/2016)&body=%0A%0APRIVACY%20STATEMENT%0A%0AWe%20use%20your%20feedback%20to%20improve%20the%20documentation.%20We%20don%27t%20use%20your%20email%20address%20for%20any%20other%20purpose,%20and%20we%27ll%20remove%20your%20email%20address%20from%20our%20system%20after%20the%20issue%20that%20you%27re%20reporting%20is%20fixed.%20While%20we%27re%20working%20to%20fix%20this%20issue,%20we%20might%20send%20you%20an%20email%20message%20to%20ask%20for%20more%20info.%20Later,%20we%20might%20also%20send%20you%20an%20email%20message%20to%20let%20you%20know%20that%20we%27ve%20addressed%20your%20feedback.%0A%0AFor%20more%20info%20about%20Microsoft%27s%20privacy%20policy,%20see%20http://privacy.microsoft.com/en-us/default.aspx." title="Send comments about this topic to Microsoft">Send comments about this topic to Microsoft</a></p>
- </div>
- </div>
-
- </div>
- </div>
- <div class="clear"></div>
-
- <input name="__RequestVerificationToken" type="hidden" value="9NzOA4NRSJk34bEo35Zi5eb41FYP4aXBvl8_28dHfRRQJ_5oHOP74PufZNern-EHnlXcMZ7uRQw508ifuarrPhul0QE1">
- <input id="ratingValueSubmitUrl" type="hidden" value="https://msdn.microsoft.com/en-us/library/feedback/rate/hh439648(d=printer,v=vs.85).aspx">
- <input id="ratingAdditionalSubmitUrl" type="hidden" value="https://msdn.microsoft.com/en-us/library/feedback/additional/hh439648(d=printer,v=vs.85).aspx">
- <input id="isTopicRated" type="hidden" value="false">
- <div id="lib-footer" ms.pgarea="body">
-
-
- <link type="text/css" rel="stylesheet">
-
- <div id="ux-footer" class="" style="" dir="ltr">
-
- <div id="footerSock" class="librarySock both">
- <div id="footerSockInner">
- <a name="feedback"></a>
- <div class="rating">
- <div id="ratingSection1">
- <div class="title">
- Was this page helpful?
- </div>
- <div class="description">
- Your feedback about this content is important.<br>Let us know what you think.
- </div>
- <div class="buttons">
- <button class="button" id="ratingYes" aria-label="Yes, this page was helpful">Yes</button>
- <button class="button" id="ratingNo" aria-label="No, this page was not helpful">No</button>
- </div>
- <input id="ratingValue" type="hidden" value="">
- </div>
- <div id="ratingSection2">
- <div class="title left">
- Additional feedback?
- </div>
- <textarea id="ratingText" rows="6" cols="" maxlength="1500"></textarea>
- <div class="right">
- <div class="counter">
- <span id="feedbackTextCounter">1500</span> characters remaining
- </div>
- <div class="buttons">
- <button class="button" id="ratingSubmit" aria-label="Submit my additional feedback">Submit</button>
- <button class="button" id="ratingSkipThis" aria-label="Skip additional feedback">Skip this</button>
- </div>
- </div>
- </div>
- <div id="ratingSection3">
- <div class="title">
- Thank you!
- </div>
- <div class="description">
- We appreciate your feedback.
- </div>
- </div>
-
-
- <div id="contentFeedbackQAContainer" style="display: none;"></div>
- </div>
-
- <div class="userVoice">
- <div class="title">
- Help us improve MSDN.
- </div>
- <div class="description">
- Visit our UserVoice Page to submit and vote on ideas!
- </div>
- <div class="buttons">
- <a class="button" id="userVoiceButton" href="http://feedback.msdn.com/forums/257782-msdn-feature-suggestions/category/83975" target="_blank">Make a suggestion</a>
- </div>
- </div>
- <div class="clear"></div>
- </div>
- </div>
- <footer class="top">
- <div data-fragmentname="LeftLinks" id="Fragment_LeftLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Dev centers</div>
- <ul class="links">
- <li>
- <a href="https://dev.windows.com/" id="LeftLinks_2148_1" class="windowsBlue" xmlns="http://www.w3.org/1999/xhtml">Windows</a>
- </li>
- <li>
- <a href="http://dev.office.com/" id="LeftLinks_2148_3" class="office" xmlns="http://www.w3.org/1999/xhtml">Office</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/vstudio" id="LeftLinks_2148_4" class="visualStudio" xmlns="http://www.w3.org/1999/xhtml">Visual Studio</a>
- </li>
- <li>
- <a href="http://azure.microsoft.com/en-us/documentation/" target="_blank" id="LeftLinks_2148_12" xmlns="http://www.w3.org/1999/xhtml">Microsoft Azure</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/developer-centers-msdn" id="LeftLinks_2148_5" xmlns="http://www.w3.org/1999/xhtml">More...</a>
- </li>
- </ul>
- </div>
- </div>
- <div id="rightLinks">
- <div data-fragmentname="CenterLinks1" id="Fragment_CenterLinks1" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Learning resources</div>
- <ul class="links">
- <li>
- <a href="http://www.microsoftvirtualacademy.com/" id="CenterLinks1_2151_4" xmlns="http://www.w3.org/1999/xhtml">Microsoft Virtual Academy</a>
- </li>
- <li>
- <a href="http://channel9.msdn.com/" id="CenterLinks1_2151_5" xmlns="http://www.w3.org/1999/xhtml">Channel 9</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/magazine/" id="CenterLinks1_2151_7" xmlns="http://www.w3.org/1999/xhtml">MSDN Magazine</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks2" id="Fragment_CenterLinks2" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Community</div>
- <ul class="links">
- <li>
- <a href="https://social.msdn.microsoft.com/forums/en-us/home" id="CenterLinks2_2151_8" xmlns="http://www.w3.org/1999/xhtml">Forums</a>
- </li>
- <li>
- <a href="http://blogs.msdn.com/b/developer-tools/" id="CenterLinks2_2151_9" xmlns="http://www.w3.org/1999/xhtml">Blogs</a>
- </li>
- <li>
- <a href="http://www.codeplex.com/" id="CenterLinks2_2151_10" xmlns="http://www.w3.org/1999/xhtml">Codeplex</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks3" id="Fragment_CenterLinks3" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Support</div>
- <ul class="links">
- <li>
- <a href="https://msdn.microsoft.com/hh361695" id="CenterLinks3_2151_11" xmlns="http://www.w3.org/1999/xhtml">Self support</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks4" id="Fragment_CenterLinks4" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Programs</div>
- <ul class="links">
- <li>
- <a href="https://www.microsoft.com/bizspark/" id="CenterLinks4_2151_13" xmlns="http://www.w3.org/1999/xhtml">BizSpark (for startups)</a>
- </li>
- <li>
- <a href="https://www.dreamspark.com/" id="CenterLinks4_2151_14" xmlns="http://www.w3.org/1999/xhtml">DreamSpark</a>
- </li>
- <li>
- <a href="http://www.imaginecup.com/" id="CenterLinks4_2151_17" xmlns="http://www.w3.org/1999/xhtml">Imagine Cup</a>
- </li>
- </ul>
- </div>
- </div>
- </div>
- </footer>
- <footer class="bottom">
- <span class="localeContainer">
-
- <form class="selectLocale" id="selectLocaleForm" action="https://msdn.microsoft.com/en-us/selectlocale-dmc">
- <input type="hidden" name="fromPage" value="https%3a%2f%2fmsdn.microsoft.com%2fen-us%2flibrary%2fhh439648(d%3dprinter%2cv%3dvs.85).aspx%3flan%3dCSharp%26cc%3dn%26trm%3dtra%26view%3dbook">
- <a href="http://msdn.microsoft.com/#" onclick="$('#selectLocaleForm').submit();return false;" title="Change your language">United States (English)</a>
- </form>
- </span>
- <div data-fragmentname="BottomLinks" id="Fragment_BottomLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <ul class="links horizontal">
- <li>
- <a href="https://msdn.microsoft.com/newsletter.aspx" id="BottomLinks_2148_7" xmlns="http://www.w3.org/1999/xhtml">Newsletter</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/dn529288" id="BottomLinks_2148_8" xmlns="http://www.w3.org/1999/xhtml">Privacy & cookies</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/cc300389" id="BottomLinks_2148_9" xmlns="http://www.w3.org/1999/xhtml">Terms of use</a>
- </li>
- <li>
- <a href="https://www.microsoft.com/en-us/legal/intellectualproperty/Trademarks/EN-US.aspx" id="BottomLinks_2148_10" xmlns="http://www.w3.org/1999/xhtml">Trademarks</a>
- </li>
- </ul>
- </div>
- </div>
- <span class="logoLegal">
- <span class="logo"></span>
- <span class="copyright">© 2016 Microsoft</span>
- </span>
- </footer>
- </div>
-
- </div>
- <div class="footerPrintView">
- <div class="footerCopyrightPrintView">© 2016 Microsoft</div>
- </div>
-
-
-
-
- <input id="tocPaddingPerLevel" type="hidden" value="17">
- <input id="MtpsDevice" type="hidden" value="Printer">
- <!--[CDATA[ Third party scripts and code linked to or referenced from this website are licensed to you by the parties that own such code, not by Microsoft. See ASP.NET Ajax CDN Terms of Use – http://www.asp.net/ajaxlibrary/CDN.ashx. ]]-->
-
-
-
-
-
- <noscript><div><img alt="DCSIMG" id="Img1" width="1" height="1" src="https://m.webtrends.com/dcsmgru7m99k7mqmgrhudo0k8_8c6m/njs.gif?dcsuri=/nojavascript&amp;WT.js=No" /></div></noscript>
- <div id="globalRequestVerification">
- <input name="__RequestVerificationToken" type="hidden" value="r5S--CICQofBUkSvFFHT8fBz3PnwzkwVB_4fBLnoBn4RyL4zR51FkOFiL7Btyjv3yAemnW9JnZTqbR7eo-xgAaT9d7g1">
- </div>
- </div>
-
-
-
-
-
-
- <script type="text/javascript" class="mtps-injected">
- /*<![CDATA[*/
- (function(window,document){"use strict";function preload(scripts){for(var result=[],script,e,i=0;i<scripts.length;i++)script=scripts[i],script.hasOwnProperty("url")&&(e=document.createElement("script"),e.src=script.url,script.throwaway=e),result.push(script);return result}function inject(scripts,index){var script,elem;if(index>=scripts.length){delete mtps.injectScripts;return}script=scripts[index];elem=document.createElement("script");elem.className="mtps-injected";elem.async=!1;var isLoaded=!1,timeoutId=0,injectNextFnName="",injectNext=elem.onerror=function(){isLoaded||(isLoaded=!0,inject(scripts,index+1),window.clearTimeout(timeoutId),elem.onload=elem.onerror=elem.onreadystatechange=null,injectNextFnName&&delete mtps[injectNextFnName],elem.removeEventListener&&elem.removeEventListener("load",injectNext,!1))};elem.addEventListener?elem.addEventListener("load",injectNext,!1):elem.readyState==="uninitialized"?elem.onreadystatechange=function(){(this.readyState==="loaded"||this.readyState==="complete")&&injectNext()}:elem.onload=injectNext;script.hasOwnProperty("url")?(timeoutId=window.setTimeout(injectNext,12e4),elem.src=script.url):(injectNextFnName="_injectNextScript_"+index,mtps[injectNextFnName]=injectNext,timeoutId=window.setTimeout(injectNext,2e3),elem.text="try {\n"+script.txt+"\n} finally { MTPS."+injectNextFnName+" && MTPS."+injectNextFnName+"(); }");parent.appendChild(elem)}var mtps=window.MTPS||(window.MTPS={}),parent=document.getElementsByTagName("head")[0];mtps.injectScripts=function(scripts){inject(preload(scripts),0)}})(window,document);
- MTPS.injectScripts([
- { txt: "/**/\r\n(window.MTPS || (window.MTPS = {})).cdnDomains || (window.MTPS.cdnDomains = { \r\n\t\"image\": \"https://i-msdn.sec.s-msft.com\", \r\n\t\"js\": \"https://i2-msdn.sec.s-msft.com\", \r\n\t\"css\": \"https://i-msdn.sec.s-msft.com\", \r\n\t\"ttf\": \"https://i-msdn.sec.s-msft.com\"\r\n});\r\n/**/" },
- { txt: "//\n var literalNormalizedUrl = \u0027/en-us/library/hh439648(d=printer,l=en-us,v=vs.85).aspx\u0027;\n var wt_nvr_ru = \u0027WT_NVR_RU\u0027;\n var wt_fpcdom = \u0027.microsoft.com\u0027;\n var wt_domlist = \u0027msdn.microsoft.com\u0027;\n var wt_pathlist = \u0027\u0027;\n var wt_paramlist = \u0027DCSext.mtps_devcenter\u0027;\n var wt_siteid = \u0027MSDN\u0027;\n var gDomain = \u0027m.webtrends.com\u0027;\n var gDcsId = \u0027dcsmgru7m99k7mqmgrhudo0k8_8c6m\u0027;\n var gFpc = \u0027WT_FPC\u0027;\n\n\n\n if (document.cookie.indexOf(gFpc + \"=\") == -1) {\n var wtidJs = document.createElement(\"script\");\n wtidJs.src = \"//\" + gDomain + \"/\" + gDcsId + \"/wtid.js\";\n document.getElementsByTagName(\"head\")[0].appendChild(wtidJs);\n }\n\n\n\n var detectedLocale = \u0027en-us\u0027;\n var wtsp = \u0027msdnlib_w32_com\u0027;\n var gTrackEvents = \u00270\u0027;\n/**/" },
- { txt: "//\n\n window.appInsightsId = \u00275eb1b2eb-c47a-497a-a7ac-a1c230b2882f\u0027;\n //" },
- { url: "https://i2-msdn.sec.s-msft.com/Combined.js?resources=0:Utilities,1:Layout,2:Header,1:Rating,2:Footer,0:Topic,3:PabTopic,4:webtrendsscript,0:AppInsightsPerf,0:ABTestControl,5:WEDCS,3:CmpgrpForHeader,0:livefyre,0:Comment,1:SearchBox;/Areas/Epx/Content/Scripts:0,/Areas/Epx/Themes/Base/Content:1,/Areas/Centers/Themes/StandardDevCenter/Content:2,/Areas/Library/Content:3,/Areas/Global/Content/Webtrends/resources:4,/Areas/Library/Themes/Base/Content:5\u0026amp;hashKey=30CEE944AABFEA2C5A338BDB9E000732\u0026amp;v=AE608271C0243AAA0449D3BC0FAD8EB4" },
- { url: "https://i1.services.social.microsoft.com/search/Widgets/SearchBox.jss?boxid=HeaderSearchTextBox\u0026btnid=HeaderSearchButton\u0026pgArea=header\u0026brand=Msdn\u0026loc=en-us\u0026focusOnInit=false\u0026emptyWatermark=true\u0026searchButtonTooltip=Search MSDN" },
- { url: "https://i2-msdn.sec.s-msft.com/Combined.js?resources=0:PrintExportButton,1:Toc_Fixed,1:CodeSnippet,1:TopicNotInScope,1:CollapsibleArea,1:VersionSelector,1:SurveyBroker;/Areas/Library/Themes/Base/Content:0,/Areas/Epx/Content/Scripts:1\u0026amp;hashKey=80F30894E3FB8A3295C923AEC7019CFE\u0026amp;v=AE608271C0243AAA0449D3BC0FAD8EB4" },
- { txt: "$(document).ready(function() {\n try {\n var token = $(\"#globalRequestVerification input[name=\u0027__RequestVerificationToken\u0027]\").clone();\n $(\"#siteFeedbackForm\").append(token);\n } catch(err) {\n \n }\n });" }
- ]);
- /*]]>*/
- </script>
- <link rel="stylesheet" type="text/css" href="./Windows Kernel Development Articles (2016-03-30)_files/Combined.css">
- <div id="page">
-
-
-
-
- <link type="text/css" rel="stylesheet">
-
- <input type="hidden" id="isHeaderBleeding" value="true">
- <div id="ux-header" dir="ltr" class="ltr msdn">
-
- <header>
- <span id="singleCol"></span>
- <span id="doubleCol"></span>
- <span id="isMobile"></span>
- <div>
- <div class="row topRow">
- <div class="top">
- <div class="left">
- <a class="msdnLogoImg" href="https://msdn.microsoft.com/en-us" title="MSDN home">
- <div id="msft-logo" class="msft-logo"></div>
- </a>
- <div class="GrayPipe"></div>
- <a class="DevCenterFullNameNonMegaBlade" href="https://msdn.microsoft.com/en-us">Developer Network</a>
- <a class="DevCenterFullName" href="https://msdn.microsoft.com/en-us">Developer Network</a>
- <a class="DevCenterShortName" href="https://msdn.microsoft.com/en-us">Developer</a>
- </div>
- <div class="right">
- <div id="signIn">
- <div class="profileImage"></div>
- <a class="scarabLink" href="https://login.live.com/login.srf?wa=wsignin1.0&rpsnv=12&ct=1459376418&rver=6.0.5276.0&wp=mcmbi&wlcxt=msdn%24msdn%24msdn&wreply=https%3a%2f%2fmsdn.microsoft.com%2fen-us%2flibrary%2fff554721%2528d%3dprinter%2cv%3dvs.85%2529.aspx%3flan%3dcsharp%26cc%3dn%26trm%3dtra%26view%3dbook&lc=1033&id=254354&mkt=en-us" title="Sign in">Sign in</a></div>
- <div class="auxNav">
- <div>
- <div data-fragmentname="Subscriptions" id="Fragment_Subscriptions" xmlns="http://www.w3.org/1999/xhtml">
- <a href="https://msdn.microsoft.com/subscriptions/manage/hh442900" id="Subscriptions_2153_1" xmlns="http://www.w3.org/1999/xhtml">MSDN subscriptions</a>
- </div>
- <div data-fragmentname="GetTools" id="Fragment_GetTools" xmlns="http://www.w3.org/1999/xhtml">
- <a href="http://go.microsoft.com/fwlink/?LinkId=309297&clcid=0x409&slcid=0x409&campaign=o~msft~msdn~gettools-header~dn308572" id="GetTools_2153_3" xmlns="http://www.w3.org/1999/xhtml">Get tools</a>
- </div>
- </div>
- <div>
- <div data-fragmentname="SocialLinks" id="Fragment_SocialLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <ul class="links horizontal">
- <li>
- <a href="http://www.facebook.com/microsoftdeveloper" target="_blank" id="SocialLinks_2152_4" class="facebook" xmlns="http://www.w3.org/1999/xhtml">http://www.facebook.com/microsoftdeveloper</a>
- </li>
- <li>
- <a href="https://twitter.com/msdev" target="_blank" id="SocialLinks_2152_5" class="twitter" xmlns="http://www.w3.org/1999/xhtml">https://twitter.com/msdev</a>
- </li>
- <li>
- <a href="http://plus.google.com/111221966647232053570/" target="_blank" id="SocialLinks_2152_6" class="googlePlus" xmlns="http://www.w3.org/1999/xhtml">http://plus.google.com/111221966647232053570/</a>
- </li>
- </ul>
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- <div class="row middleRow">
- <div class="expandTop">
- <div class="left"></div>
- <div class="right"></div>
- </div>
- </div>
- </div>
- <div id="buttomRowWrapper" class="bg_default">
- <div class="row buttomRow bg_default">
- <div class="bottom">
- <div class="left">
- <a id="grip" class="menu-icon" href="javascript:void(0)"></a>
-
- <div id="drawer">
- <div class="toc">
-
- <nav>
- <ul class="navL1">
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Technologies">Technologies</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/cloud-app-development-msdn" title="Cloud">Cloud</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/app-development-msdn" title="App Development">App Development</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/web-app-development-msdn" title="Web">Web</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/big-data-development-msdn" title="Data">Data</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/games-development-msdn" title="Gaming">Gaming</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/internetofthings" title="Internet of Things">Internet of Things</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Downloads">Downloads</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://www.visualstudio.com/downloads/download-visual-studio-vs" title="Visual Studio">Visual Studio</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/subscriptions" title="MSDN subscription access">MSDN subscription access</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/microsoft-sdks-msdn" title="SDKs">SDKs</a>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Trial software">Trial software</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/evalcenter" title="Free downloads">Free downloads</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/officeevaluationresources" title="Office resources">Office resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/sharepoint2013resources" title="SharePoint Server 2013 resources">SharePoint Server 2013 resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/sqlserver2014expressresources" title="SQL Server 2014 Express resources">SQL Server 2014 Express resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/windowsserver2012r2resources" title="Windows Server 2012 resources">Windows Server 2012 resources</a>
- </li>
- </ul>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Programs">Programs</a>
- <ul class="navL2">
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Visual Studio subscriptions">Visual Studio subscriptions</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/msdn-subscriptions-overview" title="Overview">Overview</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/benefits-overview" title="Benefits">Benefits</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/msdn-subscriptions-administration" title="Administrators">Administrators</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Students">Students</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/imagine/imagine-home" title="Microsoft Imagine">Microsoft Imagine</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/microsoftstudentpartners" title="Microsoft Student Partners">Microsoft Student Partners</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Architects">Architects</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-overview-msdn" title="Overview">Overview</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-case-studies-msdn" title="Case studies">Case studies</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-blueprints-msdn" title="Blueprints">Blueprints</a>
- </li>
- <li class="inactive">
- <a href="http://blogs.msdn.com/b/msarchitecture/" title="Blog">Blog</a>
- </li>
- <li class="inactive">
- <a href="http://social.msdn.microsoft.com/forums/en-us/home?brandignore=true&sort=relevancedesc&searchterm=architecture+or+architect" title="Forums">Forums</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/applicationbuilder" title="ISV">ISV</a>
-
- </li>
- <li class="inactive">
- <a href="https://www.microsoft.com/bizspark" title="Startups">Startups</a>
-
- </li>
- <li class="inactive">
- <a href="https://rewards.msdn.microsoft.com/" title="TechRewards">TechRewards</a>
-
- </li>
- <li class="inactive">
- <a href="http://events.msdn.microsoft.com/" title="Events">Events</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Community">Community</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/magazine/dd767791" title="Magazine">Magazine</a>
-
- </li>
- <li class="inactive">
- <a href="https://social.msdn.microsoft.com/forums/" title="Forums">Forums</a>
-
- </li>
- <li class="inactive">
- <a href="http://blogs.msdn.com/b/developer-tools/" title="Blogs">Blogs</a>
-
- </li>
- <li class="inactive">
- <a href="http://tech-advisors.msdn.microsoft.com/en-us" title="Tech Advisors">Tech Advisors</a>
-
- </li>
- <li class="inactive">
- <a href="http://channel9.msdn.com/" title="Channel 9">Channel 9</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive current toggle">
- <a href="javascript:void(0)" title="Documentation">Documentation</a>
- <ul class="navL2">
- <li class="inactive current">
- <a href="https://msdn.microsoft.com/library" title="APIs and reference">APIs and reference</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/developer-centers-msdn" title="Dev centers">Dev centers</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive">
- <a href="https://code.msdn.microsoft.com/" title="Samples">Samples</a>
- </li>
- </ul>
- </nav>
- </div>
- </div>
- </div>
- <div class="right">
- <div data-fragmentname="SearchBox" id="Fragment_SearchBox" xmlns="http://www.w3.org/1999/xhtml">
- <div class="SearchBox">
- <form id="HeaderSearchForm" name="HeaderSearchForm" method="get">
- <button id="FakeHeaderSearchButton" value="Search" type="submit" class="header-search-button">
- <div id="search-finder" class="search-finder"></div>
- </button>
- <button id="HeaderSearchButton" style="display:none"></button>
- <div id="searchSplitter"></div>
- <div id="searchCloseIcon" class="search-clear-x"></div>
- <div id="searchTextContainer" style="width: 0;">
- <input id="HeaderSearchTextBox" name="query" type="text" maxlength="200" onfocus="Epx.Controls.SearchBox.watermarkFocus(event, this.title)" onblur="Epx.Controls.SearchBox.watermarkBlur(event, this.title)">
- </div>
- </form>
-
-
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- </header>
- </div>
-
-
-
- <div class="printExportMenus ltr">
- <a id="isd_printABook" href="http://msdn.microsoft.com/en-us/library/export/help/(d=printer)?returnurl=%2fen-us%2flibrary%2fff554721(d%3dprinter,v%3dvs.85).aspx%3flan%3dcsharp%26cc%3dn%26trm%3dtra%26view%3dbook">
- Export (<span class="count">0</span>)
- </a>
- <a id="isd_print" href="https://msdn.microsoft.com/en-us/library/ff554721(d=printer,v=vs.85).aspx?lan=csharp&cc=n&trm=tra&view=book" rel="nofollow">
- Print
- </a>
- <a id="isd_archiveControl" style="display:none;" data-include-archive="Include Previous Version" data-exclude-archive="Exclude Previous Version">
- </a>
- </div>
-
- <div class="printExportMenus ltr">
- <a id="expandCollapseAll" accesskey="e" href="javascript:void(0)" title="Expand/Collapse all sections by pressing Ctrl + Shift + e">Expand All</a>
- </div>
-
- <div id="body" ms.pgarea="body">
- <span id="tabletView_large"></span>
- <span id="tabletView_small"></span>
- <span id="mobileView"></span>
-
- <div id="content" class="content">
- <input type="hidden" id="printForPab" value="true">
-
- <div class="topic" xmlns="http://www.w3.org/1999/xhtml">
- <h1 class="title">Device nodes and device stacks</h1>
-
- <div id="mainSection">
- <div class="clsServerSDKContent">
- </div>
- <p>
- </p><p>In Windows, devices are represented by device nodes in the Plug and Play (PnP) device tree. Typically, when an I/O request is sent to a device, several drivers help handle the request. Each of these drivers is associated with a device object, and the device objects are arranged in a stack. The sequence of device objects along with their associated drivers is called a device stack. Each device node has its own device stack.</p>
- <h2><a id="Device_nodes_and_the_Plug_and_Play_device_tree"></a><a id="device_nodes_and_the_plug_and_play_device_tree"></a><a id="DEVICE_NODES_AND_THE_PLUG_AND_PLAY_DEVICE_TREE"></a>Device nodes and the Plug and Play device tree</h2>
- <p>Windows organizes devices in a tree structure called the <em>Plug and Play device tree</em>, or simply the <em>device tree</em>. Typically, a node in the device tree represents either a device or an individual function on a composite device. However, some nodes represent software components that have no association with physical devices.</p>
- <p>A node in the device tree is called a <em>device node</em>. The root node of the device tree is called the <em>root device node</em>. By convention, the root device node is drawn at the bottom of the device tree, as shown in the following diagram. </p><img id="DeviceTree01" alt="Diagram of the device tree, showing device nodes" src="./Windows Kernel Development Articles (2016-03-30)_files/IC559043.png" title="Diagram of the device tree, showing device nodes" xmlns=""><p>The device tree illustrates the parent/child relationships that are inherent in the PnP environment. Several of the nodes in the device tree represent buses that have child devices connected to them. For example, the PCI Bus node represents the physical PCI bus on the motherboard. During startup, the PnP manager asks the PCI bus driver to enumerate the devices that are connected to the PCI bus. Those devices are represented by child nodes of the PCI Bus node. In the preceding diagram, the PCI Bus node has child nodes for several devices that are connected to the PCI bus, including USB host controllers, an audio controller, and a PCI Express port.</p>
- <p>Some of the devices connected to the PCI bus are buses themselves. The PnP manager asks each of these buses to enumerate the devices that are connected to it. In the preceding diagram, we can see that the audio controller is a bus that has an audio device connected to it. We can see that the PCI Express port is a bus that has a display adapter connected to it, and the display adapter is a bus that has one monitor connected to it.</p>
- <p>Whether you think of a node as representing a device or a bus depends on your point of view. For example, you can think of the display adapter as a device that plays a key role in preparing frames that appear on the screen. However, you can also think of the display adapter as a bus that is capable of detecting and enumerating connected monitors. </p>
- <h2><a id="Device_objects_and_device_stacks"></a><a id="device_objects_and_device_stacks"></a><a id="DEVICE_OBJECTS_AND_DEVICE_STACKS"></a>Device objects and device stacks</h2>
- <p>A <em>device object</em> is an instance of a <a href="https://msdn.microsoft.com/en-us/library/ff543147(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">DEVICE_OBJECT</strong></a> structure. Each device node in the PnP device tree has an ordered list of device objects, and each of these device objects is associated with a driver. The ordered list of device objects, along with their associated drivers, is called the <em>device stack</em> for the device node.</p>
- <p>You can think of a device stack in several ways. In the most formal sense, a device stack is an ordered list of (device object, driver) pairs. However, in certain contexts it might be useful to think of the device stack as an ordered list of device objects. In other contexts, it might be useful to think of the device stack as an ordered list of drivers.</p>
- <p>By convention, a device stack has a top and a bottom. The first device object to be created in the device stack is at the bottom, and the last device object to be created and attached to the device stack is at the top.</p>
- <p>In the following diagram, the Proseware Gizmo device node has a device stack that contains three (device object, driver) pairs. The top device object is associated with the driver AfterThought.sys, the middle device object is associated with the driver Proseware.sys, and the bottom device object is associated with the driver Pci.sys. The PCI Bus node in the center of the diagram has a device stack that contains two (device object, driver) pairs--a device object associated with Pci.sys and a device object associated with Acpi.sys.</p><img id="prosewaredevicenode01" alt="Diagram showing device objects ordered in device stacks in the Proseware Gizmo and PCI device nodes" src="./Windows Kernel Development Articles (2016-03-30)_files/IC535098.png" title="Diagram showing device objects ordered in device stacks in the Proseware Gizmo and PCI device nodes" xmlns=""><h2><a id="How_does_a_device_stack_get_constructed_"></a><a id="how_does_a_device_stack_get_constructed_"></a><a id="HOW_DOES_A_DEVICE_STACK_GET_CONSTRUCTED_"></a>How does a device stack get constructed?</h2>
- <p>During startup, the PnP manager asks the driver for each bus to enumerate child devices that are connected to the bus. For example, the PnP manager asks the PCI bus driver (Pci.sys) to enumerate the devices that are connected to the PCI bus. In response to this request, Pci.sys creates a device object for each device that is connected to the PCI bus. Each of these device objects is called a <em>physical device object</em> (PDO). Shortly after Pci.sys creates the set of PDOs, the device tree looks like the one shown in the following diagram.</p><img id="prosewaredevicenode04" alt="Diagram of PCI node and physical device objects for child devices" src="./Windows Kernel Development Articles (2016-03-30)_files/IC559044.png" title="Diagram of PCI node and physical device objects for child devices" xmlns=""><p>The PnP manager associates a device node with each newly created PDO and looks in the registry to determine which drivers need to be part of the device stack for the node. The device stack must have one (and only one) <em>function driver</em> and can optionally have one or more <em>filter drivers</em>. The function driver is the main driver for the device stack and is responsible for handling read, write, and device control requests. Filter drivers play auxiliary roles in processing read, write, and device control requests. As each function and filter driver is loaded, it creates a device object and attaches itself to the device stack. A device object created by the function driver is called a <em>functional device object</em> (FDO), and a device object created by a filter driver is called a <em>filter device object</em> (Filter DO). Now the device tree looks something like this diagram.</p><img id="prosewaredevicenode02" alt="Diagram of a device tree showing the filter, function, and physical device objects in the Proseware Gizmo device node" src="./Windows Kernel Development Articles (2016-03-30)_files/IC559045.png" title="Diagram of a device tree showing the filter, function, and physical device objects in the Proseware Gizmo device node" xmlns=""><p>In the diagram, notice that in one node, the filter driver is above the function driver, and in the other node, the filter driver is below the function driver. A filter driver that is above the function driver in a device stack is called an <em>upper filter driver</em>. A filter driver that is below the function driver is called a <em>lower filter driver</em>.</p>
- <p>The PDO is always the bottom device object in a device stack. This results from the way a device stack is constructed. The PDO is created first, and as additional device objects are attached to the stack, they are attached to the top of the existing stack.</p>
- <div class="alert"><strong>Note</strong> <p class="note">When the drivers for a device are installed, the installer uses information in an information (INF) file to determine which driver is the function driver and which drivers are filters. Typically the INF file is provided either by Microsoft or by the hardware vendor. After the drivers for a device are installed, the PnP manager can determine the function and filter drivers for the device by looking in the registry.</p>
- <p class="note"></p>
- </div>
- <div> </div>
- <h2><a id="Bus_drivers"></a><a id="bus_drivers"></a><a id="BUS_DRIVERS"></a>Bus drivers</h2>
- <p>In the preceding diagram, you can see that the driver Pci.sys plays two roles. First, Pci.sys is associated with the FDO in the PCI Bus device node. In fact, it created the FDO in the PCI Bus device node. So Pci.sys is the function driver for the PCI bus. Second, Pci.sys is associated with the PDO in each child of the PCI Bus node. Recall that it created the PDOs for the child devices. The driver that creates the PDO for a device node is called the <em>bus driver</em> for the node.</p>
- <p>If your point of reference is the PCI bus, then Pci.sys is the function driver. But if your point of reference is the Proseware Gizmo device, then Pci.sys is the bus driver. This dual role is typical in the PnP device tree. A driver that serves as function driver for a bus also serves as bus driver for a child device of the bus.</p>
- <h2><a id="User-mode_device_stacks"></a><a id="user-mode_device_stacks"></a><a id="USER-MODE_DEVICE_STACKS"></a>User-mode device stacks</h2>
- <p>So far we've been discussing kernel-mode device stacks. That is, the drivers in the stacks run in kernel mode, and the device objects are mapped into system space, which is the address space that is available only to code running in kernel mode. For information about the difference between kernel mode and user mode, see <a href="https://msdn.microsoft.com/en-us/library/ff554836(v=vs.85).aspx">User mode and kernel mode</a>.</p>
- <p>In some cases, a device has a user-mode device stack in addition to its kernel-mode device stack. User-mode drivers are often based on the User-Mode Driver Framework (UMDF), which is one of the driver models provided by the <a href="https://msdn.microsoft.com/en-us/library/ff557565(v=vs.85).aspx">Windows Driver Frameworks (WDF)</a>. In UMDF, the drivers are user-mode DLLs, and the device objects are COM objects that implement the <a href="https://msdn.microsoft.com/en-us/library/ff556917(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">IWDFDevice</strong></a> interface. A device object in a UMDF device stack is called a <em>WDF device object</em> (WDF DO).</p>
- <p>The following diagram shows the device node, kernel-mode device stack, and the user-mode device stack for a USB-FX-2 device. The drivers in both the user-mode and kernel-mode stacks participate in I/O requests that are directed at the USB-FX-2 device.</p><img id="UserAndKernelDeviceStacks01" alt="Diagram showing user-mode and kernel-mode device stacks" src="./Windows Kernel Development Articles (2016-03-30)_files/IC535101.png" title="Diagram showing user-mode and kernel-mode device stacks" xmlns=""><h2><a id="related_topics"></a>Related topics</h2>
- <dl>
- <dt>
- <a href="https://msdn.microsoft.com/en-us/library/ff554731(v=vs.85).aspx">Concepts for all driver developers</a>
- </dt>
- <dt>
- <a href="https://msdn.microsoft.com/en-us/library/hh439632(v=vs.85).aspx">Driver stacks</a>
- </dt>
- </dl>
- <p> </p>
- <p> </p>
- <p><a href="mailto:wsddocfb@microsoft.com?subject=Documentation%20feedback%20[wdkgetstart\wdkgetstart]:%20Device%20nodes%20and%20device%20stacks%20%20RELEASE:%20(3/4/2016)&body=%0A%0APRIVACY%20STATEMENT%0A%0AWe%20use%20your%20feedback%20to%20improve%20the%20documentation.%20We%20don%27t%20use%20your%20email%20address%20for%20any%20other%20purpose,%20and%20we%27ll%20remove%20your%20email%20address%20from%20our%20system%20after%20the%20issue%20that%20you%27re%20reporting%20is%20fixed.%20While%20we%27re%20working%20to%20fix%20this%20issue,%20we%20might%20send%20you%20an%20email%20message%20to%20ask%20for%20more%20info.%20Later,%20we%20might%20also%20send%20you%20an%20email%20message%20to%20let%20you%20know%20that%20we%27ve%20addressed%20your%20feedback.%0A%0AFor%20more%20info%20about%20Microsoft%27s%20privacy%20policy,%20see%20http://privacy.microsoft.com/en-us/default.aspx." title="Send comments about this topic to Microsoft">Send comments about this topic to Microsoft</a></p>
- </div>
- </div>
-
- </div>
- </div>
- <div class="clear"></div>
-
- <input name="__RequestVerificationToken" type="hidden" value="1qOJfzuR_p7gXH73v8KxXqhgkt-wp4O1Hagt5QWbtAXo_D3o-pznD8XW_qPbrUB6QhrE5rvqHvEOI2Cj1pZA9lHusK81">
- <input id="ratingValueSubmitUrl" type="hidden" value="https://msdn.microsoft.com/en-us/library/feedback/rate/ff554721(d=printer,v=vs.85).aspx">
- <input id="ratingAdditionalSubmitUrl" type="hidden" value="https://msdn.microsoft.com/en-us/library/feedback/additional/ff554721(d=printer,v=vs.85).aspx">
- <input id="isTopicRated" type="hidden" value="false">
- <div id="lib-footer" ms.pgarea="body">
-
-
- <link type="text/css" rel="stylesheet">
-
- <div id="ux-footer" class="" style="" dir="ltr">
-
- <div id="footerSock" class="librarySock both">
- <div id="footerSockInner">
- <a name="feedback"></a>
- <div class="rating">
- <div id="ratingSection1">
- <div class="title">
- Was this page helpful?
- </div>
- <div class="description">
- Your feedback about this content is important.<br>Let us know what you think.
- </div>
- <div class="buttons">
- <button class="button" id="ratingYes" aria-label="Yes, this page was helpful">Yes</button>
- <button class="button" id="ratingNo" aria-label="No, this page was not helpful">No</button>
- </div>
- <input id="ratingValue" type="hidden" value="">
- </div>
- <div id="ratingSection2">
- <div class="title left">
- Additional feedback?
- </div>
- <textarea id="ratingText" rows="6" cols="" maxlength="1500"></textarea>
- <div class="right">
- <div class="counter">
- <span id="feedbackTextCounter">1500</span> characters remaining
- </div>
- <div class="buttons">
- <button class="button" id="ratingSubmit" aria-label="Submit my additional feedback">Submit</button>
- <button class="button" id="ratingSkipThis" aria-label="Skip additional feedback">Skip this</button>
- </div>
- </div>
- </div>
- <div id="ratingSection3">
- <div class="title">
- Thank you!
- </div>
- <div class="description">
- We appreciate your feedback.
- </div>
- </div>
-
-
- <div id="contentFeedbackQAContainer" style="display: none;"></div>
- </div>
-
- <div class="userVoice">
- <div class="title">
- Help us improve MSDN.
- </div>
- <div class="description">
- Visit our UserVoice Page to submit and vote on ideas!
- </div>
- <div class="buttons">
- <a class="button" id="userVoiceButton" href="http://feedback.msdn.com/forums/257782-msdn-feature-suggestions/category/83975" target="_blank">Make a suggestion</a>
- </div>
- </div>
- <div class="clear"></div>
- </div>
- </div>
- <footer class="top">
- <div data-fragmentname="LeftLinks" id="Fragment_LeftLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Dev centers</div>
- <ul class="links">
- <li>
- <a href="https://dev.windows.com/" id="LeftLinks_2148_1" class="windowsBlue" xmlns="http://www.w3.org/1999/xhtml">Windows</a>
- </li>
- <li>
- <a href="http://dev.office.com/" id="LeftLinks_2148_3" class="office" xmlns="http://www.w3.org/1999/xhtml">Office</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/vstudio" id="LeftLinks_2148_4" class="visualStudio" xmlns="http://www.w3.org/1999/xhtml">Visual Studio</a>
- </li>
- <li>
- <a href="http://azure.microsoft.com/en-us/documentation/" target="_blank" id="LeftLinks_2148_12" xmlns="http://www.w3.org/1999/xhtml">Microsoft Azure</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/developer-centers-msdn" id="LeftLinks_2148_5" xmlns="http://www.w3.org/1999/xhtml">More...</a>
- </li>
- </ul>
- </div>
- </div>
- <div id="rightLinks">
- <div data-fragmentname="CenterLinks1" id="Fragment_CenterLinks1" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Learning resources</div>
- <ul class="links">
- <li>
- <a href="http://www.microsoftvirtualacademy.com/" id="CenterLinks1_2151_4" xmlns="http://www.w3.org/1999/xhtml">Microsoft Virtual Academy</a>
- </li>
- <li>
- <a href="http://channel9.msdn.com/" id="CenterLinks1_2151_5" xmlns="http://www.w3.org/1999/xhtml">Channel 9</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/magazine/" id="CenterLinks1_2151_7" xmlns="http://www.w3.org/1999/xhtml">MSDN Magazine</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks2" id="Fragment_CenterLinks2" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Community</div>
- <ul class="links">
- <li>
- <a href="https://social.msdn.microsoft.com/forums/en-us/home" id="CenterLinks2_2151_8" xmlns="http://www.w3.org/1999/xhtml">Forums</a>
- </li>
- <li>
- <a href="http://blogs.msdn.com/b/developer-tools/" id="CenterLinks2_2151_9" xmlns="http://www.w3.org/1999/xhtml">Blogs</a>
- </li>
- <li>
- <a href="http://www.codeplex.com/" id="CenterLinks2_2151_10" xmlns="http://www.w3.org/1999/xhtml">Codeplex</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks3" id="Fragment_CenterLinks3" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Support</div>
- <ul class="links">
- <li>
- <a href="https://msdn.microsoft.com/hh361695" id="CenterLinks3_2151_11" xmlns="http://www.w3.org/1999/xhtml">Self support</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks4" id="Fragment_CenterLinks4" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Programs</div>
- <ul class="links">
- <li>
- <a href="https://www.microsoft.com/bizspark/" id="CenterLinks4_2151_13" xmlns="http://www.w3.org/1999/xhtml">BizSpark (for startups)</a>
- </li>
- <li>
- <a href="https://www.dreamspark.com/" id="CenterLinks4_2151_14" xmlns="http://www.w3.org/1999/xhtml">DreamSpark</a>
- </li>
- <li>
- <a href="http://www.imaginecup.com/" id="CenterLinks4_2151_17" xmlns="http://www.w3.org/1999/xhtml">Imagine Cup</a>
- </li>
- </ul>
- </div>
- </div>
- </div>
- </footer>
- <footer class="bottom">
- <span class="localeContainer">
-
- <form class="selectLocale" id="selectLocaleForm" action="https://msdn.microsoft.com/en-us/selectlocale-dmc">
- <input type="hidden" name="fromPage" value="https%3a%2f%2fmsdn.microsoft.com%2fen-us%2flibrary%2fff554721(d%3dprinter%2cv%3dvs.85).aspx%3flan%3dCSharp%26cc%3dn%26trm%3dtra%26view%3dbook">
- <a href="http://msdn.microsoft.com/#" onclick="$('#selectLocaleForm').submit();return false;" title="Change your language">United States (English)</a>
- </form>
- </span>
- <div data-fragmentname="BottomLinks" id="Fragment_BottomLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <ul class="links horizontal">
- <li>
- <a href="https://msdn.microsoft.com/newsletter.aspx" id="BottomLinks_2148_7" xmlns="http://www.w3.org/1999/xhtml">Newsletter</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/dn529288" id="BottomLinks_2148_8" xmlns="http://www.w3.org/1999/xhtml">Privacy & cookies</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/cc300389" id="BottomLinks_2148_9" xmlns="http://www.w3.org/1999/xhtml">Terms of use</a>
- </li>
- <li>
- <a href="https://www.microsoft.com/en-us/legal/intellectualproperty/Trademarks/EN-US.aspx" id="BottomLinks_2148_10" xmlns="http://www.w3.org/1999/xhtml">Trademarks</a>
- </li>
- </ul>
- </div>
- </div>
- <span class="logoLegal">
- <span class="logo"></span>
- <span class="copyright">© 2016 Microsoft</span>
- </span>
- </footer>
- </div>
-
- </div>
- <div class="footerPrintView">
- <div class="footerCopyrightPrintView">© 2016 Microsoft</div>
- </div>
-
-
-
-
- <input id="tocPaddingPerLevel" type="hidden" value="17">
- <input id="MtpsDevice" type="hidden" value="Printer">
- <!--[CDATA[ Third party scripts and code linked to or referenced from this website are licensed to you by the parties that own such code, not by Microsoft. See ASP.NET Ajax CDN Terms of Use – http://www.asp.net/ajaxlibrary/CDN.ashx. ]]-->
-
-
-
-
-
- <noscript><div><img alt="DCSIMG" id="Img1" width="1" height="1" src="https://m.webtrends.com/dcsmgru7m99k7mqmgrhudo0k8_8c6m/njs.gif?dcsuri=/nojavascript&amp;WT.js=No" /></div></noscript>
- <div id="globalRequestVerification">
- <input name="__RequestVerificationToken" type="hidden" value="CKbxvcOcjlV_jeS5Kn4Ogtv1fQHuO9uOZvG-aKBA5-WQxvXocW30LK8RANjr63BqkXYvgjjvi1UsmdbCqIM3Dps-e7I1">
- </div>
- </div>
-
-
-
-
-
-
- <script type="text/javascript" class="mtps-injected">
- /*<![CDATA[*/
- (function(window,document){"use strict";function preload(scripts){for(var result=[],script,e,i=0;i<scripts.length;i++)script=scripts[i],script.hasOwnProperty("url")&&(e=document.createElement("script"),e.src=script.url,script.throwaway=e),result.push(script);return result}function inject(scripts,index){var script,elem;if(index>=scripts.length){delete mtps.injectScripts;return}script=scripts[index];elem=document.createElement("script");elem.className="mtps-injected";elem.async=!1;var isLoaded=!1,timeoutId=0,injectNextFnName="",injectNext=elem.onerror=function(){isLoaded||(isLoaded=!0,inject(scripts,index+1),window.clearTimeout(timeoutId),elem.onload=elem.onerror=elem.onreadystatechange=null,injectNextFnName&&delete mtps[injectNextFnName],elem.removeEventListener&&elem.removeEventListener("load",injectNext,!1))};elem.addEventListener?elem.addEventListener("load",injectNext,!1):elem.readyState==="uninitialized"?elem.onreadystatechange=function(){(this.readyState==="loaded"||this.readyState==="complete")&&injectNext()}:elem.onload=injectNext;script.hasOwnProperty("url")?(timeoutId=window.setTimeout(injectNext,12e4),elem.src=script.url):(injectNextFnName="_injectNextScript_"+index,mtps[injectNextFnName]=injectNext,timeoutId=window.setTimeout(injectNext,2e3),elem.text="try {\n"+script.txt+"\n} finally { MTPS."+injectNextFnName+" && MTPS."+injectNextFnName+"(); }");parent.appendChild(elem)}var mtps=window.MTPS||(window.MTPS={}),parent=document.getElementsByTagName("head")[0];mtps.injectScripts=function(scripts){inject(preload(scripts),0)}})(window,document);
- MTPS.injectScripts([
- { txt: "/**/\r\n(window.MTPS || (window.MTPS = {})).cdnDomains || (window.MTPS.cdnDomains = { \r\n\t\"image\": \"https://i-msdn.sec.s-msft.com\", \r\n\t\"js\": \"https://i2-msdn.sec.s-msft.com\", \r\n\t\"css\": \"https://i-msdn.sec.s-msft.com\", \r\n\t\"ttf\": \"https://i-msdn.sec.s-msft.com\"\r\n});\r\n/**/" },
- { txt: "//\n var literalNormalizedUrl = \u0027/en-us/library/ff554721(d=printer,l=en-us,v=vs.85).aspx\u0027;\n var wt_nvr_ru = \u0027WT_NVR_RU\u0027;\n var wt_fpcdom = \u0027.microsoft.com\u0027;\n var wt_domlist = \u0027msdn.microsoft.com\u0027;\n var wt_pathlist = \u0027\u0027;\n var wt_paramlist = \u0027DCSext.mtps_devcenter\u0027;\n var wt_siteid = \u0027MSDN\u0027;\n var gDomain = \u0027m.webtrends.com\u0027;\n var gDcsId = \u0027dcsmgru7m99k7mqmgrhudo0k8_8c6m\u0027;\n var gFpc = \u0027WT_FPC\u0027;\n\n\n\n if (document.cookie.indexOf(gFpc + \"=\") == -1) {\n var wtidJs = document.createElement(\"script\");\n wtidJs.src = \"//\" + gDomain + \"/\" + gDcsId + \"/wtid.js\";\n document.getElementsByTagName(\"head\")[0].appendChild(wtidJs);\n }\n\n\n\n var detectedLocale = \u0027en-us\u0027;\n var wtsp = \u0027msdnlib_w32_com\u0027;\n var gTrackEvents = \u00270\u0027;\n/**/" },
- { txt: "//\n\n window.appInsightsId = \u00275eb1b2eb-c47a-497a-a7ac-a1c230b2882f\u0027;\n //" },
- { url: "https://i2-msdn.sec.s-msft.com/Combined.js?resources=0:Utilities,1:Layout,2:Header,1:Rating,2:Footer,0:Topic,3:PabTopic,4:webtrendsscript,0:AppInsightsPerf,0:ABTestControl,5:WEDCS,3:CmpgrpForHeader,0:livefyre,0:Comment,1:SearchBox;/Areas/Epx/Content/Scripts:0,/Areas/Epx/Themes/Base/Content:1,/Areas/Centers/Themes/StandardDevCenter/Content:2,/Areas/Library/Content:3,/Areas/Global/Content/Webtrends/resources:4,/Areas/Library/Themes/Base/Content:5\u0026amp;hashKey=30CEE944AABFEA2C5A338BDB9E000732\u0026amp;v=AE608271C0243AAA0449D3BC0FAD8EB4" },
- { url: "https://i1.services.social.microsoft.com/search/Widgets/SearchBox.jss?boxid=HeaderSearchTextBox\u0026btnid=HeaderSearchButton\u0026pgArea=header\u0026brand=Msdn\u0026loc=en-us\u0026focusOnInit=false\u0026emptyWatermark=true\u0026searchButtonTooltip=Search MSDN" },
- { url: "https://i2-msdn.sec.s-msft.com/Combined.js?resources=0:PrintExportButton,1:Toc_Fixed,1:CodeSnippet,1:TopicNotInScope,1:CollapsibleArea,1:VersionSelector,1:SurveyBroker;/Areas/Library/Themes/Base/Content:0,/Areas/Epx/Content/Scripts:1\u0026amp;hashKey=80F30894E3FB8A3295C923AEC7019CFE\u0026amp;v=AE608271C0243AAA0449D3BC0FAD8EB4" },
- { txt: "$(document).ready(function() {\n try {\n var token = $(\"#globalRequestVerification input[name=\u0027__RequestVerificationToken\u0027]\").clone();\n $(\"#siteFeedbackForm\").append(token);\n } catch(err) {\n \n }\n });" }
- ]);
- /*]]>*/
- </script>
- <link rel="stylesheet" type="text/css" href="./Windows Kernel Development Articles (2016-03-30)_files/Combined.css">
- <div id="page">
-
-
-
-
- <link type="text/css" rel="stylesheet">
-
- <input type="hidden" id="isHeaderBleeding" value="true">
- <div id="ux-header" dir="ltr" class="ltr msdn">
-
- <header>
- <span id="singleCol"></span>
- <span id="doubleCol"></span>
- <span id="isMobile"></span>
- <div>
- <div class="row topRow">
- <div class="top">
- <div class="left">
- <a class="msdnLogoImg" href="https://msdn.microsoft.com/en-us" title="MSDN home">
- <div id="msft-logo" class="msft-logo"></div>
- </a>
- <div class="GrayPipe"></div>
- <a class="DevCenterFullNameNonMegaBlade" href="https://msdn.microsoft.com/en-us">Developer Network</a>
- <a class="DevCenterFullName" href="https://msdn.microsoft.com/en-us">Developer Network</a>
- <a class="DevCenterShortName" href="https://msdn.microsoft.com/en-us">Developer</a>
- </div>
- <div class="right">
- <div id="signIn">
- <div class="profileImage"></div>
- <a class="scarabLink" href="https://login.live.com/login.srf?wa=wsignin1.0&rpsnv=12&ct=1459376419&rver=6.0.5276.0&wp=mcmbi&wlcxt=msdn%24msdn%24msdn&wreply=https%3a%2f%2fmsdn.microsoft.com%2fen-us%2flibrary%2fhh439638%2528d%3dprinter%2cv%3dvs.85%2529.aspx%3flan%3dcsharp%26cc%3dn%26trm%3dtra%26view%3dbook&lc=1033&id=254354&mkt=en-us" title="Sign in">Sign in</a></div>
- <div class="auxNav">
- <div>
- <div data-fragmentname="Subscriptions" id="Fragment_Subscriptions" xmlns="http://www.w3.org/1999/xhtml">
- <a href="https://msdn.microsoft.com/subscriptions/manage/hh442900" id="Subscriptions_2153_1" xmlns="http://www.w3.org/1999/xhtml">MSDN subscriptions</a>
- </div>
- <div data-fragmentname="GetTools" id="Fragment_GetTools" xmlns="http://www.w3.org/1999/xhtml">
- <a href="http://go.microsoft.com/fwlink/?LinkId=309297&clcid=0x409&slcid=0x409&campaign=o~msft~msdn~gettools-header~dn308572" id="GetTools_2153_3" xmlns="http://www.w3.org/1999/xhtml">Get tools</a>
- </div>
- </div>
- <div>
- <div data-fragmentname="SocialLinks" id="Fragment_SocialLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <ul class="links horizontal">
- <li>
- <a href="http://www.facebook.com/microsoftdeveloper" target="_blank" id="SocialLinks_2152_4" class="facebook" xmlns="http://www.w3.org/1999/xhtml">http://www.facebook.com/microsoftdeveloper</a>
- </li>
- <li>
- <a href="https://twitter.com/msdev" target="_blank" id="SocialLinks_2152_5" class="twitter" xmlns="http://www.w3.org/1999/xhtml">https://twitter.com/msdev</a>
- </li>
- <li>
- <a href="http://plus.google.com/111221966647232053570/" target="_blank" id="SocialLinks_2152_6" class="googlePlus" xmlns="http://www.w3.org/1999/xhtml">http://plus.google.com/111221966647232053570/</a>
- </li>
- </ul>
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- <div class="row middleRow">
- <div class="expandTop">
- <div class="left"></div>
- <div class="right"></div>
- </div>
- </div>
- </div>
- <div id="buttomRowWrapper" class="bg_default">
- <div class="row buttomRow bg_default">
- <div class="bottom">
- <div class="left">
- <a id="grip" class="menu-icon" href="javascript:void(0)"></a>
-
- <div id="drawer">
- <div class="toc">
-
- <nav>
- <ul class="navL1">
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Technologies">Technologies</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/cloud-app-development-msdn" title="Cloud">Cloud</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/app-development-msdn" title="App Development">App Development</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/web-app-development-msdn" title="Web">Web</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/big-data-development-msdn" title="Data">Data</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/games-development-msdn" title="Gaming">Gaming</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/internetofthings" title="Internet of Things">Internet of Things</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Downloads">Downloads</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://www.visualstudio.com/downloads/download-visual-studio-vs" title="Visual Studio">Visual Studio</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/subscriptions" title="MSDN subscription access">MSDN subscription access</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/microsoft-sdks-msdn" title="SDKs">SDKs</a>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Trial software">Trial software</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/evalcenter" title="Free downloads">Free downloads</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/officeevaluationresources" title="Office resources">Office resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/sharepoint2013resources" title="SharePoint Server 2013 resources">SharePoint Server 2013 resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/sqlserver2014expressresources" title="SQL Server 2014 Express resources">SQL Server 2014 Express resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/windowsserver2012r2resources" title="Windows Server 2012 resources">Windows Server 2012 resources</a>
- </li>
- </ul>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Programs">Programs</a>
- <ul class="navL2">
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Visual Studio subscriptions">Visual Studio subscriptions</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/msdn-subscriptions-overview" title="Overview">Overview</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/benefits-overview" title="Benefits">Benefits</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/msdn-subscriptions-administration" title="Administrators">Administrators</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Students">Students</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/imagine/imagine-home" title="Microsoft Imagine">Microsoft Imagine</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/microsoftstudentpartners" title="Microsoft Student Partners">Microsoft Student Partners</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Architects">Architects</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-overview-msdn" title="Overview">Overview</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-case-studies-msdn" title="Case studies">Case studies</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-blueprints-msdn" title="Blueprints">Blueprints</a>
- </li>
- <li class="inactive">
- <a href="http://blogs.msdn.com/b/msarchitecture/" title="Blog">Blog</a>
- </li>
- <li class="inactive">
- <a href="http://social.msdn.microsoft.com/forums/en-us/home?brandignore=true&sort=relevancedesc&searchterm=architecture+or+architect" title="Forums">Forums</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/applicationbuilder" title="ISV">ISV</a>
-
- </li>
- <li class="inactive">
- <a href="https://www.microsoft.com/bizspark" title="Startups">Startups</a>
-
- </li>
- <li class="inactive">
- <a href="https://rewards.msdn.microsoft.com/" title="TechRewards">TechRewards</a>
-
- </li>
- <li class="inactive">
- <a href="http://events.msdn.microsoft.com/" title="Events">Events</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Community">Community</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/magazine/dd767791" title="Magazine">Magazine</a>
-
- </li>
- <li class="inactive">
- <a href="https://social.msdn.microsoft.com/forums/" title="Forums">Forums</a>
-
- </li>
- <li class="inactive">
- <a href="http://blogs.msdn.com/b/developer-tools/" title="Blogs">Blogs</a>
-
- </li>
- <li class="inactive">
- <a href="http://tech-advisors.msdn.microsoft.com/en-us" title="Tech Advisors">Tech Advisors</a>
-
- </li>
- <li class="inactive">
- <a href="http://channel9.msdn.com/" title="Channel 9">Channel 9</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive current toggle">
- <a href="javascript:void(0)" title="Documentation">Documentation</a>
- <ul class="navL2">
- <li class="inactive current">
- <a href="https://msdn.microsoft.com/library" title="APIs and reference">APIs and reference</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/developer-centers-msdn" title="Dev centers">Dev centers</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive">
- <a href="https://code.msdn.microsoft.com/" title="Samples">Samples</a>
- </li>
- </ul>
- </nav>
- </div>
- </div>
- </div>
- <div class="right">
- <div data-fragmentname="SearchBox" id="Fragment_SearchBox" xmlns="http://www.w3.org/1999/xhtml">
- <div class="SearchBox">
- <form id="HeaderSearchForm" name="HeaderSearchForm" method="get">
- <button id="FakeHeaderSearchButton" value="Search" type="submit" class="header-search-button">
- <div id="search-finder" class="search-finder"></div>
- </button>
- <button id="HeaderSearchButton" style="display:none"></button>
- <div id="searchSplitter"></div>
- <div id="searchCloseIcon" class="search-clear-x"></div>
- <div id="searchTextContainer" style="width: 0;">
- <input id="HeaderSearchTextBox" name="query" type="text" maxlength="200" onfocus="Epx.Controls.SearchBox.watermarkFocus(event, this.title)" onblur="Epx.Controls.SearchBox.watermarkBlur(event, this.title)">
- </div>
- </form>
-
-
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- </header>
- </div>
-
-
-
- <div class="printExportMenus ltr">
- <a id="isd_printABook" href="http://msdn.microsoft.com/en-us/library/export/help/(d=printer)?returnurl=%2fen-us%2flibrary%2fhh439638(d%3dprinter,v%3dvs.85).aspx%3flan%3dcsharp%26cc%3dn%26trm%3dtra%26view%3dbook">
- Export (<span class="count">0</span>)
- </a>
- <a id="isd_print" href="https://msdn.microsoft.com/en-us/library/hh439638(d=printer,v=vs.85).aspx?lan=csharp&cc=n&trm=tra&view=book" rel="nofollow">
- Print
- </a>
- <a id="isd_archiveControl" style="display:none;" data-include-archive="Include Previous Version" data-exclude-archive="Exclude Previous Version">
- </a>
- </div>
-
- <div class="printExportMenus ltr">
- <a id="expandCollapseAll" accesskey="e" href="javascript:void(0)" title="Expand/Collapse all sections by pressing Ctrl + Shift + e">Expand All</a>
- </div>
-
- <div id="body" ms.pgarea="body">
- <span id="tabletView_large"></span>
- <span id="tabletView_small"></span>
- <span id="mobileView"></span>
-
- <div id="content" class="content">
- <input type="hidden" id="printForPab" value="true">
-
- <div class="topic" xmlns="http://www.w3.org/1999/xhtml">
- <h1 class="title">I/O request packets</h1>
-
- <div id="mainSection">
- <div class="clsServerSDKContent">
- </div>
- <p>Most of the requests that are sent to device drivers are packaged in I/O request packets (<a href="https://msdn.microsoft.com/en-us/library/ff550694(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">IRP</strong></a>s). An operating system component or a driver sends an IRP to a driver by calling <a href="https://msdn.microsoft.com/en-us/library/ff548336(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">IoCallDriver</strong></a>, which has two parameters: a pointer to a <a href="https://msdn.microsoft.com/en-us/library/ff543147(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">DEVICE_OBJECT</strong></a> and a pointer to an <strong>IRP</strong>. The <strong>DEVICE_OBJECT</strong> has a pointer to an associated <a href="https://msdn.microsoft.com/en-us/library/ff544174(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">DRIVER_OBJECT</strong></a>. When a component calls <strong>IoCallDriver</strong>, we say the component <em>sends the IRP to the device object</em> or <em>sends the IRP to the driver associated with the device object</em>. Sometimes we use the phrase <em>passes the IRP</em> or <em>forwards the IRP</em> instead of <em>sends the IRP</em>.</p>
- <p>Typically an IRP is processed by several drivers that are arranged in a stack. Each driver in the stack is associated with a device object. For more information, see <a href="https://msdn.microsoft.com/en-us/library/ff554721(v=vs.85).aspx">Device nodes and device stacks</a>. When an <a href="https://msdn.microsoft.com/en-us/library/ff550694(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">IRP</strong></a> is processed by a device stack, the <strong>IRP</strong> is usually sent first to the top device object in the device stack. For example, if an <strong>IRP</strong> is processed by the device stack shown in this diagram, the IRP would be sent first to the filter device object (Filter DO) at the top of the device stack.</p><img id="ProsewareDeviceNode03" alt="Diagram of a device node and its device stack" src="./Windows Kernel Development Articles (2016-03-30)_files/IC535107.png" title="Diagram of a device node and its device stack" xmlns=""><h2><a id="Passing_an_IRP_down_the_device_stack"></a><a id="passing_an_irp_down_the_device_stack"></a><a id="PASSING_AN_IRP_DOWN_THE_DEVICE_STACK"></a>Passing an IRP down the device stack</h2>
- <p>Suppose the I/O manager sends an IRP to the Filter DO in the diagram. The driver associated with the Filter DO, AfterThought.sys, processes the IRP and then passes it to the functional device object (FDO), which is the next lower device object in the device stack. When a driver passes an IRP to the next lower device object in the device stack, we say the driver <em>passes the IRP down the device stack</em>.</p>
- <p>Some IRPs are passed all the way down the device stack to the physical device object (PDO). Other IRPs never reach the PDO because they are completed by one of the drivers above the PDO.</p>
- <h2><a id="IRPs_are_self-contained"></a><a id="irps_are_self-contained"></a><a id="IRPS_ARE_SELF-CONTAINED"></a>IRPs are self-contained</h2>
- <p>The IRP structure is self-contained in the sense that it holds all of the information that a driver needs to handle an I/0 request. Some parts of the IRP structure hold information that is common to all of the participating drivers in the stack. Other parts of the IRP hold information that is specific to a particular driver in the stack.</p>
- <p> </p>
- <p> </p>
- <p><a href="mailto:wsddocfb@microsoft.com?subject=Documentation%20feedback%20[wdkgetstart\wdkgetstart]:%20I/O%20request%20packets%20%20RELEASE:%20(3/4/2016)&body=%0A%0APRIVACY%20STATEMENT%0A%0AWe%20use%20your%20feedback%20to%20improve%20the%20documentation.%20We%20don%27t%20use%20your%20email%20address%20for%20any%20other%20purpose,%20and%20we%27ll%20remove%20your%20email%20address%20from%20our%20system%20after%20the%20issue%20that%20you%27re%20reporting%20is%20fixed.%20While%20we%27re%20working%20to%20fix%20this%20issue,%20we%20might%20send%20you%20an%20email%20message%20to%20ask%20for%20more%20info.%20Later,%20we%20might%20also%20send%20you%20an%20email%20message%20to%20let%20you%20know%20that%20we%27ve%20addressed%20your%20feedback.%0A%0AFor%20more%20info%20about%20Microsoft%27s%20privacy%20policy,%20see%20http://privacy.microsoft.com/en-us/default.aspx." title="Send comments about this topic to Microsoft">Send comments about this topic to Microsoft</a></p>
- </div>
- </div>
-
- </div>
- </div>
- <div class="clear"></div>
-
- <input name="__RequestVerificationToken" type="hidden" value="LY4IxpW1pXWXDUR8NpG7eXWr2z_tMU4CHHmEUdwDqo9c9BJ746Nxf8KI6gWUkVD2nLxqx-mrssPJIcbJx3uM0bm-BOE1">
- <input id="ratingValueSubmitUrl" type="hidden" value="https://msdn.microsoft.com/en-us/library/feedback/rate/hh439638(d=printer,v=vs.85).aspx">
- <input id="ratingAdditionalSubmitUrl" type="hidden" value="https://msdn.microsoft.com/en-us/library/feedback/additional/hh439638(d=printer,v=vs.85).aspx">
- <input id="isTopicRated" type="hidden" value="false">
- <div id="lib-footer" ms.pgarea="body">
-
-
- <link type="text/css" rel="stylesheet">
-
- <div id="ux-footer" class="" style="" dir="ltr">
-
- <div id="footerSock" class="librarySock both">
- <div id="footerSockInner">
- <a name="feedback"></a>
- <div class="rating">
- <div id="ratingSection1">
- <div class="title">
- Was this page helpful?
- </div>
- <div class="description">
- Your feedback about this content is important.<br>Let us know what you think.
- </div>
- <div class="buttons">
- <button class="button" id="ratingYes" aria-label="Yes, this page was helpful">Yes</button>
- <button class="button" id="ratingNo" aria-label="No, this page was not helpful">No</button>
- </div>
- <input id="ratingValue" type="hidden" value="">
- </div>
- <div id="ratingSection2">
- <div class="title left">
- Additional feedback?
- </div>
- <textarea id="ratingText" rows="6" cols="" maxlength="1500"></textarea>
- <div class="right">
- <div class="counter">
- <span id="feedbackTextCounter">1500</span> characters remaining
- </div>
- <div class="buttons">
- <button class="button" id="ratingSubmit" aria-label="Submit my additional feedback">Submit</button>
- <button class="button" id="ratingSkipThis" aria-label="Skip additional feedback">Skip this</button>
- </div>
- </div>
- </div>
- <div id="ratingSection3">
- <div class="title">
- Thank you!
- </div>
- <div class="description">
- We appreciate your feedback.
- </div>
- </div>
-
-
- <div id="contentFeedbackQAContainer" style="display: none;"></div>
- </div>
-
- <div class="userVoice">
- <div class="title">
- Help us improve MSDN.
- </div>
- <div class="description">
- Visit our UserVoice Page to submit and vote on ideas!
- </div>
- <div class="buttons">
- <a class="button" id="userVoiceButton" href="http://feedback.msdn.com/forums/257782-msdn-feature-suggestions/category/83975" target="_blank">Make a suggestion</a>
- </div>
- </div>
- <div class="clear"></div>
- </div>
- </div>
- <footer class="top">
- <div data-fragmentname="LeftLinks" id="Fragment_LeftLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Dev centers</div>
- <ul class="links">
- <li>
- <a href="https://dev.windows.com/" id="LeftLinks_2148_1" class="windowsBlue" xmlns="http://www.w3.org/1999/xhtml">Windows</a>
- </li>
- <li>
- <a href="http://dev.office.com/" id="LeftLinks_2148_3" class="office" xmlns="http://www.w3.org/1999/xhtml">Office</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/vstudio" id="LeftLinks_2148_4" class="visualStudio" xmlns="http://www.w3.org/1999/xhtml">Visual Studio</a>
- </li>
- <li>
- <a href="http://azure.microsoft.com/en-us/documentation/" target="_blank" id="LeftLinks_2148_12" xmlns="http://www.w3.org/1999/xhtml">Microsoft Azure</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/developer-centers-msdn" id="LeftLinks_2148_5" xmlns="http://www.w3.org/1999/xhtml">More...</a>
- </li>
- </ul>
- </div>
- </div>
- <div id="rightLinks">
- <div data-fragmentname="CenterLinks1" id="Fragment_CenterLinks1" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Learning resources</div>
- <ul class="links">
- <li>
- <a href="http://www.microsoftvirtualacademy.com/" id="CenterLinks1_2151_4" xmlns="http://www.w3.org/1999/xhtml">Microsoft Virtual Academy</a>
- </li>
- <li>
- <a href="http://channel9.msdn.com/" id="CenterLinks1_2151_5" xmlns="http://www.w3.org/1999/xhtml">Channel 9</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/magazine/" id="CenterLinks1_2151_7" xmlns="http://www.w3.org/1999/xhtml">MSDN Magazine</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks2" id="Fragment_CenterLinks2" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Community</div>
- <ul class="links">
- <li>
- <a href="https://social.msdn.microsoft.com/forums/en-us/home" id="CenterLinks2_2151_8" xmlns="http://www.w3.org/1999/xhtml">Forums</a>
- </li>
- <li>
- <a href="http://blogs.msdn.com/b/developer-tools/" id="CenterLinks2_2151_9" xmlns="http://www.w3.org/1999/xhtml">Blogs</a>
- </li>
- <li>
- <a href="http://www.codeplex.com/" id="CenterLinks2_2151_10" xmlns="http://www.w3.org/1999/xhtml">Codeplex</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks3" id="Fragment_CenterLinks3" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Support</div>
- <ul class="links">
- <li>
- <a href="https://msdn.microsoft.com/hh361695" id="CenterLinks3_2151_11" xmlns="http://www.w3.org/1999/xhtml">Self support</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks4" id="Fragment_CenterLinks4" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Programs</div>
- <ul class="links">
- <li>
- <a href="https://www.microsoft.com/bizspark/" id="CenterLinks4_2151_13" xmlns="http://www.w3.org/1999/xhtml">BizSpark (for startups)</a>
- </li>
- <li>
- <a href="https://www.dreamspark.com/" id="CenterLinks4_2151_14" xmlns="http://www.w3.org/1999/xhtml">DreamSpark</a>
- </li>
- <li>
- <a href="http://www.imaginecup.com/" id="CenterLinks4_2151_17" xmlns="http://www.w3.org/1999/xhtml">Imagine Cup</a>
- </li>
- </ul>
- </div>
- </div>
- </div>
- </footer>
- <footer class="bottom">
- <span class="localeContainer">
-
- <form class="selectLocale" id="selectLocaleForm" action="https://msdn.microsoft.com/en-us/selectlocale-dmc">
- <input type="hidden" name="fromPage" value="https%3a%2f%2fmsdn.microsoft.com%2fen-us%2flibrary%2fhh439638(d%3dprinter%2cv%3dvs.85).aspx%3flan%3dCSharp%26cc%3dn%26trm%3dtra%26view%3dbook">
- <a href="http://msdn.microsoft.com/#" onclick="$('#selectLocaleForm').submit();return false;" title="Change your language">United States (English)</a>
- </form>
- </span>
- <div data-fragmentname="BottomLinks" id="Fragment_BottomLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <ul class="links horizontal">
- <li>
- <a href="https://msdn.microsoft.com/newsletter.aspx" id="BottomLinks_2148_7" xmlns="http://www.w3.org/1999/xhtml">Newsletter</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/dn529288" id="BottomLinks_2148_8" xmlns="http://www.w3.org/1999/xhtml">Privacy & cookies</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/cc300389" id="BottomLinks_2148_9" xmlns="http://www.w3.org/1999/xhtml">Terms of use</a>
- </li>
- <li>
- <a href="https://www.microsoft.com/en-us/legal/intellectualproperty/Trademarks/EN-US.aspx" id="BottomLinks_2148_10" xmlns="http://www.w3.org/1999/xhtml">Trademarks</a>
- </li>
- </ul>
- </div>
- </div>
- <span class="logoLegal">
- <span class="logo"></span>
- <span class="copyright">© 2016 Microsoft</span>
- </span>
- </footer>
- </div>
-
- </div>
- <div class="footerPrintView">
- <div class="footerCopyrightPrintView">© 2016 Microsoft</div>
- </div>
-
-
-
-
- <input id="tocPaddingPerLevel" type="hidden" value="17">
- <input id="MtpsDevice" type="hidden" value="Printer">
- <!--[CDATA[ Third party scripts and code linked to or referenced from this website are licensed to you by the parties that own such code, not by Microsoft. See ASP.NET Ajax CDN Terms of Use – http://www.asp.net/ajaxlibrary/CDN.ashx. ]]-->
-
-
-
-
-
- <noscript><div><img alt="DCSIMG" id="Img1" width="1" height="1" src="https://m.webtrends.com/dcsmgru7m99k7mqmgrhudo0k8_8c6m/njs.gif?dcsuri=/nojavascript&amp;WT.js=No" /></div></noscript>
- <div id="globalRequestVerification">
- <input name="__RequestVerificationToken" type="hidden" value="n086H7wEOLoDBhbrgBbvkuMiUUUEynFzyQllS5F8kS38wzzIsOT0rEJ_L-NlOf_vyR6cuaNSRnf7IWcqpzNJ7tISe101">
- </div>
- </div>
-
-
-
-
-
-
- <script type="text/javascript" class="mtps-injected">
- /*<![CDATA[*/
- (function(window,document){"use strict";function preload(scripts){for(var result=[],script,e,i=0;i<scripts.length;i++)script=scripts[i],script.hasOwnProperty("url")&&(e=document.createElement("script"),e.src=script.url,script.throwaway=e),result.push(script);return result}function inject(scripts,index){var script,elem;if(index>=scripts.length){delete mtps.injectScripts;return}script=scripts[index];elem=document.createElement("script");elem.className="mtps-injected";elem.async=!1;var isLoaded=!1,timeoutId=0,injectNextFnName="",injectNext=elem.onerror=function(){isLoaded||(isLoaded=!0,inject(scripts,index+1),window.clearTimeout(timeoutId),elem.onload=elem.onerror=elem.onreadystatechange=null,injectNextFnName&&delete mtps[injectNextFnName],elem.removeEventListener&&elem.removeEventListener("load",injectNext,!1))};elem.addEventListener?elem.addEventListener("load",injectNext,!1):elem.readyState==="uninitialized"?elem.onreadystatechange=function(){(this.readyState==="loaded"||this.readyState==="complete")&&injectNext()}:elem.onload=injectNext;script.hasOwnProperty("url")?(timeoutId=window.setTimeout(injectNext,12e4),elem.src=script.url):(injectNextFnName="_injectNextScript_"+index,mtps[injectNextFnName]=injectNext,timeoutId=window.setTimeout(injectNext,2e3),elem.text="try {\n"+script.txt+"\n} finally { MTPS."+injectNextFnName+" && MTPS."+injectNextFnName+"(); }");parent.appendChild(elem)}var mtps=window.MTPS||(window.MTPS={}),parent=document.getElementsByTagName("head")[0];mtps.injectScripts=function(scripts){inject(preload(scripts),0)}})(window,document);
- MTPS.injectScripts([
- { txt: "/**/\r\n(window.MTPS || (window.MTPS = {})).cdnDomains || (window.MTPS.cdnDomains = { \r\n\t\"image\": \"https://i-msdn.sec.s-msft.com\", \r\n\t\"js\": \"https://i2-msdn.sec.s-msft.com\", \r\n\t\"css\": \"https://i-msdn.sec.s-msft.com\", \r\n\t\"ttf\": \"https://i-msdn.sec.s-msft.com\"\r\n});\r\n/**/" },
- { txt: "//\n var literalNormalizedUrl = \u0027/en-us/library/hh439638(d=printer,l=en-us,v=vs.85).aspx\u0027;\n var wt_nvr_ru = \u0027WT_NVR_RU\u0027;\n var wt_fpcdom = \u0027.microsoft.com\u0027;\n var wt_domlist = \u0027msdn.microsoft.com\u0027;\n var wt_pathlist = \u0027\u0027;\n var wt_paramlist = \u0027DCSext.mtps_devcenter\u0027;\n var wt_siteid = \u0027MSDN\u0027;\n var gDomain = \u0027m.webtrends.com\u0027;\n var gDcsId = \u0027dcsmgru7m99k7mqmgrhudo0k8_8c6m\u0027;\n var gFpc = \u0027WT_FPC\u0027;\n\n\n\n if (document.cookie.indexOf(gFpc + \"=\") == -1) {\n var wtidJs = document.createElement(\"script\");\n wtidJs.src = \"//\" + gDomain + \"/\" + gDcsId + \"/wtid.js\";\n document.getElementsByTagName(\"head\")[0].appendChild(wtidJs);\n }\n\n\n\n var detectedLocale = \u0027en-us\u0027;\n var wtsp = \u0027msdnlib_w32_com\u0027;\n var gTrackEvents = \u00270\u0027;\n/**/" },
- { txt: "//\n\n window.appInsightsId = \u00275eb1b2eb-c47a-497a-a7ac-a1c230b2882f\u0027;\n //" },
- { url: "https://i2-msdn.sec.s-msft.com/Combined.js?resources=0:Utilities,1:Layout,2:Header,1:Rating,2:Footer,0:Topic,3:PabTopic,4:webtrendsscript,0:AppInsightsPerf,0:ABTestControl,5:WEDCS,3:CmpgrpForHeader,0:livefyre,0:Comment,1:SearchBox;/Areas/Epx/Content/Scripts:0,/Areas/Epx/Themes/Base/Content:1,/Areas/Centers/Themes/StandardDevCenter/Content:2,/Areas/Library/Content:3,/Areas/Global/Content/Webtrends/resources:4,/Areas/Library/Themes/Base/Content:5\u0026amp;hashKey=30CEE944AABFEA2C5A338BDB9E000732\u0026amp;v=AE608271C0243AAA0449D3BC0FAD8EB4" },
- { url: "https://i1.services.social.microsoft.com/search/Widgets/SearchBox.jss?boxid=HeaderSearchTextBox\u0026btnid=HeaderSearchButton\u0026pgArea=header\u0026brand=Msdn\u0026loc=en-us\u0026focusOnInit=false\u0026emptyWatermark=true\u0026searchButtonTooltip=Search MSDN" },
- { url: "https://i2-msdn.sec.s-msft.com/Combined.js?resources=0:PrintExportButton,1:Toc_Fixed,1:CodeSnippet,1:TopicNotInScope,1:CollapsibleArea,1:VersionSelector,1:SurveyBroker;/Areas/Library/Themes/Base/Content:0,/Areas/Epx/Content/Scripts:1\u0026amp;hashKey=80F30894E3FB8A3295C923AEC7019CFE\u0026amp;v=AE608271C0243AAA0449D3BC0FAD8EB4" },
- { txt: "$(document).ready(function() {\n try {\n var token = $(\"#globalRequestVerification input[name=\u0027__RequestVerificationToken\u0027]\").clone();\n $(\"#siteFeedbackForm\").append(token);\n } catch(err) {\n \n }\n });" }
- ]);
- /*]]>*/
- </script>
- <link rel="stylesheet" type="text/css" href="./Windows Kernel Development Articles (2016-03-30)_files/Combined.css">
- <div id="page">
-
-
-
-
- <link type="text/css" rel="stylesheet">
-
- <input type="hidden" id="isHeaderBleeding" value="true">
- <div id="ux-header" dir="ltr" class="ltr msdn">
-
- <header>
- <span id="singleCol"></span>
- <span id="doubleCol"></span>
- <span id="isMobile"></span>
- <div>
- <div class="row topRow">
- <div class="top">
- <div class="left">
- <a class="msdnLogoImg" href="https://msdn.microsoft.com/en-us" title="MSDN home">
- <div id="msft-logo" class="msft-logo"></div>
- </a>
- <div class="GrayPipe"></div>
- <a class="DevCenterFullNameNonMegaBlade" href="https://msdn.microsoft.com/en-us">Developer Network</a>
- <a class="DevCenterFullName" href="https://msdn.microsoft.com/en-us">Developer Network</a>
- <a class="DevCenterShortName" href="https://msdn.microsoft.com/en-us">Developer</a>
- </div>
- <div class="right">
- <div id="signIn">
- <div class="profileImage"></div>
- <a class="scarabLink" href="https://login.live.com/login.srf?wa=wsignin1.0&rpsnv=12&ct=1459376419&rver=6.0.5276.0&wp=mcmbi&wlcxt=msdn%24msdn%24msdn&wreply=https%3a%2f%2fmsdn.microsoft.com%2fen-us%2flibrary%2fhh439632%2528d%3dprinter%2cv%3dvs.85%2529.aspx%3flan%3dcsharp%26cc%3dn%26trm%3dtra%26view%3dbook&lc=1033&id=254354&mkt=en-us" title="Sign in">Sign in</a></div>
- <div class="auxNav">
- <div>
- <div data-fragmentname="Subscriptions" id="Fragment_Subscriptions" xmlns="http://www.w3.org/1999/xhtml">
- <a href="https://msdn.microsoft.com/subscriptions/manage/hh442900" id="Subscriptions_2153_1" xmlns="http://www.w3.org/1999/xhtml">MSDN subscriptions</a>
- </div>
- <div data-fragmentname="GetTools" id="Fragment_GetTools" xmlns="http://www.w3.org/1999/xhtml">
- <a href="http://go.microsoft.com/fwlink/?LinkId=309297&clcid=0x409&slcid=0x409&campaign=o~msft~msdn~gettools-header~dn308572" id="GetTools_2153_3" xmlns="http://www.w3.org/1999/xhtml">Get tools</a>
- </div>
- </div>
- <div>
- <div data-fragmentname="SocialLinks" id="Fragment_SocialLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <ul class="links horizontal">
- <li>
- <a href="http://www.facebook.com/microsoftdeveloper" target="_blank" id="SocialLinks_2152_4" class="facebook" xmlns="http://www.w3.org/1999/xhtml">http://www.facebook.com/microsoftdeveloper</a>
- </li>
- <li>
- <a href="https://twitter.com/msdev" target="_blank" id="SocialLinks_2152_5" class="twitter" xmlns="http://www.w3.org/1999/xhtml">https://twitter.com/msdev</a>
- </li>
- <li>
- <a href="http://plus.google.com/111221966647232053570/" target="_blank" id="SocialLinks_2152_6" class="googlePlus" xmlns="http://www.w3.org/1999/xhtml">http://plus.google.com/111221966647232053570/</a>
- </li>
- </ul>
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- <div class="row middleRow">
- <div class="expandTop">
- <div class="left"></div>
- <div class="right"></div>
- </div>
- </div>
- </div>
- <div id="buttomRowWrapper" class="bg_default">
- <div class="row buttomRow bg_default">
- <div class="bottom">
- <div class="left">
- <a id="grip" class="menu-icon" href="javascript:void(0)"></a>
-
- <div id="drawer">
- <div class="toc">
-
- <nav>
- <ul class="navL1">
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Technologies">Technologies</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/cloud-app-development-msdn" title="Cloud">Cloud</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/app-development-msdn" title="App Development">App Development</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/web-app-development-msdn" title="Web">Web</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/big-data-development-msdn" title="Data">Data</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/games-development-msdn" title="Gaming">Gaming</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/internetofthings" title="Internet of Things">Internet of Things</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Downloads">Downloads</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://www.visualstudio.com/downloads/download-visual-studio-vs" title="Visual Studio">Visual Studio</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/subscriptions" title="MSDN subscription access">MSDN subscription access</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/microsoft-sdks-msdn" title="SDKs">SDKs</a>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Trial software">Trial software</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/evalcenter" title="Free downloads">Free downloads</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/officeevaluationresources" title="Office resources">Office resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/sharepoint2013resources" title="SharePoint Server 2013 resources">SharePoint Server 2013 resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/sqlserver2014expressresources" title="SQL Server 2014 Express resources">SQL Server 2014 Express resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/windowsserver2012r2resources" title="Windows Server 2012 resources">Windows Server 2012 resources</a>
- </li>
- </ul>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Programs">Programs</a>
- <ul class="navL2">
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Visual Studio subscriptions">Visual Studio subscriptions</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/msdn-subscriptions-overview" title="Overview">Overview</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/benefits-overview" title="Benefits">Benefits</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/msdn-subscriptions-administration" title="Administrators">Administrators</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Students">Students</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/imagine/imagine-home" title="Microsoft Imagine">Microsoft Imagine</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/microsoftstudentpartners" title="Microsoft Student Partners">Microsoft Student Partners</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Architects">Architects</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-overview-msdn" title="Overview">Overview</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-case-studies-msdn" title="Case studies">Case studies</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-blueprints-msdn" title="Blueprints">Blueprints</a>
- </li>
- <li class="inactive">
- <a href="http://blogs.msdn.com/b/msarchitecture/" title="Blog">Blog</a>
- </li>
- <li class="inactive">
- <a href="http://social.msdn.microsoft.com/forums/en-us/home?brandignore=true&sort=relevancedesc&searchterm=architecture+or+architect" title="Forums">Forums</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/applicationbuilder" title="ISV">ISV</a>
-
- </li>
- <li class="inactive">
- <a href="https://www.microsoft.com/bizspark" title="Startups">Startups</a>
-
- </li>
- <li class="inactive">
- <a href="https://rewards.msdn.microsoft.com/" title="TechRewards">TechRewards</a>
-
- </li>
- <li class="inactive">
- <a href="http://events.msdn.microsoft.com/" title="Events">Events</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Community">Community</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/magazine/dd767791" title="Magazine">Magazine</a>
-
- </li>
- <li class="inactive">
- <a href="https://social.msdn.microsoft.com/forums/" title="Forums">Forums</a>
-
- </li>
- <li class="inactive">
- <a href="http://blogs.msdn.com/b/developer-tools/" title="Blogs">Blogs</a>
-
- </li>
- <li class="inactive">
- <a href="http://tech-advisors.msdn.microsoft.com/en-us" title="Tech Advisors">Tech Advisors</a>
-
- </li>
- <li class="inactive">
- <a href="http://channel9.msdn.com/" title="Channel 9">Channel 9</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive current toggle">
- <a href="javascript:void(0)" title="Documentation">Documentation</a>
- <ul class="navL2">
- <li class="inactive current">
- <a href="https://msdn.microsoft.com/library" title="APIs and reference">APIs and reference</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/developer-centers-msdn" title="Dev centers">Dev centers</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive">
- <a href="https://code.msdn.microsoft.com/" title="Samples">Samples</a>
- </li>
- </ul>
- </nav>
- </div>
- </div>
- </div>
- <div class="right">
- <div data-fragmentname="SearchBox" id="Fragment_SearchBox" xmlns="http://www.w3.org/1999/xhtml">
- <div class="SearchBox">
- <form id="HeaderSearchForm" name="HeaderSearchForm" method="get">
- <button id="FakeHeaderSearchButton" value="Search" type="submit" class="header-search-button">
- <div id="search-finder" class="search-finder"></div>
- </button>
- <button id="HeaderSearchButton" style="display:none"></button>
- <div id="searchSplitter"></div>
- <div id="searchCloseIcon" class="search-clear-x"></div>
- <div id="searchTextContainer" style="width: 0;">
- <input id="HeaderSearchTextBox" name="query" type="text" maxlength="200" onfocus="Epx.Controls.SearchBox.watermarkFocus(event, this.title)" onblur="Epx.Controls.SearchBox.watermarkBlur(event, this.title)">
- </div>
- </form>
-
-
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- </header>
- </div>
-
-
-
- <div class="printExportMenus ltr">
- <a id="isd_printABook" href="http://msdn.microsoft.com/en-us/library/export/help/(d=printer)?returnurl=%2fen-us%2flibrary%2fhh439632(d%3dprinter,v%3dvs.85).aspx%3flan%3dcsharp%26cc%3dn%26trm%3dtra%26view%3dbook">
- Export (<span class="count">0</span>)
- </a>
- <a id="isd_print" href="https://msdn.microsoft.com/en-us/library/hh439632(d=printer,v=vs.85).aspx?lan=csharp&cc=n&trm=tra&view=book" rel="nofollow">
- Print
- </a>
- <a id="isd_archiveControl" style="display:none;" data-include-archive="Include Previous Version" data-exclude-archive="Exclude Previous Version">
- </a>
- </div>
-
- <div class="printExportMenus ltr">
- <a id="expandCollapseAll" accesskey="e" href="javascript:void(0)" title="Expand/Collapse all sections by pressing Ctrl + Shift + e">Expand All</a>
- </div>
-
- <div id="body" ms.pgarea="body">
- <span id="tabletView_large"></span>
- <span id="tabletView_small"></span>
- <span id="mobileView"></span>
-
- <div id="content" class="content">
- <input type="hidden" id="printForPab" value="true">
-
- <div class="topic" xmlns="http://www.w3.org/1999/xhtml">
- <h1 class="title">Driver stacks</h1>
-
- <div id="mainSection">
- <div class="clsServerSDKContent">
- </div>
- <p>
- </p><p>Most of the requests that are sent to device drivers are packaged in <a href="https://msdn.microsoft.com/en-us/library/hh439638(v=vs.85).aspx">I/O request packets</a> (IRPs). Each device is represented by a device node, and each device node has a device stack. For more information, see <a href="https://msdn.microsoft.com/en-us/library/ff554721(v=vs.85).aspx">Device nodes and device stacks</a>. To send a read, write, or control request to a device, the I/O manager locates the device node for the device and then sends an IRP to the device stack of that node. Sometimes more than one device stack is involved in processing an I/O request. Regardless of how many device stacks are involved, the overall sequence of drivers that participate in an I/O request is called the <em>driver stack</em> for the request. We also use the term <em>driver stack</em> to refer to the layered set of drivers for a particular technology.</p>
- <h2><a id="I_O_requests_that_are_processed_by_several_device_stacks"></a><a id="i_o_requests_that_are_processed_by_several_device_stacks"></a><a id="I_O_REQUESTS_THAT_ARE_PROCESSED_BY_SEVERAL_DEVICE_STACKS"></a>I/O requests that are processed by several device stacks</h2>
- <p>In some cases, more than one device stack is involved in processing an IRP. The following diagram illustrates a case where four device stacks are involved in processing a single IRP. </p><img id="Chain01" alt="Diagram of four device nodes, each with a device stack" src="./Windows Kernel Development Articles (2016-03-30)_files/IC596026.png" title="Diagram of four device nodes, each with a device stack" xmlns=""><p>Here is how the IRP is processed at each numbered stage in the diagram:</p>
- <ol>
- <li>
- <p>The IRP is created by Disk.sys, which is the function driver in the device stack for the My USB Storage Device node. Disk.sys passes the IRP down the device stack to Usbstor.sys.</p>
- </li>
- <li>Notice that Usbstor.sys is the PDO driver for the My USB Storage Device node and the FDO driver for the USB Mass Storage Device node. At this point, it is not important to decide whether the IRP is owned by the (PDO, Usbstor.sys) pair or the (FDO, Usbstor.sys) pair. The IRP is owned by the driver, Usbstor.sys, and the driver has access to both the PDO and the FDO.</li>
- <li>
- <p>When Usbstor.sys has finished processing the IRP, it passes the IRP to Usbhub.sys. Usbhub.sys is the PDO driver for the USB Mass Storage Device node and the FDO driver for the USB Root Hub node. It is not important to decide whether the IRP is owned by the (PDO, Usbhub.sys) pair or the (FDO, Usbhub.sys) pair. The IRP is owned by the driver, Usbhub.sys, and the driver has access to both the PDO and the FDO.</p>
- </li>
- <li>
- <p>When Usbhub.sys has finished processing the IRP, it passes the IRP to the (Usbuhci.sys, Usbport.sys) pair.</p>
- <p>Usbuhci.sys is a miniport driver, and Usbport.sys is a port driver. The (miniport, port) pair plays the role of a single driver. In this case, both the miniport driver and the port driver are written by Microsoft. The (Usbuhci.sys, Usbport.sys) pair is the PDO driver for the USB Root Hub node, and the (Usbuhci.sys, Usbport.sys) pair is also the FDO driver for the USB Host Controller node. The (Usbuhci.sys, Usbport.sys) pair does the actual communication with the host controller hardware, which in turn communicates with the physical USB storage device.</p>
- </li>
- </ol>
- <h2><a id="The_driver_stack_for_an_I_O_request"></a><a id="the_driver_stack_for_an_i_o_request"></a><a id="THE_DRIVER_STACK_FOR_AN_I_O_REQUEST"></a>The driver stack for an I/O request</h2>
- <p>Consider the sequence of four drivers that participated in the I/O request illustrated in the preceding diagram. We can get another view of the sequence by focusing on the drivers rather than on the device nodes and their individual device stacks. The following diagram shows the drivers in sequence from top to bottom. Notice that Disk.sys is associated with one device object, but each of the other three drivers is associated with two device objects.</p><img id="DriverStack01" alt="Diagram of a driver stack, showing the top driver associated with an FDO only, and the other three drivers associated with a PDO and an FDO" src="./Windows Kernel Development Articles (2016-03-30)_files/IC559047.png" title="Diagram of a driver stack, showing the top driver associated with an FDO only, and the other three drivers associated with a PDO and an FDO" xmlns=""><p>The sequence of drivers that participate in an I/O request is called the <em>driver stack for the I/O request</em>. To illustrate a driver stack for an I/O request, we draw the drivers from top to bottom in the order that they participate in the request.</p>
- <p>Notice that the driver stack for an I/O request is quite different from the device stack for a device node. Also notice that the driver stack for an I/O request does not necessarily remain in one branch of the device tree.</p>
- <h2><a id="Technology_driver_stacks"></a><a id="technology_driver_stacks"></a><a id="TECHNOLOGY_DRIVER_STACKS"></a>Technology driver stacks</h2>
- <p>Consider the driver stack for the I/O request shown in the preceding diagram. If we give each of the drivers a friendly name and make some slight changes to the diagram, we have a block diagram that is similar to many of those that appear in the Windows Driver Kit (WDK) documentation.</p><img id="DriverStack02" alt="Diagram of a driver stack showing friendly names for the drivers: Disk Class Driver on top followed by USB Storage Port Driver, and then USB Hub Driver and (USB 2 Miniport, USB Port) Driver" src="./Windows Kernel Development Articles (2016-03-30)_files/IC559048.png" title="Diagram of a driver stack showing friendly names for the drivers: Disk Class Driver on top followed by USB Storage Port Driver, and then USB Hub Driver and (USB 2 Miniport, USB Port) Driver" xmlns=""><p> In the diagram, the driver stack is divided into three sections. We can think of each section as belonging to a particular technology or to a particular component or portion of the operating system. For example, we might say that the first section at the top of the driver stack belongs to the Volume Manager, the second section belongs to the storage component of the operating system, and the third section belongs to the core USB portion of the operating system.</p>
- <p>Consider the drivers in the third section. These drivers are a subset of a larger set of core USB drivers that Microsoft provides for handling various kinds of USB requests and USB hardware. The following diagram shows what the entire USB core block diagram might look like.</p><img id="TechnologyStack01" alt="Diagram showing the technology driver stack for possible USB core block " src="./Windows Kernel Development Articles (2016-03-30)_files/IC553386.png" title="Diagram showing the technology driver stack for possible USB core block " xmlns=""><p>A block diagram that shows all of the drivers for a particular technology or a particular component or portion of the operating system is called a <em>technology driver stack</em>. Typically, technology driver stacks are given names like the USB Core Driver Stack, the Storage Stack, the 1394 Driver Stack, and the Audio Driver Stack.</p>
- <div class="alert"><strong>Note</strong> The USB core block diagram in this topic shows one of several possible ways to illustrate the technology driver stacks for USB 1.0 and 2.0. For the official diagrams of the USB 1.0, 2.0, and 3.0 driver stacks, see <a href="https://msdn.microsoft.com/en-us/library/hh406256(v=vs.85).aspx">USB Driver Stack Architecture</a>.</div>
- <div> </div>
- <h2><a id="related_topics"></a>Related topics</h2>
- <dl>
- <dt>
- <a href="https://msdn.microsoft.com/en-us/library/ff554721(v=vs.85).aspx">Device nodes and device stacks</a>
- </dt>
- <dt>
- <a href="https://msdn.microsoft.com/en-us/library/hh439643(v=vs.85).aspx">Minidrivers and driver pairs</a>
- </dt>
- <dt>
- <a href="https://msdn.microsoft.com/en-us/library/ff554731(v=vs.85).aspx">Concepts for all driver developers</a>
- </dt>
- </dl>
- <p> </p>
- <p> </p>
- <p><a href="mailto:wsddocfb@microsoft.com?subject=Documentation%20feedback%20[wdkgetstart\wdkgetstart]:%20Driver%20stacks%20%20RELEASE:%20(3/4/2016)&body=%0A%0APRIVACY%20STATEMENT%0A%0AWe%20use%20your%20feedback%20to%20improve%20the%20documentation.%20We%20don%27t%20use%20your%20email%20address%20for%20any%20other%20purpose,%20and%20we%27ll%20remove%20your%20email%20address%20from%20our%20system%20after%20the%20issue%20that%20you%27re%20reporting%20is%20fixed.%20While%20we%27re%20working%20to%20fix%20this%20issue,%20we%20might%20send%20you%20an%20email%20message%20to%20ask%20for%20more%20info.%20Later,%20we%20might%20also%20send%20you%20an%20email%20message%20to%20let%20you%20know%20that%20we%27ve%20addressed%20your%20feedback.%0A%0AFor%20more%20info%20about%20Microsoft%27s%20privacy%20policy,%20see%20http://privacy.microsoft.com/en-us/default.aspx." title="Send comments about this topic to Microsoft">Send comments about this topic to Microsoft</a></p>
- </div>
- </div>
-
- </div>
- </div>
- <div class="clear"></div>
-
- <input name="__RequestVerificationToken" type="hidden" value="2ew3xZD-jD9PVDmC6Wrb2cPbSfqYJOn5Gf905xzdxl8BLbg1NqNy2pPIrj2wWLcwHCevg2LjtwlI4a1UJp8m-qZ-G-M1">
- <input id="ratingValueSubmitUrl" type="hidden" value="https://msdn.microsoft.com/en-us/library/feedback/rate/hh439632(d=printer,v=vs.85).aspx">
- <input id="ratingAdditionalSubmitUrl" type="hidden" value="https://msdn.microsoft.com/en-us/library/feedback/additional/hh439632(d=printer,v=vs.85).aspx">
- <input id="isTopicRated" type="hidden" value="false">
- <div id="lib-footer" ms.pgarea="body">
-
-
- <link type="text/css" rel="stylesheet">
-
- <div id="ux-footer" class="" style="" dir="ltr">
-
- <div id="footerSock" class="librarySock both">
- <div id="footerSockInner">
- <a name="feedback"></a>
- <div class="rating">
- <div id="ratingSection1">
- <div class="title">
- Was this page helpful?
- </div>
- <div class="description">
- Your feedback about this content is important.<br>Let us know what you think.
- </div>
- <div class="buttons">
- <button class="button" id="ratingYes" aria-label="Yes, this page was helpful">Yes</button>
- <button class="button" id="ratingNo" aria-label="No, this page was not helpful">No</button>
- </div>
- <input id="ratingValue" type="hidden" value="">
- </div>
- <div id="ratingSection2">
- <div class="title left">
- Additional feedback?
- </div>
- <textarea id="ratingText" rows="6" cols="" maxlength="1500"></textarea>
- <div class="right">
- <div class="counter">
- <span id="feedbackTextCounter">1500</span> characters remaining
- </div>
- <div class="buttons">
- <button class="button" id="ratingSubmit" aria-label="Submit my additional feedback">Submit</button>
- <button class="button" id="ratingSkipThis" aria-label="Skip additional feedback">Skip this</button>
- </div>
- </div>
- </div>
- <div id="ratingSection3">
- <div class="title">
- Thank you!
- </div>
- <div class="description">
- We appreciate your feedback.
- </div>
- </div>
-
-
- <div id="contentFeedbackQAContainer" style="display: none;"></div>
- </div>
-
- <div class="userVoice">
- <div class="title">
- Help us improve MSDN.
- </div>
- <div class="description">
- Visit our UserVoice Page to submit and vote on ideas!
- </div>
- <div class="buttons">
- <a class="button" id="userVoiceButton" href="http://feedback.msdn.com/forums/257782-msdn-feature-suggestions/category/83975" target="_blank">Make a suggestion</a>
- </div>
- </div>
- <div class="clear"></div>
- </div>
- </div>
- <footer class="top">
- <div data-fragmentname="LeftLinks" id="Fragment_LeftLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Dev centers</div>
- <ul class="links">
- <li>
- <a href="https://dev.windows.com/" id="LeftLinks_2148_1" class="windowsBlue" xmlns="http://www.w3.org/1999/xhtml">Windows</a>
- </li>
- <li>
- <a href="http://dev.office.com/" id="LeftLinks_2148_3" class="office" xmlns="http://www.w3.org/1999/xhtml">Office</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/vstudio" id="LeftLinks_2148_4" class="visualStudio" xmlns="http://www.w3.org/1999/xhtml">Visual Studio</a>
- </li>
- <li>
- <a href="http://azure.microsoft.com/en-us/documentation/" target="_blank" id="LeftLinks_2148_12" xmlns="http://www.w3.org/1999/xhtml">Microsoft Azure</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/developer-centers-msdn" id="LeftLinks_2148_5" xmlns="http://www.w3.org/1999/xhtml">More...</a>
- </li>
- </ul>
- </div>
- </div>
- <div id="rightLinks">
- <div data-fragmentname="CenterLinks1" id="Fragment_CenterLinks1" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Learning resources</div>
- <ul class="links">
- <li>
- <a href="http://www.microsoftvirtualacademy.com/" id="CenterLinks1_2151_4" xmlns="http://www.w3.org/1999/xhtml">Microsoft Virtual Academy</a>
- </li>
- <li>
- <a href="http://channel9.msdn.com/" id="CenterLinks1_2151_5" xmlns="http://www.w3.org/1999/xhtml">Channel 9</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/magazine/" id="CenterLinks1_2151_7" xmlns="http://www.w3.org/1999/xhtml">MSDN Magazine</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks2" id="Fragment_CenterLinks2" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Community</div>
- <ul class="links">
- <li>
- <a href="https://social.msdn.microsoft.com/forums/en-us/home" id="CenterLinks2_2151_8" xmlns="http://www.w3.org/1999/xhtml">Forums</a>
- </li>
- <li>
- <a href="http://blogs.msdn.com/b/developer-tools/" id="CenterLinks2_2151_9" xmlns="http://www.w3.org/1999/xhtml">Blogs</a>
- </li>
- <li>
- <a href="http://www.codeplex.com/" id="CenterLinks2_2151_10" xmlns="http://www.w3.org/1999/xhtml">Codeplex</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks3" id="Fragment_CenterLinks3" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Support</div>
- <ul class="links">
- <li>
- <a href="https://msdn.microsoft.com/hh361695" id="CenterLinks3_2151_11" xmlns="http://www.w3.org/1999/xhtml">Self support</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks4" id="Fragment_CenterLinks4" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Programs</div>
- <ul class="links">
- <li>
- <a href="https://www.microsoft.com/bizspark/" id="CenterLinks4_2151_13" xmlns="http://www.w3.org/1999/xhtml">BizSpark (for startups)</a>
- </li>
- <li>
- <a href="https://www.dreamspark.com/" id="CenterLinks4_2151_14" xmlns="http://www.w3.org/1999/xhtml">DreamSpark</a>
- </li>
- <li>
- <a href="http://www.imaginecup.com/" id="CenterLinks4_2151_17" xmlns="http://www.w3.org/1999/xhtml">Imagine Cup</a>
- </li>
- </ul>
- </div>
- </div>
- </div>
- </footer>
- <footer class="bottom">
- <span class="localeContainer">
-
- <form class="selectLocale" id="selectLocaleForm" action="https://msdn.microsoft.com/en-us/selectlocale-dmc">
- <input type="hidden" name="fromPage" value="https%3a%2f%2fmsdn.microsoft.com%2fen-us%2flibrary%2fhh439632(d%3dprinter%2cv%3dvs.85).aspx%3flan%3dCSharp%26cc%3dn%26trm%3dtra%26view%3dbook">
- <a href="http://msdn.microsoft.com/#" onclick="$('#selectLocaleForm').submit();return false;" title="Change your language">United States (English)</a>
- </form>
- </span>
- <div data-fragmentname="BottomLinks" id="Fragment_BottomLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <ul class="links horizontal">
- <li>
- <a href="https://msdn.microsoft.com/newsletter.aspx" id="BottomLinks_2148_7" xmlns="http://www.w3.org/1999/xhtml">Newsletter</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/dn529288" id="BottomLinks_2148_8" xmlns="http://www.w3.org/1999/xhtml">Privacy & cookies</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/cc300389" id="BottomLinks_2148_9" xmlns="http://www.w3.org/1999/xhtml">Terms of use</a>
- </li>
- <li>
- <a href="https://www.microsoft.com/en-us/legal/intellectualproperty/Trademarks/EN-US.aspx" id="BottomLinks_2148_10" xmlns="http://www.w3.org/1999/xhtml">Trademarks</a>
- </li>
- </ul>
- </div>
- </div>
- <span class="logoLegal">
- <span class="logo"></span>
- <span class="copyright">© 2016 Microsoft</span>
- </span>
- </footer>
- </div>
-
- </div>
- <div class="footerPrintView">
- <div class="footerCopyrightPrintView">© 2016 Microsoft</div>
- </div>
-
-
-
-
- <input id="tocPaddingPerLevel" type="hidden" value="17">
- <input id="MtpsDevice" type="hidden" value="Printer">
- <!--[CDATA[ Third party scripts and code linked to or referenced from this website are licensed to you by the parties that own such code, not by Microsoft. See ASP.NET Ajax CDN Terms of Use – http://www.asp.net/ajaxlibrary/CDN.ashx. ]]-->
-
-
-
-
-
- <noscript><div><img alt="DCSIMG" id="Img1" width="1" height="1" src="https://m.webtrends.com/dcsmgru7m99k7mqmgrhudo0k8_8c6m/njs.gif?dcsuri=/nojavascript&amp;WT.js=No" /></div></noscript>
- <div id="globalRequestVerification">
- <input name="__RequestVerificationToken" type="hidden" value="UcQkAKGIMZEOyqGMzvxecGZdkziiFY9PDrOshPQzDoQkC84vZkvSBzcwJGoceMtkGY9_4eS_nb0u8jx8DDQCbcy0znc1">
- </div>
- </div>
-
-
-
-
-
-
- <script type="text/javascript" class="mtps-injected">
- /*<![CDATA[*/
- (function(window,document){"use strict";function preload(scripts){for(var result=[],script,e,i=0;i<scripts.length;i++)script=scripts[i],script.hasOwnProperty("url")&&(e=document.createElement("script"),e.src=script.url,script.throwaway=e),result.push(script);return result}function inject(scripts,index){var script,elem;if(index>=scripts.length){delete mtps.injectScripts;return}script=scripts[index];elem=document.createElement("script");elem.className="mtps-injected";elem.async=!1;var isLoaded=!1,timeoutId=0,injectNextFnName="",injectNext=elem.onerror=function(){isLoaded||(isLoaded=!0,inject(scripts,index+1),window.clearTimeout(timeoutId),elem.onload=elem.onerror=elem.onreadystatechange=null,injectNextFnName&&delete mtps[injectNextFnName],elem.removeEventListener&&elem.removeEventListener("load",injectNext,!1))};elem.addEventListener?elem.addEventListener("load",injectNext,!1):elem.readyState==="uninitialized"?elem.onreadystatechange=function(){(this.readyState==="loaded"||this.readyState==="complete")&&injectNext()}:elem.onload=injectNext;script.hasOwnProperty("url")?(timeoutId=window.setTimeout(injectNext,12e4),elem.src=script.url):(injectNextFnName="_injectNextScript_"+index,mtps[injectNextFnName]=injectNext,timeoutId=window.setTimeout(injectNext,2e3),elem.text="try {\n"+script.txt+"\n} finally { MTPS."+injectNextFnName+" && MTPS."+injectNextFnName+"(); }");parent.appendChild(elem)}var mtps=window.MTPS||(window.MTPS={}),parent=document.getElementsByTagName("head")[0];mtps.injectScripts=function(scripts){inject(preload(scripts),0)}})(window,document);
- MTPS.injectScripts([
- { txt: "/**/\r\n(window.MTPS || (window.MTPS = {})).cdnDomains || (window.MTPS.cdnDomains = { \r\n\t\"image\": \"https://i-msdn.sec.s-msft.com\", \r\n\t\"js\": \"https://i2-msdn.sec.s-msft.com\", \r\n\t\"css\": \"https://i-msdn.sec.s-msft.com\", \r\n\t\"ttf\": \"https://i-msdn.sec.s-msft.com\"\r\n});\r\n/**/" },
- { txt: "//\n var literalNormalizedUrl = \u0027/en-us/library/hh439632(d=printer,l=en-us,v=vs.85).aspx\u0027;\n var wt_nvr_ru = \u0027WT_NVR_RU\u0027;\n var wt_fpcdom = \u0027.microsoft.com\u0027;\n var wt_domlist = \u0027msdn.microsoft.com\u0027;\n var wt_pathlist = \u0027\u0027;\n var wt_paramlist = \u0027DCSext.mtps_devcenter\u0027;\n var wt_siteid = \u0027MSDN\u0027;\n var gDomain = \u0027m.webtrends.com\u0027;\n var gDcsId = \u0027dcsmgru7m99k7mqmgrhudo0k8_8c6m\u0027;\n var gFpc = \u0027WT_FPC\u0027;\n\n\n\n if (document.cookie.indexOf(gFpc + \"=\") == -1) {\n var wtidJs = document.createElement(\"script\");\n wtidJs.src = \"//\" + gDomain + \"/\" + gDcsId + \"/wtid.js\";\n document.getElementsByTagName(\"head\")[0].appendChild(wtidJs);\n }\n\n\n\n var detectedLocale = \u0027en-us\u0027;\n var wtsp = \u0027msdnlib_w32_com\u0027;\n var gTrackEvents = \u00270\u0027;\n/**/" },
- { txt: "//\n\n window.appInsightsId = \u00275eb1b2eb-c47a-497a-a7ac-a1c230b2882f\u0027;\n //" },
- { url: "https://i2-msdn.sec.s-msft.com/Combined.js?resources=0:Utilities,1:Layout,2:Header,1:Rating,2:Footer,0:Topic,3:PabTopic,4:webtrendsscript,0:AppInsightsPerf,0:ABTestControl,5:WEDCS,3:CmpgrpForHeader,0:livefyre,0:Comment,1:SearchBox;/Areas/Epx/Content/Scripts:0,/Areas/Epx/Themes/Base/Content:1,/Areas/Centers/Themes/StandardDevCenter/Content:2,/Areas/Library/Content:3,/Areas/Global/Content/Webtrends/resources:4,/Areas/Library/Themes/Base/Content:5\u0026amp;hashKey=30CEE944AABFEA2C5A338BDB9E000732\u0026amp;v=AE608271C0243AAA0449D3BC0FAD8EB4" },
- { url: "https://i1.services.social.microsoft.com/search/Widgets/SearchBox.jss?boxid=HeaderSearchTextBox\u0026btnid=HeaderSearchButton\u0026pgArea=header\u0026brand=Msdn\u0026loc=en-us\u0026focusOnInit=false\u0026emptyWatermark=true\u0026searchButtonTooltip=Search MSDN" },
- { url: "https://i2-msdn.sec.s-msft.com/Combined.js?resources=0:PrintExportButton,1:Toc_Fixed,1:CodeSnippet,1:TopicNotInScope,1:CollapsibleArea,1:VersionSelector,1:SurveyBroker;/Areas/Library/Themes/Base/Content:0,/Areas/Epx/Content/Scripts:1\u0026amp;hashKey=80F30894E3FB8A3295C923AEC7019CFE\u0026amp;v=AE608271C0243AAA0449D3BC0FAD8EB4" },
- { txt: "$(document).ready(function() {\n try {\n var token = $(\"#globalRequestVerification input[name=\u0027__RequestVerificationToken\u0027]\").clone();\n $(\"#siteFeedbackForm\").append(token);\n } catch(err) {\n \n }\n });" }
- ]);
- /*]]>*/
- </script>
- <link rel="stylesheet" type="text/css" href="./Windows Kernel Development Articles (2016-03-30)_files/Combined.css">
- <div id="page">
-
-
-
-
- <link type="text/css" rel="stylesheet">
-
- <input type="hidden" id="isHeaderBleeding" value="true">
- <div id="ux-header" dir="ltr" class="ltr msdn">
-
- <header>
- <span id="singleCol"></span>
- <span id="doubleCol"></span>
- <span id="isMobile"></span>
- <div>
- <div class="row topRow">
- <div class="top">
- <div class="left">
- <a class="msdnLogoImg" href="https://msdn.microsoft.com/en-us" title="MSDN home">
- <div id="msft-logo" class="msft-logo"></div>
- </a>
- <div class="GrayPipe"></div>
- <a class="DevCenterFullNameNonMegaBlade" href="https://msdn.microsoft.com/en-us">Developer Network</a>
- <a class="DevCenterFullName" href="https://msdn.microsoft.com/en-us">Developer Network</a>
- <a class="DevCenterShortName" href="https://msdn.microsoft.com/en-us">Developer</a>
- </div>
- <div class="right">
- <div id="signIn">
- <div class="profileImage"></div>
- <a class="scarabLink" href="https://login.live.com/login.srf?wa=wsignin1.0&rpsnv=12&ct=1459376420&rver=6.0.5276.0&wp=mcmbi&wlcxt=msdn%24msdn%24msdn&wreply=https%3a%2f%2fmsdn.microsoft.com%2fen-us%2flibrary%2fhh439643%2528d%3dprinter%2cv%3dvs.85%2529.aspx%3flan%3dcsharp%26cc%3dn%26trm%3dtra%26view%3dbook&lc=1033&id=254354&mkt=en-us" title="Sign in">Sign in</a></div>
- <div class="auxNav">
- <div>
- <div data-fragmentname="Subscriptions" id="Fragment_Subscriptions" xmlns="http://www.w3.org/1999/xhtml">
- <a href="https://msdn.microsoft.com/subscriptions/manage/hh442900" id="Subscriptions_2153_1" xmlns="http://www.w3.org/1999/xhtml">MSDN subscriptions</a>
- </div>
- <div data-fragmentname="GetTools" id="Fragment_GetTools" xmlns="http://www.w3.org/1999/xhtml">
- <a href="http://go.microsoft.com/fwlink/?LinkId=309297&clcid=0x409&slcid=0x409&campaign=o~msft~msdn~gettools-header~dn308572" id="GetTools_2153_3" xmlns="http://www.w3.org/1999/xhtml">Get tools</a>
- </div>
- </div>
- <div>
- <div data-fragmentname="SocialLinks" id="Fragment_SocialLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <ul class="links horizontal">
- <li>
- <a href="http://www.facebook.com/microsoftdeveloper" target="_blank" id="SocialLinks_2152_4" class="facebook" xmlns="http://www.w3.org/1999/xhtml">http://www.facebook.com/microsoftdeveloper</a>
- </li>
- <li>
- <a href="https://twitter.com/msdev" target="_blank" id="SocialLinks_2152_5" class="twitter" xmlns="http://www.w3.org/1999/xhtml">https://twitter.com/msdev</a>
- </li>
- <li>
- <a href="http://plus.google.com/111221966647232053570/" target="_blank" id="SocialLinks_2152_6" class="googlePlus" xmlns="http://www.w3.org/1999/xhtml">http://plus.google.com/111221966647232053570/</a>
- </li>
- </ul>
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- <div class="row middleRow">
- <div class="expandTop">
- <div class="left"></div>
- <div class="right"></div>
- </div>
- </div>
- </div>
- <div id="buttomRowWrapper" class="bg_default">
- <div class="row buttomRow bg_default">
- <div class="bottom">
- <div class="left">
- <a id="grip" class="menu-icon" href="javascript:void(0)"></a>
-
- <div id="drawer">
- <div class="toc">
-
- <nav>
- <ul class="navL1">
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Technologies">Technologies</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/cloud-app-development-msdn" title="Cloud">Cloud</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/app-development-msdn" title="App Development">App Development</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/web-app-development-msdn" title="Web">Web</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/big-data-development-msdn" title="Data">Data</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/games-development-msdn" title="Gaming">Gaming</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/internetofthings" title="Internet of Things">Internet of Things</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Downloads">Downloads</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://www.visualstudio.com/downloads/download-visual-studio-vs" title="Visual Studio">Visual Studio</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/subscriptions" title="MSDN subscription access">MSDN subscription access</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/microsoft-sdks-msdn" title="SDKs">SDKs</a>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Trial software">Trial software</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/evalcenter" title="Free downloads">Free downloads</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/officeevaluationresources" title="Office resources">Office resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/sharepoint2013resources" title="SharePoint Server 2013 resources">SharePoint Server 2013 resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/sqlserver2014expressresources" title="SQL Server 2014 Express resources">SQL Server 2014 Express resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/windowsserver2012r2resources" title="Windows Server 2012 resources">Windows Server 2012 resources</a>
- </li>
- </ul>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Programs">Programs</a>
- <ul class="navL2">
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Visual Studio subscriptions">Visual Studio subscriptions</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/msdn-subscriptions-overview" title="Overview">Overview</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/benefits-overview" title="Benefits">Benefits</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/msdn-subscriptions-administration" title="Administrators">Administrators</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Students">Students</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/imagine/imagine-home" title="Microsoft Imagine">Microsoft Imagine</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/microsoftstudentpartners" title="Microsoft Student Partners">Microsoft Student Partners</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Architects">Architects</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-overview-msdn" title="Overview">Overview</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-case-studies-msdn" title="Case studies">Case studies</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-blueprints-msdn" title="Blueprints">Blueprints</a>
- </li>
- <li class="inactive">
- <a href="http://blogs.msdn.com/b/msarchitecture/" title="Blog">Blog</a>
- </li>
- <li class="inactive">
- <a href="http://social.msdn.microsoft.com/forums/en-us/home?brandignore=true&sort=relevancedesc&searchterm=architecture+or+architect" title="Forums">Forums</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/applicationbuilder" title="ISV">ISV</a>
-
- </li>
- <li class="inactive">
- <a href="https://www.microsoft.com/bizspark" title="Startups">Startups</a>
-
- </li>
- <li class="inactive">
- <a href="https://rewards.msdn.microsoft.com/" title="TechRewards">TechRewards</a>
-
- </li>
- <li class="inactive">
- <a href="http://events.msdn.microsoft.com/" title="Events">Events</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Community">Community</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/magazine/dd767791" title="Magazine">Magazine</a>
-
- </li>
- <li class="inactive">
- <a href="https://social.msdn.microsoft.com/forums/" title="Forums">Forums</a>
-
- </li>
- <li class="inactive">
- <a href="http://blogs.msdn.com/b/developer-tools/" title="Blogs">Blogs</a>
-
- </li>
- <li class="inactive">
- <a href="http://tech-advisors.msdn.microsoft.com/en-us" title="Tech Advisors">Tech Advisors</a>
-
- </li>
- <li class="inactive">
- <a href="http://channel9.msdn.com/" title="Channel 9">Channel 9</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive current toggle">
- <a href="javascript:void(0)" title="Documentation">Documentation</a>
- <ul class="navL2">
- <li class="inactive current">
- <a href="https://msdn.microsoft.com/library" title="APIs and reference">APIs and reference</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/developer-centers-msdn" title="Dev centers">Dev centers</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive">
- <a href="https://code.msdn.microsoft.com/" title="Samples">Samples</a>
- </li>
- </ul>
- </nav>
- </div>
- </div>
- </div>
- <div class="right">
- <div data-fragmentname="SearchBox" id="Fragment_SearchBox" xmlns="http://www.w3.org/1999/xhtml">
- <div class="SearchBox">
- <form id="HeaderSearchForm" name="HeaderSearchForm" method="get">
- <button id="FakeHeaderSearchButton" value="Search" type="submit" class="header-search-button">
- <div id="search-finder" class="search-finder"></div>
- </button>
- <button id="HeaderSearchButton" style="display:none"></button>
- <div id="searchSplitter"></div>
- <div id="searchCloseIcon" class="search-clear-x"></div>
- <div id="searchTextContainer" style="width: 0;">
- <input id="HeaderSearchTextBox" name="query" type="text" maxlength="200" onfocus="Epx.Controls.SearchBox.watermarkFocus(event, this.title)" onblur="Epx.Controls.SearchBox.watermarkBlur(event, this.title)">
- </div>
- </form>
-
-
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- </header>
- </div>
-
-
-
- <div class="printExportMenus ltr">
- <a id="isd_printABook" href="http://msdn.microsoft.com/en-us/library/export/help/(d=printer)?returnurl=%2fen-us%2flibrary%2fhh439643(d%3dprinter,v%3dvs.85).aspx%3flan%3dcsharp%26cc%3dn%26trm%3dtra%26view%3dbook">
- Export (<span class="count">0</span>)
- </a>
- <a id="isd_print" href="https://msdn.microsoft.com/en-us/library/hh439643(d=printer,v=vs.85).aspx?lan=csharp&cc=n&trm=tra&view=book" rel="nofollow">
- Print
- </a>
- <a id="isd_archiveControl" style="display:none;" data-include-archive="Include Previous Version" data-exclude-archive="Exclude Previous Version">
- </a>
- </div>
-
- <div class="printExportMenus ltr">
- <a id="expandCollapseAll" accesskey="e" href="javascript:void(0)" title="Expand/Collapse all sections by pressing Ctrl + Shift + e">Expand All</a>
- </div>
-
- <div id="body" ms.pgarea="body">
- <span id="tabletView_large"></span>
- <span id="tabletView_small"></span>
- <span id="mobileView"></span>
-
- <div id="content" class="content">
- <input type="hidden" id="printForPab" value="true">
-
- <div class="topic" xmlns="http://www.w3.org/1999/xhtml">
- <h1 class="title">Minidrivers, Miniport drivers, and driver pairs</h1>
-
- <div id="mainSection">
- <div class="clsServerSDKContent">
- </div>
- <p></p>
- <p>A minidriver or a miniport driver acts as half of a driver pair. Driver pairs like (miniport, port) can make driver development easier. In a driver pair, one driver handles general tasks that are common to a whole collection of devices, while the other driver handles tasks that are specific to an individual device. The drivers that handle device-specific tasks go by a variety of names, including miniport driver, miniclass driver, and minidriver.</p>
- <p>Microsoft provides the general driver, and typically an independent hardware vendor provides the specific driver. Before you read this topic, you should understand the ideas presented in <a href="https://msdn.microsoft.com/en-us/library/ff554721(v=vs.85).aspx">Device nodes and device stacks</a> and <a href="https://msdn.microsoft.com/en-us/library/hh439638(v=vs.85).aspx">I/O request packets</a>.</p>
- <p>Every kernel-mode driver must implement a function named <a href="https://msdn.microsoft.com/en-us/library/ff544113(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">DriverEntry</strong></a>, which gets called shortly after the driver is loaded. The <strong>DriverEntry</strong> function fills in certain members of a <a href="https://msdn.microsoft.com/en-us/library/ff544174(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">DRIVER_OBJECT</strong></a> structure with pointers to several other functions that the driver implements. For example, the <strong>DriverEntry</strong> function fills in the <strong>Unload</strong> member of the <strong>DRIVER_OBJECT</strong> structure with a pointer to the driver's <a href="https://msdn.microsoft.com/en-us/library/ff564886(v=vs.85).aspx"><em xmlns="http://www.w3.org/1999/xhtml">Unload</em></a> function, as shown in the following diagram.</p><img id="DriverFunctionPointers02" alt="Diagram showing the DRIVER_OBJECT structure with the Unload member" src="./Windows Kernel Development Articles (2016-03-30)_files/IC553387.png" title="Diagram showing the DRIVER_OBJECT structure with the Unload member" xmlns=""><p>The <strong>MajorFunction</strong> member of the <a href="https://msdn.microsoft.com/en-us/library/ff544174(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">DRIVER_OBJECT</strong></a> structure is an array of pointers to functions that handle I/O request packets (<a href="https://msdn.microsoft.com/en-us/library/ff550694(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">IRP</strong></a>s), as shown in the following diagram. Typically the driver fills in several members of the <strong>MajorFunction</strong> array with pointers to functions (implemented by the driver) that handle various kinds of IRPs. </p><img id="DriverFunctionPointers03" alt="Diagram showing the DRIVER_OBJECT structure with the MajorFunction member" src="./Windows Kernel Development Articles (2016-03-30)_files/IC553388.png" title="Diagram showing the DRIVER_OBJECT structure with the MajorFunction member" xmlns=""><p>An IRP can be categorized according to its major function code, which is identified by a constant, such as <strong>IRP_MJ_READ</strong>, <strong>IRP_MJ_WRITE</strong>, or <strong>IRP_MJ_PNP</strong>. The constants that identify major function code serve as indices in the <strong>MajorFunction</strong> array. For example, suppose the driver implements a dispatch function to handle IRPs that have the major function code <strong>IRP_MJ_WRITE</strong>. In this case, the driver must fill in the <strong>MajorFunction</strong>[IRP_MJ_WRITE] element of the array with a pointer to the dispatch function.</p>
- <p>Typically the driver fills in some of the elements of the <strong>MajorFunction</strong> array and leaves the remaining elements set to default values provided by the I/O manager. The following example shows how to use the <a href="https://msdn.microsoft.com/en-us/library/ff562408(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">!drvobj</strong></a> debugger extension to inspect the function pointers for the parport driver.</p>
- <div id="code-snippet-1" class="codeSnippetContainer" xmlns="http://www.w3.org/1999/xhtml">
- <div class="codeSnippetContainerTabs">
- <div class="codeSnippetContainerTab codeSnippetContainerTabActive" dir="ltr">
- <a></a>
- </div>
- </div>
- <div class="codeSnippetContainerCodeContainer">
- <div class="codeSnippetToolBar"></div>
- <div class="codeSnippetContainerCode" dir="ltr">
- <div style="color:Black;"><pre>0: kd> !drvobj parport 2
- Driver object (fffffa80048d9e70) is for:
- \Driver\Parport
- DriverEntry: fffff880065ea070 parport!GsDriverEntry
- DriverStartIo: 00000000
- DriverUnload: fffff880065e131c parport!PptUnload
- AddDevice: fffff880065d2008 parport!P5AddDevice
- Dispatch routines:
- [00] IRP_MJ_CREATE fffff880065d49d0 parport!PptDispatchCreateOpen
- [01] IRP_MJ_CREATE_NAMED_PIPE fffff80001b6ecd4 nt!IopInvalidDeviceRequest
- [02] IRP_MJ_CLOSE fffff880065d4a78 parport!PptDispatchClose
- [03] IRP_MJ_READ fffff880065d4bac parport!PptDispatchRead
- [04] IRP_MJ_WRITE fffff880065d4bac parport!PptDispatchRead
- [05] IRP_MJ_QUERY_INFORMATION fffff880065d4c40 parport!PptDispatchQueryInformation
- [06] IRP_MJ_SET_INFORMATION fffff880065d4ce4 parport!PptDispatchSetInformation
- [07] IRP_MJ_QUERY_EA fffff80001b6ecd4 nt!IopInvalidDeviceRequest
- [08] IRP_MJ_SET_EA fffff80001b6ecd4 nt!IopInvalidDeviceRequest
- [09] IRP_MJ_FLUSH_BUFFERS fffff80001b6ecd4 nt!IopInvalidDeviceRequest
- [0a] IRP_MJ_QUERY_VOLUME_INFORMATION fffff80001b6ecd4 nt!IopInvalidDeviceRequest
- [0b] IRP_MJ_SET_VOLUME_INFORMATION fffff80001b6ecd4 nt!IopInvalidDeviceRequest
- [0c] IRP_MJ_DIRECTORY_CONTROL fffff80001b6ecd4 nt!IopInvalidDeviceRequest
- [0d] IRP_MJ_FILE_SYSTEM_CONTROL fffff80001b6ecd4 nt!IopInvalidDeviceRequest
- [0e] IRP_MJ_DEVICE_CONTROL fffff880065d4be8 parport!PptDispatchDeviceControl
- [0f] IRP_MJ_INTERNAL_DEVICE_CONTROL fffff880065d4c24 parport!PptDispatchInternalDeviceControl
- [10] IRP_MJ_SHUTDOWN fffff80001b6ecd4 nt!IopInvalidDeviceRequest
- [11] IRP_MJ_LOCK_CONTROL fffff80001b6ecd4 nt!IopInvalidDeviceRequest
- [12] IRP_MJ_CLEANUP fffff880065d4af4 parport!PptDispatchCleanup
- [13] IRP_MJ_CREATE_MAILSLOT fffff80001b6ecd4 nt!IopInvalidDeviceRequest
- [14] IRP_MJ_QUERY_SECURITY fffff80001b6ecd4 nt!IopInvalidDeviceRequest
- [15] IRP_MJ_SET_SECURITY fffff80001b6ecd4 nt!IopInvalidDeviceRequest
- [16] IRP_MJ_POWER fffff880065d491c parport!PptDispatchPower
- [17] IRP_MJ_SYSTEM_CONTROL fffff880065d4d4c parport!PptDispatchSystemControl
- [18] IRP_MJ_DEVICE_CHANGE fffff80001b6ecd4 nt!IopInvalidDeviceRequest
- [19] IRP_MJ_QUERY_QUOTA fffff80001b6ecd4 nt!IopInvalidDeviceRequest
- [1a] IRP_MJ_SET_QUOTA fffff80001b6ecd4 nt!IopInvalidDeviceRequest
- [1b] IRP_MJ_PNP fffff880065d4840 parport!PptDispatchPnp
- </pre></div>
- </div>
- </div>
- </div>
- <p>In the debugger output, you can see that parport.sys implements <strong>GsDriverEntry</strong>, the entry point for the driver. <strong>GsDriverEntry</strong>, which was generated automatically when the driver was built, performs some initialization and then calls <a href="https://msdn.microsoft.com/en-us/library/ff544113(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">DriverEntry</strong></a>, which was implemented by the driver developer.</p>
- <p>You can also see that the parport driver (in its <a href="https://msdn.microsoft.com/en-us/library/ff544113(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">DriverEntry</strong></a> function) provides pointers to dispatch functions for these major function codes:</p>
- <ul>
- <li>IRP_MJ_CREATE</li>
- <li>IRP_MJ_CLOSE</li>
- <li>IRP_MJ_READ</li>
- <li>IRP_MJ_WRITE</li>
- <li>IRP_MJ_QUERY_INFORMATION</li>
- <li>IRP_MJ_SET_INFORMATION</li>
- <li>IRP_MJ_DEVICE_CONTROL</li>
- <li>IRP_MJ_INTERNAL_DEVICE_CONTROL</li>
- <li>IRP_MJ_CLEANUP</li>
- <li>IRP_MJ_POWER</li>
- <li>IRP_MJ_SYSTEM_CONTROL</li>
- <li>IRP_MJ_PNP</li>
- </ul>
- <p>The remaining elements of the <strong>MajorFunction</strong> array hold pointers to the default dispatch function <strong>nt!IopInvalidDeviceRequest</strong>.</p>
- <p>In the debugger output, you can see that the parport driver provided function pointers for <a href="https://msdn.microsoft.com/en-us/library/ff564886(v=vs.85).aspx"><em xmlns="http://www.w3.org/1999/xhtml">Unload</em></a> and <a href="https://msdn.microsoft.com/en-us/library/ff540521(v=vs.85).aspx"><em xmlns="http://www.w3.org/1999/xhtml">AddDevice</em></a>, but did not provide a function pointer for <a href="https://msdn.microsoft.com/en-us/library/ff563858(v=vs.85).aspx"><em xmlns="http://www.w3.org/1999/xhtml">StartIo</em></a>. The <em>AddDevice</em> function is unusual because its function pointer is not stored in the <a href="https://msdn.microsoft.com/en-us/library/ff544174(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">DRIVER_OBJECT</strong></a> structure. Instead, it is stored in the <strong>AddDevice</strong> member of an extension to the <strong>DRIVER_OBJECT</strong> structure. The following diagram illustrates the function pointers that the parport driver provided in its <a href="https://msdn.microsoft.com/en-us/library/ff544113(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">DriverEntry</strong></a> function. The function pointers provided by parport are shaded.</p><img id="DriverFunctionPointers01" alt="Diagram of function pointers in a DRIVER_OBJECT structure" src="./Windows Kernel Development Articles (2016-03-30)_files/IC553389.png" title="Diagram of function pointers in a DRIVER_OBJECT structure" xmlns=""><h2><a id="Making_it_easier_by_using_driver_pairs"></a><a id="making_it_easier_by_using_driver_pairs"></a><a id="MAKING_IT_EASIER_BY_USING_DRIVER_PAIRS"></a>Making it easier by using driver pairs</h2>
- <p>Over a period of time, as driver developers inside and outside of Microsoft gained experience with the Windows Driver Model (WDM), they realized a couple of things about dispatch functions:</p>
- <ul>
- <li>Dispatch functions are largely boilerplate. For example, much of the code in the dispatch function for IRP_MJ_PNP is the same for all drivers. It is only a small portion of the Plug and Play (PnP) code that is specific to an individual driver that controls an individual piece of hardware.</li>
- <li>Dispatch functions are complicated and difficult to get right. Implementing features like thread synchronization, IRP queuing, and IRP cancellation is challenging and requires a deep understanding of how the operating system works.</li>
- </ul>
- <p>To make things easier for driver developers, Microsoft created several technology-specific driver models. At first glance, the technology-specific models seem quite different from each other, but a closer look reveals that many of them are based on this paradigm:</p>
- <ul>
- <li>The driver is split into two pieces: one that handles the general processing and one that handles processing specific to a particular device.</li>
- <li>The general piece is written by Microsoft.</li>
- <li>The specific piece may be written by Microsoft or an independent hardware vendor.</li>
- </ul>
- <p>Suppose that the Proseware and Contoso companies both make a toy robot that requires a WDM driver. Also suppose that Microsoft provides a General Robot Driver called GeneralRobot.sys. Proseware and Contoso can each write small drivers that handle the requirements of their specific robots. For example, Proseware could write ProsewareRobot.sys, and the pair of drivers (ProsewareRobot.sys, GeneralRobot.sys) could be combined to form a single WDM driver. Likewise, the pair of drivers (ContosoRobot.sys, GeneralRobot.sys) could combine to form a single WDM driver. In its most general form, the idea is that you can create drivers by using (specific.sys, general.sys) pairs.</p>
- <h2><a id="Function_pointers_in_driver_pairs"></a><a id="function_pointers_in_driver_pairs"></a><a id="FUNCTION_POINTERS_IN_DRIVER_PAIRS"></a>Function pointers in driver pairs</h2>
- <p> In a (specific.sys, general.sys) pair, Windows loads specific.sys and calls its <a href="https://msdn.microsoft.com/en-us/library/ff544113(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">DriverEntry</strong></a> function. The <strong>DriverEntry</strong> function of specific.sys receives a pointer to a <a href="https://msdn.microsoft.com/en-us/library/ff544174(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">DRIVER_OBJECT</strong></a> structure. Normally you would expect <strong>DriverEntry</strong> to fill in several elements of the <strong>MajorFunction</strong> array with pointers to dispatch functions. Also you would expect <strong>DriverEntry</strong> to fill in the <strong>Unload</strong> member (and possibly the <strong>StartIo</strong> member) of the <strong>DRIVER_OBJECT</strong> structure and the <strong>AddDevice</strong> member of the driver object extension. However, in a driver pair model, <strong>DriverEntry</strong> does not necessarily do this. Instead the <strong>DriverEntry</strong> function of specific.sys passes the <strong>DRIVER_OBJECT</strong> structure along to an initialization function implemented by general.sys. The following code example shows how the initialization function might be called in the (ProsewareRobot.sys, GeneralRobot.sys) pair.</p>
- <div id="code-snippet-2" class="codeSnippetContainer" xmlns="http://www.w3.org/1999/xhtml">
- <div class="codeSnippetContainerTabs">
- <div class="codeSnippetContainerTab codeSnippetContainerTabActive" dir="ltr">
- <a>C++</a>
- </div>
- </div>
- <div class="codeSnippetContainerCodeContainer">
- <div class="codeSnippetToolBar"></div>
- <div class="codeSnippetContainerCode" dir="ltr">
- <div style="color:Black;"><pre>
- PVOID g_ProsewareRobottCallbacks[3] = {DeviceControlCallback, PnpCallback, PowerCallback};
- <span style="color:Green;">// DriverEntry function in ProsewareRobot.sys</span>
- NTSTATUS DriverEntry (DRIVER_OBJECT *DriverObject, PUNICODE_STRING RegistryPath)
- {
- <span style="color:Green;">// Call the initialization function implemented by GeneralRobot.sys.</span>
- <span style="color:Blue;">return</span> GeneralRobotInit(DriverObject, RegistryPath, g_ProsewareRobottCallbacks);
- }
- </pre></div>
- </div>
- </div>
- </div>
- <p>The initialization function in GeneralRobot.sys writes function pointers to the appropriate members of the <a href="https://msdn.microsoft.com/en-us/library/ff544174(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">DRIVER_OBJECT</strong></a> structure (and its extension) and the appropriate elements of the <strong>MajorFunction</strong> array. The idea is that when the I/O manager sends an IRP to the driver pair, the IRP goes first to a dispatch function implemented by GeneralRobot.sys. If GeneralRobot.sys can handle the IRP on its own, then the specific driver, ProsewareRobot.sys, does not have to be involved. If GeneralRobot.sys can handle some, but not all, of the IRP processing, it gets help from one of the callback functions implemented by ProsewareRobot.sys. GeneralRobot.sys receives pointers to the ProsewareRobot callbacks in the GeneralRobotInit call.</p>
- <p>At some point after <a href="https://msdn.microsoft.com/en-us/library/ff544113(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">DriverEntry</strong></a> returns, a device stack gets constructed for the Proseware Robot device node. The device stack might look like this.</p><img id="driverpairs01" alt="Diagram of the Proseware Robot device node, showing three device objects in the device stack: AfterThought.sys (Filter DO), ProsewareRobot.sys, GeneralRobot.sys (FDO), and Pci.sys (PDO)" src="./Windows Kernel Development Articles (2016-03-30)_files/IC553390.png" title="Diagram of the Proseware Robot device node, showing three device objects in the device stack: AfterThought.sys (Filter DO), ProsewareRobot.sys, GeneralRobot.sys (FDO), and Pci.sys (PDO)" xmlns=""><p>As shown in the preceding diagram, the device stack for Proseware Robot has three device objects. The top device object is a filter device object (Filter DO) associated with the filter driver AfterThought.sys. The middle device object is a functional device object (FDO) associated with the driver pair (ProsewareRobot.sys, GeneralRobot.sys). The driver pair serves as the function driver for the device stack. The bottom device object is a physical device object (PDO) associated with Pci.sys.</p>
- <p>Notice that the driver pair occupies only one level in the device stack and is associated with only one device object: the FDO. When GeneralRobot.sys processes an IRP, it might call ProsewareRobot.sys for assistance, but that is not the same as passing the request down the device stack. The driver pair forms a single WDM driver that is at one level in the device stack. The driver pair either completes the IRP or passes it down the device stack to the PDO, which is associated with Pci.sys.</p>
- <h2><a id="Example_of_a_driver_pair"></a><a id="example_of_a_driver_pair"></a><a id="EXAMPLE_OF_A_DRIVER_PAIR"></a>Example of a driver pair</h2>
- <p>Suppose you have a wireless network card in your laptop computer, and by looking in Device Manager, you determine that netwlv64.sys is the driver for the network card. You can use the <a href="https://msdn.microsoft.com/en-us/library/ff562408(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">!drvobj</strong></a> debugger extension to inspect the function pointers for netwlv64.sys.</p>
- <div id="code-snippet-3" class="codeSnippetContainer" xmlns="http://www.w3.org/1999/xhtml">
- <div class="codeSnippetContainerTabs">
- <div class="codeSnippetContainerTab codeSnippetContainerTabActive" dir="ltr">
- <a></a>
- </div>
- </div>
- <div class="codeSnippetContainerCodeContainer">
- <div class="codeSnippetToolBar"></div>
- <div class="codeSnippetContainerCode" dir="ltr">
- <div style="color:Black;"><pre>1: kd> !drvobj netwlv64 2
- Driver object (fffffa8002e5f420) is for:
- \Driver\netwlv64
- DriverEntry: fffff8800482f064 netwlv64!GsDriverEntry
- DriverStartIo: 00000000
- DriverUnload: fffff8800195c5f4 ndis!ndisMUnloadEx
- AddDevice: fffff88001940d30 ndis!ndisPnPAddDevice
- Dispatch routines:
- [00] IRP_MJ_CREATE fffff880018b5530 ndis!ndisCreateIrpHandler
- [01] IRP_MJ_CREATE_NAMED_PIPE fffff88001936f00 ndis!ndisDummyIrpHandler
- [02] IRP_MJ_CLOSE fffff880018b5870 ndis!ndisCloseIrpHandler
- [03] IRP_MJ_READ fffff88001936f00 ndis!ndisDummyIrpHandler
- [04] IRP_MJ_WRITE fffff88001936f00 ndis!ndisDummyIrpHandler
- [05] IRP_MJ_QUERY_INFORMATION fffff88001936f00 ndis!ndisDummyIrpHandler
- [06] IRP_MJ_SET_INFORMATION fffff88001936f00 ndis!ndisDummyIrpHandler
- [07] IRP_MJ_QUERY_EA fffff88001936f00 ndis!ndisDummyIrpHandler
- [08] IRP_MJ_SET_EA fffff88001936f00 ndis!ndisDummyIrpHandler
- [09] IRP_MJ_FLUSH_BUFFERS fffff88001936f00 ndis!ndisDummyIrpHandler
- [0a] IRP_MJ_QUERY_VOLUME_INFORMATION fffff88001936f00 ndis!ndisDummyIrpHandler
- [0b] IRP_MJ_SET_VOLUME_INFORMATION fffff88001936f00 ndis!ndisDummyIrpHandler
- [0c] IRP_MJ_DIRECTORY_CONTROL fffff88001936f00 ndis!ndisDummyIrpHandler
- [0d] IRP_MJ_FILE_SYSTEM_CONTROL fffff88001936f00 ndis!ndisDummyIrpHandler
- [0e] IRP_MJ_DEVICE_CONTROL fffff8800193696c ndis!ndisDeviceControlIrpHandler
- [0f] IRP_MJ_INTERNAL_DEVICE_CONTROL fffff880018f9114 ndis!ndisDeviceInternalIrpDispatch
- [10] IRP_MJ_SHUTDOWN fffff88001936f00 ndis!ndisDummyIrpHandler
- [11] IRP_MJ_LOCK_CONTROL fffff88001936f00 ndis!ndisDummyIrpHandler
- [12] IRP_MJ_CLEANUP fffff88001936f00 ndis!ndisDummyIrpHandler
- [13] IRP_MJ_CREATE_MAILSLOT fffff88001936f00 ndis!ndisDummyIrpHandler
- [14] IRP_MJ_QUERY_SECURITY fffff88001936f00 ndis!ndisDummyIrpHandler
- [15] IRP_MJ_SET_SECURITY fffff88001936f00 ndis!ndisDummyIrpHandler
- [16] IRP_MJ_POWER fffff880018c35e8 ndis!ndisPowerDispatch
- [17] IRP_MJ_SYSTEM_CONTROL fffff880019392c8 ndis!ndisWMIDispatch
- [18] IRP_MJ_DEVICE_CHANGE fffff88001936f00 ndis!ndisDummyIrpHandler
- [19] IRP_MJ_QUERY_QUOTA fffff88001936f00 ndis!ndisDummyIrpHandler
- [1a] IRP_MJ_SET_QUOTA fffff88001936f00 ndis!ndisDummyIrpHandler
- [1b] IRP_MJ_PNP fffff8800193e518 ndis!ndisPnPDispatch
- </pre></div>
- </div>
- </div>
- </div>
- <p>In the debugger output, you can see that netwlv64.sys implements <strong>GsDriverEntry</strong>, the entry point for the driver. <strong>GsDriverEntry</strong>, which was automatically generated when the driver was built, performs some initialization and then calls <a href="https://msdn.microsoft.com/en-us/library/ff544113(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">DriverEntry</strong></a>, which was written by the driver developer.</p>
- <p>In this example, netwlv64.sys implements <a href="https://msdn.microsoft.com/en-us/library/ff544113(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">DriverEntry</strong></a>, but ndis.sys implements <a href="https://msdn.microsoft.com/en-us/library/ff540521(v=vs.85).aspx"><em xmlns="http://www.w3.org/1999/xhtml">AddDevice</em></a>, <a href="https://msdn.microsoft.com/en-us/library/ff564886(v=vs.85).aspx"><em xmlns="http://www.w3.org/1999/xhtml">Unload</em></a>, and several dispatch functions. Netwlv64.sys is called an NDIS miniport driver, and ndis.sys is called the NDIS Library. Together, the two modules form an (NDIS miniport, NDIS Library) pair.</p>
- <p>This diagram shows the device stack for the wireless network card. Notice that the driver pair (netwlv64.sys, ndis.sys) occupies only one level in the device stack and is associated with only one device object: the FDO.</p><img id="DriverPairs02A" alt="Diagram of the Wireless network card device stack, showing Netwlv64.sys, ndis.sys as the driver pair associated with the FDO and Pci.sys associated with the PDO " src="./Windows Kernel Development Articles (2016-03-30)_files/IC559049.png" title="Diagram of the Wireless network card device stack, showing Netwlv64.sys, ndis.sys as the driver pair associated with the FDO and Pci.sys associated with the PDO " xmlns=""><h2><a id="Available_driver_pairs"></a><a id="available_driver_pairs"></a><a id="AVAILABLE_DRIVER_PAIRS"></a>Available driver pairs</h2>
- <p>The different technology-specific driver models use a variety of names for the specific and general pieces of a driver pair. In many cases, the specific portion of the pair has the prefix "mini." Here are some of (specific, general) pairs that are available:</p><ul>
- <li>(display miniport driver, display port driver)</li>
- <li>(audio miniport driver, audio port driver)</li>
- <li>(storage miniport driver, storage port driver)</li>
- <li>(battery miniclass driver, battery class driver)</li>
- <li>(HID minidriver, HID class driver)</li>
- <li>(changer miniclass driver, changer port driver)</li>
- <li>(NDIS miniport driver, NDIS library)</li>
- </ul>
- <div class="alert"><strong>Note</strong> As you can see in the list, several of the models use the term <em>class driver</em> for the general portion of a driver pair. This kind of class driver is different from a standalone class driver and different from a class filter driver.</div>
- <div> </div>
- <h2><a id="related_topics"></a>Related topics</h2>
- <dl>
- <dt>
- <a href="https://msdn.microsoft.com/en-us/library/ff554731(v=vs.85).aspx">Concepts for all driver developers</a>
- </dt>
- <dt>
- <a href="https://msdn.microsoft.com/en-us/library/ff554721(v=vs.85).aspx">Device nodes and device stacks</a>
- </dt>
- <dt>
- <a href="https://msdn.microsoft.com/en-us/library/hh439632(v=vs.85).aspx">Driver stacks</a>
- </dt>
- </dl>
- <p> </p>
- <p> </p>
- <p><a href="mailto:wsddocfb@microsoft.com?subject=Documentation%20feedback%20[wdkgetstart\wdkgetstart]:%20Minidrivers,%20Miniport%20drivers,%20and%20driver%20pairs%20%20RELEASE:%20(3/4/2016)&body=%0A%0APRIVACY%20STATEMENT%0A%0AWe%20use%20your%20feedback%20to%20improve%20the%20documentation.%20We%20don%27t%20use%20your%20email%20address%20for%20any%20other%20purpose,%20and%20we%27ll%20remove%20your%20email%20address%20from%20our%20system%20after%20the%20issue%20that%20you%27re%20reporting%20is%20fixed.%20While%20we%27re%20working%20to%20fix%20this%20issue,%20we%20might%20send%20you%20an%20email%20message%20to%20ask%20for%20more%20info.%20Later,%20we%20might%20also%20send%20you%20an%20email%20message%20to%20let%20you%20know%20that%20we%27ve%20addressed%20your%20feedback.%0A%0AFor%20more%20info%20about%20Microsoft%27s%20privacy%20policy,%20see%20http://privacy.microsoft.com/en-us/default.aspx." title="Send comments about this topic to Microsoft">Send comments about this topic to Microsoft</a></p>
- </div>
- </div>
-
- </div>
- </div>
- <div class="clear"></div>
-
- <input name="__RequestVerificationToken" type="hidden" value="eNww8qJ7BN5NFgQqwVE-mt2pS3RHPxGr7WTykowvQUo3DQicFiNb0BfsZFXOx2-U1S7RY6Pi-r6cQmjfmIWj4oGVs0E1">
- <input id="ratingValueSubmitUrl" type="hidden" value="https://msdn.microsoft.com/en-us/library/feedback/rate/hh439643(d=printer,v=vs.85).aspx">
- <input id="ratingAdditionalSubmitUrl" type="hidden" value="https://msdn.microsoft.com/en-us/library/feedback/additional/hh439643(d=printer,v=vs.85).aspx">
- <input id="isTopicRated" type="hidden" value="false">
- <div id="lib-footer" ms.pgarea="body">
-
-
- <link type="text/css" rel="stylesheet">
-
- <div id="ux-footer" class="" style="" dir="ltr">
-
- <div id="footerSock" class="librarySock both">
- <div id="footerSockInner">
- <a name="feedback"></a>
- <div class="rating">
- <div id="ratingSection1">
- <div class="title">
- Was this page helpful?
- </div>
- <div class="description">
- Your feedback about this content is important.<br>Let us know what you think.
- </div>
- <div class="buttons">
- <button class="button" id="ratingYes" aria-label="Yes, this page was helpful">Yes</button>
- <button class="button" id="ratingNo" aria-label="No, this page was not helpful">No</button>
- </div>
- <input id="ratingValue" type="hidden" value="">
- </div>
- <div id="ratingSection2">
- <div class="title left">
- Additional feedback?
- </div>
- <textarea id="ratingText" rows="6" cols="" maxlength="1500"></textarea>
- <div class="right">
- <div class="counter">
- <span id="feedbackTextCounter">1500</span> characters remaining
- </div>
- <div class="buttons">
- <button class="button" id="ratingSubmit" aria-label="Submit my additional feedback">Submit</button>
- <button class="button" id="ratingSkipThis" aria-label="Skip additional feedback">Skip this</button>
- </div>
- </div>
- </div>
- <div id="ratingSection3">
- <div class="title">
- Thank you!
- </div>
- <div class="description">
- We appreciate your feedback.
- </div>
- </div>
-
-
- <div id="contentFeedbackQAContainer" style="display: none;"></div>
- </div>
-
- <div class="userVoice">
- <div class="title">
- Help us improve MSDN.
- </div>
- <div class="description">
- Visit our UserVoice Page to submit and vote on ideas!
- </div>
- <div class="buttons">
- <a class="button" id="userVoiceButton" href="http://feedback.msdn.com/forums/257782-msdn-feature-suggestions/category/83975" target="_blank">Make a suggestion</a>
- </div>
- </div>
- <div class="clear"></div>
- </div>
- </div>
- <footer class="top">
- <div data-fragmentname="LeftLinks" id="Fragment_LeftLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Dev centers</div>
- <ul class="links">
- <li>
- <a href="https://dev.windows.com/" id="LeftLinks_2148_1" class="windowsBlue" xmlns="http://www.w3.org/1999/xhtml">Windows</a>
- </li>
- <li>
- <a href="http://dev.office.com/" id="LeftLinks_2148_3" class="office" xmlns="http://www.w3.org/1999/xhtml">Office</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/vstudio" id="LeftLinks_2148_4" class="visualStudio" xmlns="http://www.w3.org/1999/xhtml">Visual Studio</a>
- </li>
- <li>
- <a href="http://azure.microsoft.com/en-us/documentation/" target="_blank" id="LeftLinks_2148_12" xmlns="http://www.w3.org/1999/xhtml">Microsoft Azure</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/developer-centers-msdn" id="LeftLinks_2148_5" xmlns="http://www.w3.org/1999/xhtml">More...</a>
- </li>
- </ul>
- </div>
- </div>
- <div id="rightLinks">
- <div data-fragmentname="CenterLinks1" id="Fragment_CenterLinks1" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Learning resources</div>
- <ul class="links">
- <li>
- <a href="http://www.microsoftvirtualacademy.com/" id="CenterLinks1_2151_4" xmlns="http://www.w3.org/1999/xhtml">Microsoft Virtual Academy</a>
- </li>
- <li>
- <a href="http://channel9.msdn.com/" id="CenterLinks1_2151_5" xmlns="http://www.w3.org/1999/xhtml">Channel 9</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/magazine/" id="CenterLinks1_2151_7" xmlns="http://www.w3.org/1999/xhtml">MSDN Magazine</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks2" id="Fragment_CenterLinks2" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Community</div>
- <ul class="links">
- <li>
- <a href="https://social.msdn.microsoft.com/forums/en-us/home" id="CenterLinks2_2151_8" xmlns="http://www.w3.org/1999/xhtml">Forums</a>
- </li>
- <li>
- <a href="http://blogs.msdn.com/b/developer-tools/" id="CenterLinks2_2151_9" xmlns="http://www.w3.org/1999/xhtml">Blogs</a>
- </li>
- <li>
- <a href="http://www.codeplex.com/" id="CenterLinks2_2151_10" xmlns="http://www.w3.org/1999/xhtml">Codeplex</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks3" id="Fragment_CenterLinks3" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Support</div>
- <ul class="links">
- <li>
- <a href="https://msdn.microsoft.com/hh361695" id="CenterLinks3_2151_11" xmlns="http://www.w3.org/1999/xhtml">Self support</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks4" id="Fragment_CenterLinks4" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Programs</div>
- <ul class="links">
- <li>
- <a href="https://www.microsoft.com/bizspark/" id="CenterLinks4_2151_13" xmlns="http://www.w3.org/1999/xhtml">BizSpark (for startups)</a>
- </li>
- <li>
- <a href="https://www.dreamspark.com/" id="CenterLinks4_2151_14" xmlns="http://www.w3.org/1999/xhtml">DreamSpark</a>
- </li>
- <li>
- <a href="http://www.imaginecup.com/" id="CenterLinks4_2151_17" xmlns="http://www.w3.org/1999/xhtml">Imagine Cup</a>
- </li>
- </ul>
- </div>
- </div>
- </div>
- </footer>
- <footer class="bottom">
- <span class="localeContainer">
-
- <form class="selectLocale" id="selectLocaleForm" action="https://msdn.microsoft.com/en-us/selectlocale-dmc">
- <input type="hidden" name="fromPage" value="https%3a%2f%2fmsdn.microsoft.com%2fen-us%2flibrary%2fhh439643(d%3dprinter%2cv%3dvs.85).aspx%3flan%3dCSharp%26cc%3dn%26trm%3dtra%26view%3dbook">
- <a href="http://msdn.microsoft.com/#" onclick="$('#selectLocaleForm').submit();return false;" title="Change your language">United States (English)</a>
- </form>
- </span>
- <div data-fragmentname="BottomLinks" id="Fragment_BottomLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <ul class="links horizontal">
- <li>
- <a href="https://msdn.microsoft.com/newsletter.aspx" id="BottomLinks_2148_7" xmlns="http://www.w3.org/1999/xhtml">Newsletter</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/dn529288" id="BottomLinks_2148_8" xmlns="http://www.w3.org/1999/xhtml">Privacy & cookies</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/cc300389" id="BottomLinks_2148_9" xmlns="http://www.w3.org/1999/xhtml">Terms of use</a>
- </li>
- <li>
- <a href="https://www.microsoft.com/en-us/legal/intellectualproperty/Trademarks/EN-US.aspx" id="BottomLinks_2148_10" xmlns="http://www.w3.org/1999/xhtml">Trademarks</a>
- </li>
- </ul>
- </div>
- </div>
- <span class="logoLegal">
- <span class="logo"></span>
- <span class="copyright">© 2016 Microsoft</span>
- </span>
- </footer>
- </div>
-
- </div>
- <div class="footerPrintView">
- <div class="footerCopyrightPrintView">© 2016 Microsoft</div>
- </div>
-
-
-
-
- <input id="tocPaddingPerLevel" type="hidden" value="17">
- <input id="MtpsDevice" type="hidden" value="Printer">
- <!--[CDATA[ Third party scripts and code linked to or referenced from this website are licensed to you by the parties that own such code, not by Microsoft. See ASP.NET Ajax CDN Terms of Use – http://www.asp.net/ajaxlibrary/CDN.ashx. ]]-->
-
-
-
-
-
- <noscript><div><img alt="DCSIMG" id="Img1" width="1" height="1" src="https://m.webtrends.com/dcsmgru7m99k7mqmgrhudo0k8_8c6m/njs.gif?dcsuri=/nojavascript&amp;WT.js=No" /></div></noscript>
- <div id="globalRequestVerification">
- <input name="__RequestVerificationToken" type="hidden" value="B7B4KE1u9EB0CZGVIHJUVX-cgY6GLPyhKnM6U3-QvD2UQ1F7KqckdXsd2_Weu3yWuifgyn0Mam79T7HEPAM9dycouf01">
- </div>
- </div>
-
-
-
-
-
-
- <script type="text/javascript" class="mtps-injected">
- /*<![CDATA[*/
- (function(window,document){"use strict";function preload(scripts){for(var result=[],script,e,i=0;i<scripts.length;i++)script=scripts[i],script.hasOwnProperty("url")&&(e=document.createElement("script"),e.src=script.url,script.throwaway=e),result.push(script);return result}function inject(scripts,index){var script,elem;if(index>=scripts.length){delete mtps.injectScripts;return}script=scripts[index];elem=document.createElement("script");elem.className="mtps-injected";elem.async=!1;var isLoaded=!1,timeoutId=0,injectNextFnName="",injectNext=elem.onerror=function(){isLoaded||(isLoaded=!0,inject(scripts,index+1),window.clearTimeout(timeoutId),elem.onload=elem.onerror=elem.onreadystatechange=null,injectNextFnName&&delete mtps[injectNextFnName],elem.removeEventListener&&elem.removeEventListener("load",injectNext,!1))};elem.addEventListener?elem.addEventListener("load",injectNext,!1):elem.readyState==="uninitialized"?elem.onreadystatechange=function(){(this.readyState==="loaded"||this.readyState==="complete")&&injectNext()}:elem.onload=injectNext;script.hasOwnProperty("url")?(timeoutId=window.setTimeout(injectNext,12e4),elem.src=script.url):(injectNextFnName="_injectNextScript_"+index,mtps[injectNextFnName]=injectNext,timeoutId=window.setTimeout(injectNext,2e3),elem.text="try {\n"+script.txt+"\n} finally { MTPS."+injectNextFnName+" && MTPS."+injectNextFnName+"(); }");parent.appendChild(elem)}var mtps=window.MTPS||(window.MTPS={}),parent=document.getElementsByTagName("head")[0];mtps.injectScripts=function(scripts){inject(preload(scripts),0)}})(window,document);
- MTPS.injectScripts([
- { txt: "/**/\r\n(window.MTPS || (window.MTPS = {})).cdnDomains || (window.MTPS.cdnDomains = { \r\n\t\"image\": \"https://i-msdn.sec.s-msft.com\", \r\n\t\"js\": \"https://i2-msdn.sec.s-msft.com\", \r\n\t\"css\": \"https://i-msdn.sec.s-msft.com\", \r\n\t\"ttf\": \"https://i-msdn.sec.s-msft.com\"\r\n});\r\n/**/" },
- { txt: "//\n var literalNormalizedUrl = \u0027/en-us/library/hh439643(d=printer,l=en-us,v=vs.85).aspx\u0027;\n var wt_nvr_ru = \u0027WT_NVR_RU\u0027;\n var wt_fpcdom = \u0027.microsoft.com\u0027;\n var wt_domlist = \u0027msdn.microsoft.com\u0027;\n var wt_pathlist = \u0027\u0027;\n var wt_paramlist = \u0027DCSext.mtps_devcenter\u0027;\n var wt_siteid = \u0027MSDN\u0027;\n var gDomain = \u0027m.webtrends.com\u0027;\n var gDcsId = \u0027dcsmgru7m99k7mqmgrhudo0k8_8c6m\u0027;\n var gFpc = \u0027WT_FPC\u0027;\n\n\n\n if (document.cookie.indexOf(gFpc + \"=\") == -1) {\n var wtidJs = document.createElement(\"script\");\n wtidJs.src = \"//\" + gDomain + \"/\" + gDcsId + \"/wtid.js\";\n document.getElementsByTagName(\"head\")[0].appendChild(wtidJs);\n }\n\n\n\n var detectedLocale = \u0027en-us\u0027;\n var wtsp = \u0027msdnlib_w32_com\u0027;\n var gTrackEvents = \u00270\u0027;\n/**/" },
- { txt: "//\n\n window.appInsightsId = \u00275eb1b2eb-c47a-497a-a7ac-a1c230b2882f\u0027;\n //" },
- { url: "https://i2-msdn.sec.s-msft.com/Combined.js?resources=0:Utilities,1:Layout,2:Header,1:Rating,2:Footer,0:Topic,3:PabTopic,4:webtrendsscript,0:AppInsightsPerf,0:ABTestControl,5:WEDCS,3:CmpgrpForHeader,0:livefyre,0:Comment,1:SearchBox;/Areas/Epx/Content/Scripts:0,/Areas/Epx/Themes/Base/Content:1,/Areas/Centers/Themes/StandardDevCenter/Content:2,/Areas/Library/Content:3,/Areas/Global/Content/Webtrends/resources:4,/Areas/Library/Themes/Base/Content:5\u0026amp;hashKey=30CEE944AABFEA2C5A338BDB9E000732\u0026amp;v=AE608271C0243AAA0449D3BC0FAD8EB4" },
- { url: "https://i1.services.social.microsoft.com/search/Widgets/SearchBox.jss?boxid=HeaderSearchTextBox\u0026btnid=HeaderSearchButton\u0026pgArea=header\u0026brand=Msdn\u0026loc=en-us\u0026focusOnInit=false\u0026emptyWatermark=true\u0026searchButtonTooltip=Search MSDN" },
- { url: "https://i2-msdn.sec.s-msft.com/Combined.js?resources=0:PrintExportButton,1:Toc_Fixed,1:CodeSnippet,1:TopicNotInScope,1:CollapsibleArea,1:VersionSelector,1:SurveyBroker;/Areas/Library/Themes/Base/Content:0,/Areas/Epx/Content/Scripts:1\u0026amp;hashKey=80F30894E3FB8A3295C923AEC7019CFE\u0026amp;v=AE608271C0243AAA0449D3BC0FAD8EB4" },
- { txt: "$(document).ready(function() {\n try {\n var token = $(\"#globalRequestVerification input[name=\u0027__RequestVerificationToken\u0027]\").clone();\n $(\"#siteFeedbackForm\").append(token);\n } catch(err) {\n \n }\n });" }
- ]);
- /*]]>*/
- </script>
- <link rel="stylesheet" type="text/css" href="./Windows Kernel Development Articles (2016-03-30)_files/Combined.css">
- <div id="page">
-
-
-
-
- <link type="text/css" rel="stylesheet">
-
- <input type="hidden" id="isHeaderBleeding" value="true">
- <div id="ux-header" dir="ltr" class="ltr msdn">
-
- <header>
- <span id="singleCol"></span>
- <span id="doubleCol"></span>
- <span id="isMobile"></span>
- <div>
- <div class="row topRow">
- <div class="top">
- <div class="left">
- <a class="msdnLogoImg" href="https://msdn.microsoft.com/en-us" title="MSDN home">
- <div id="msft-logo" class="msft-logo"></div>
- </a>
- <div class="GrayPipe"></div>
- <a class="DevCenterFullNameNonMegaBlade" href="https://msdn.microsoft.com/en-us">Developer Network</a>
- <a class="DevCenterFullName" href="https://msdn.microsoft.com/en-us">Developer Network</a>
- <a class="DevCenterShortName" href="https://msdn.microsoft.com/en-us">Developer</a>
- </div>
- <div class="right">
- <div id="signIn">
- <div class="profileImage"></div>
- <a class="scarabLink" href="https://login.live.com/login.srf?wa=wsignin1.0&rpsnv=12&ct=1459376420&rver=6.0.5276.0&wp=mcmbi&wlcxt=msdn%24msdn%24msdn&wreply=https%3a%2f%2fmsdn.microsoft.com%2fen-us%2flibrary%2fhh706279%2528d%3dprinter%2cv%3dvs.85%2529.aspx%3flan%3dcsharp%26cc%3dn%26trm%3dtra%26view%3dbook&lc=1033&id=254354&mkt=en-us" title="Sign in">Sign in</a></div>
- <div class="auxNav">
- <div>
- <div data-fragmentname="Subscriptions" id="Fragment_Subscriptions" xmlns="http://www.w3.org/1999/xhtml">
- <a href="https://msdn.microsoft.com/subscriptions/manage/hh442900" id="Subscriptions_2153_1" xmlns="http://www.w3.org/1999/xhtml">MSDN subscriptions</a>
- </div>
- <div data-fragmentname="GetTools" id="Fragment_GetTools" xmlns="http://www.w3.org/1999/xhtml">
- <a href="http://go.microsoft.com/fwlink/?LinkId=309297&clcid=0x409&slcid=0x409&campaign=o~msft~msdn~gettools-header~dn308572" id="GetTools_2153_3" xmlns="http://www.w3.org/1999/xhtml">Get tools</a>
- </div>
- </div>
- <div>
- <div data-fragmentname="SocialLinks" id="Fragment_SocialLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <ul class="links horizontal">
- <li>
- <a href="http://www.facebook.com/microsoftdeveloper" target="_blank" id="SocialLinks_2152_4" class="facebook" xmlns="http://www.w3.org/1999/xhtml">http://www.facebook.com/microsoftdeveloper</a>
- </li>
- <li>
- <a href="https://twitter.com/msdev" target="_blank" id="SocialLinks_2152_5" class="twitter" xmlns="http://www.w3.org/1999/xhtml">https://twitter.com/msdev</a>
- </li>
- <li>
- <a href="http://plus.google.com/111221966647232053570/" target="_blank" id="SocialLinks_2152_6" class="googlePlus" xmlns="http://www.w3.org/1999/xhtml">http://plus.google.com/111221966647232053570/</a>
- </li>
- </ul>
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- <div class="row middleRow">
- <div class="expandTop">
- <div class="left"></div>
- <div class="right"></div>
- </div>
- </div>
- </div>
- <div id="buttomRowWrapper" class="bg_default">
- <div class="row buttomRow bg_default">
- <div class="bottom">
- <div class="left">
- <a id="grip" class="menu-icon" href="javascript:void(0)"></a>
-
- <div id="drawer">
- <div class="toc">
-
- <nav>
- <ul class="navL1">
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Technologies">Technologies</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/cloud-app-development-msdn" title="Cloud">Cloud</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/app-development-msdn" title="App Development">App Development</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/web-app-development-msdn" title="Web">Web</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/big-data-development-msdn" title="Data">Data</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/games-development-msdn" title="Gaming">Gaming</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/internetofthings" title="Internet of Things">Internet of Things</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Downloads">Downloads</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://www.visualstudio.com/downloads/download-visual-studio-vs" title="Visual Studio">Visual Studio</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/subscriptions" title="MSDN subscription access">MSDN subscription access</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/microsoft-sdks-msdn" title="SDKs">SDKs</a>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Trial software">Trial software</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/evalcenter" title="Free downloads">Free downloads</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/officeevaluationresources" title="Office resources">Office resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/sharepoint2013resources" title="SharePoint Server 2013 resources">SharePoint Server 2013 resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/sqlserver2014expressresources" title="SQL Server 2014 Express resources">SQL Server 2014 Express resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/windowsserver2012r2resources" title="Windows Server 2012 resources">Windows Server 2012 resources</a>
- </li>
- </ul>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Programs">Programs</a>
- <ul class="navL2">
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Visual Studio subscriptions">Visual Studio subscriptions</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/msdn-subscriptions-overview" title="Overview">Overview</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/benefits-overview" title="Benefits">Benefits</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/msdn-subscriptions-administration" title="Administrators">Administrators</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Students">Students</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/imagine/imagine-home" title="Microsoft Imagine">Microsoft Imagine</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/microsoftstudentpartners" title="Microsoft Student Partners">Microsoft Student Partners</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Architects">Architects</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-overview-msdn" title="Overview">Overview</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-case-studies-msdn" title="Case studies">Case studies</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-blueprints-msdn" title="Blueprints">Blueprints</a>
- </li>
- <li class="inactive">
- <a href="http://blogs.msdn.com/b/msarchitecture/" title="Blog">Blog</a>
- </li>
- <li class="inactive">
- <a href="http://social.msdn.microsoft.com/forums/en-us/home?brandignore=true&sort=relevancedesc&searchterm=architecture+or+architect" title="Forums">Forums</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/applicationbuilder" title="ISV">ISV</a>
-
- </li>
- <li class="inactive">
- <a href="https://www.microsoft.com/bizspark" title="Startups">Startups</a>
-
- </li>
- <li class="inactive">
- <a href="https://rewards.msdn.microsoft.com/" title="TechRewards">TechRewards</a>
-
- </li>
- <li class="inactive">
- <a href="http://events.msdn.microsoft.com/" title="Events">Events</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Community">Community</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/magazine/dd767791" title="Magazine">Magazine</a>
-
- </li>
- <li class="inactive">
- <a href="https://social.msdn.microsoft.com/forums/" title="Forums">Forums</a>
-
- </li>
- <li class="inactive">
- <a href="http://blogs.msdn.com/b/developer-tools/" title="Blogs">Blogs</a>
-
- </li>
- <li class="inactive">
- <a href="http://tech-advisors.msdn.microsoft.com/en-us" title="Tech Advisors">Tech Advisors</a>
-
- </li>
- <li class="inactive">
- <a href="http://channel9.msdn.com/" title="Channel 9">Channel 9</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive current toggle">
- <a href="javascript:void(0)" title="Documentation">Documentation</a>
- <ul class="navL2">
- <li class="inactive current">
- <a href="https://msdn.microsoft.com/library" title="APIs and reference">APIs and reference</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/developer-centers-msdn" title="Dev centers">Dev centers</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive">
- <a href="https://code.msdn.microsoft.com/" title="Samples">Samples</a>
- </li>
- </ul>
- </nav>
- </div>
- </div>
- </div>
- <div class="right">
- <div data-fragmentname="SearchBox" id="Fragment_SearchBox" xmlns="http://www.w3.org/1999/xhtml">
- <div class="SearchBox">
- <form id="HeaderSearchForm" name="HeaderSearchForm" method="get">
- <button id="FakeHeaderSearchButton" value="Search" type="submit" class="header-search-button">
- <div id="search-finder" class="search-finder"></div>
- </button>
- <button id="HeaderSearchButton" style="display:none"></button>
- <div id="searchSplitter"></div>
- <div id="searchCloseIcon" class="search-clear-x"></div>
- <div id="searchTextContainer" style="width: 0;">
- <input id="HeaderSearchTextBox" name="query" type="text" maxlength="200" onfocus="Epx.Controls.SearchBox.watermarkFocus(event, this.title)" onblur="Epx.Controls.SearchBox.watermarkBlur(event, this.title)">
- </div>
- </form>
-
-
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- </header>
- </div>
-
-
-
- <div class="printExportMenus ltr">
- <a id="isd_printABook" href="http://msdn.microsoft.com/en-us/library/export/help/(d=printer)?returnurl=%2fen-us%2flibrary%2fhh706279(d%3dprinter,v%3dvs.85).aspx%3flan%3dcsharp%26cc%3dn%26trm%3dtra%26view%3dbook">
- Export (<span class="count">0</span>)
- </a>
- <a id="isd_print" href="https://msdn.microsoft.com/en-us/library/hh706279(d=printer,v=vs.85).aspx?lan=csharp&cc=n&trm=tra&view=book" rel="nofollow">
- Print
- </a>
- <a id="isd_archiveControl" style="display:none;" data-include-archive="Include Previous Version" data-exclude-archive="Exclude Previous Version">
- </a>
- </div>
-
- <div class="printExportMenus ltr">
- <a id="expandCollapseAll" accesskey="e" href="javascript:void(0)" title="Expand/Collapse all sections by pressing Ctrl + Shift + e">Expand All</a>
- </div>
-
- <div id="body" ms.pgarea="body">
- <span id="tabletView_large"></span>
- <span id="tabletView_small"></span>
- <span id="mobileView"></span>
-
- <div id="content" class="content">
- <input type="hidden" id="printForPab" value="true">
-
- <div class="topic" xmlns="http://www.w3.org/1999/xhtml">
- <h1 class="title">KMDF as a generic driver pair model</h1>
-
- <div id="mainSection">
- <div class="clsServerSDKContent">
- </div>
- <p>In this topic, we discuss the idea that the Kernel Mode Driver Framework can be viewed as a generic driver pair model. Before you read this topic, you should understand the ideas presented in <a href="https://msdn.microsoft.com/en-us/library/hh439643(v=vs.85).aspx">Minidrivers and driver pairs</a>.</p>
- <p>Over the years, Microsoft has created several technology-specific driver models that use this paradigm:</p>
- <ul>
- <li>The driver is split into two pieces: one that handles general processing and one that handles processing that is specific to a particular device.</li>
- <li>The general piece, called the Framework, is written by Microsoft.</li>
- <li>The specific piece, called the KMDF driver, may be written by Microsoft or an independent hardware vendor.</li>
- </ul><img id="kmdfdriverpair" alt="Diagram of KMDF as a Generic Driver Pair" src="./Windows Kernel Development Articles (2016-03-30)_files/IC831360.png" title="Diagram of KMDF as a Generic Driver Pair" xmlns=""><p>The Framework portion of the driver pair performs general tasks that are common to a wide variety of drivers. For example, the Framework can handle I/O request queues, thread synchronization, and a large portion of the power management duties.</p>
- <p>The Framework owns the dispatch table for the KMDF driver, so when someone sends an I/O request packet (IRP) to the (KMDF driver, Framework) pair, the IRP goes to Framework. If the Framework can handle the IRP by itself, the KMDF driver is not involved. If the Framework cannot handle the IRP by itself, it gets help by calling event handlers implemented by the KMDF driver. Here are some examples of event handlers that might be implemented by a KMDF driver.</p>
- <ul>
- <li>
- <a href="https://msdn.microsoft.com/en-us/library/ff540880(v=vs.85).aspx"><em xmlns="http://www.w3.org/1999/xhtml">EvtDevicePrepareHardware</em></a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/en-us/library/ff541776(v=vs.85).aspx"><em xmlns="http://www.w3.org/1999/xhtml">EvtIoRead</em></a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/en-us/library/ff541758(v=vs.85).aspx"><em xmlns="http://www.w3.org/1999/xhtml">EvtIoDeviceControl</em></a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/en-us/library/ff541735(v=vs.85).aspx"><em xmlns="http://www.w3.org/1999/xhtml">EvtInterruptIsr</em></a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/en-us/library/ff541721(v=vs.85).aspx"><em xmlns="http://www.w3.org/1999/xhtml">EvtInterruptDpc</em></a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/en-us/library/ff540874(v=vs.85).aspx"><em xmlns="http://www.w3.org/1999/xhtml">EvtDevicePnpStateChange</em></a>
- </li>
- </ul>
- <p>For example, a USB 2.0 host controller driver has a specific piece named usbehci.sys and a general piece named usbport.sys. Usbehci.sys, which is called the USB 2.0 Miniport driver, has code that is specific to USB 2.0 host controllers. Usbport.sys, which is called the USB Port driver, has general code that applies to both USB 2.0 and USB 1.0. The pair of drivers (usbehci.sys, usbport.sys) combine to form a single WDM driver for a USB 2.0 host controller.</p>
- <p> The (specific, general) driver pairs have a variety of names across different device technologies. Most of the device-specific drivers have the prefix <em>mini</em>. The general drivers are often called port or class drivers. Here are some examples of (specific, general) pairs:</p>
- <ul>
- <li>(display miniport driver, display port driver)</li>
- <li>(USB miniport driver, USB port driver)</li>
- <li>(battery miniclass driver, battery class driver)</li>
- <li>(HID minidriver, HID class driver)</li>
- <li>(storage miniport driver, storage port driver)</li>
- </ul>
- <p>As more and more driver pair models were developed, it became difficult to keep track of all the different ways to write a driver. Each model has it's own interface for communication between the device-specific driver and the general driver. The body of knowledge required to develop drivers for one device technology (for example, Audio) can be quite different from the body of knowledge required to develop drivers for another device technology (for example, Storage).</p>
- <p>Over time, developers realized that it would be good to have a single unified model for kernel-mode driver pairs. The Kernel Mode Driver Framework (KMDF), which was first available in Windows Vista, fulfills that need. A driver based on KMDF uses a paradigm that is similar to many of the technology-specific driver pair models.</p>
- <ul>
- <li>The driver is split into two pieces: one that handles general processing and one that handles processing that is specific to a particular device.</li>
- <li>The general piece, which is written by Microsoft, is called the Framework.</li>
- <li>The specific piece, which is written by Microsoft or an independent hardware vendor, is called the KMDF driver.</li>
- </ul>
- <p>The USB 3.0 host controller driver is an example of a driver based on KMDF. In this example, both drivers in the pair are written by Microsoft. The general driver is the Framework, and the device-specific driver is the USB 3.0 Host Controller Driver. This diagram illustrates the device node and device stack for a USB 3.0 host controller.</p><img id="KmdfAsPair01" alt="Diagram of device stack for USB 3 host controller" src="./Windows Kernel Development Articles (2016-03-30)_files/IC554550.png" title="Diagram of device stack for USB 3 host controller" xmlns=""><p>In the diagram, Usbxhci.sys is the USB 3.0 host controller driver. It is paired with Wdf01000.sys, which is the Framework. The (usbxhci.sys, wdf01000.sys) pair forms a single WDM driver that serves as the function driver for the USB 3.0 host controller. Notice that the driver pair occupies one level in the device stack and is represented by single device object. The single device object that represents the (usbxhci.sys, wdf01000.sys) pair is the functional device object (FDO) for the USB 3.0 host controller. </p>
- <p>In a (KMDF driver, Framework) pair, the Framework handles tasks that are common to a wide variety of kernel-mode drivers. For example, the Framework can handle queuing of I/O requests, thread synchronization, most of the Plug and Play tasks, and most of the power management tasks. The KMDF driver handles tasks that require interaction with a specific device. The KMDF driver participates in processing requests by registering event handlers that the Framework calls as needed.</p>
- <h2><a id="related_topics"></a>Related topics</h2>
- <dl>
- <dt>
- <a href="https://msdn.microsoft.com/en-us/library/hh439643(v=vs.85).aspx">Minidrivers and driver pairs</a>
- </dt>
- <dt>
- <a href="https://msdn.microsoft.com/en-us/library/ff544396(v=vs.85).aspx">Kernel-Mode Driver Framework</a>
- </dt>
- </dl>
- <p> </p>
- <p> </p>
- <p><a href="mailto:wsddocfb@microsoft.com?subject=Documentation%20feedback%20[wdkgetstart\wdkgetstart]:%20KMDF%20as%20a%20generic%20driver%20pair%20model%20%20RELEASE:%20(3/4/2016)&body=%0A%0APRIVACY%20STATEMENT%0A%0AWe%20use%20your%20feedback%20to%20improve%20the%20documentation.%20We%20don%27t%20use%20your%20email%20address%20for%20any%20other%20purpose,%20and%20we%27ll%20remove%20your%20email%20address%20from%20our%20system%20after%20the%20issue%20that%20you%27re%20reporting%20is%20fixed.%20While%20we%27re%20working%20to%20fix%20this%20issue,%20we%20might%20send%20you%20an%20email%20message%20to%20ask%20for%20more%20info.%20Later,%20we%20might%20also%20send%20you%20an%20email%20message%20to%20let%20you%20know%20that%20we%27ve%20addressed%20your%20feedback.%0A%0AFor%20more%20info%20about%20Microsoft%27s%20privacy%20policy,%20see%20http://privacy.microsoft.com/en-us/default.aspx." title="Send comments about this topic to Microsoft">Send comments about this topic to Microsoft</a></p>
- </div>
- </div>
-
- </div>
- </div>
- <div class="clear"></div>
-
- <input name="__RequestVerificationToken" type="hidden" value="vqpb_ePFce_gqaGhRlYFC089bA4cLLWO3ggyM1AjukNO7ZM7sVMg4MXPw8Jtllo8pYojkZBFliwDknTcQnMlXvG4w0k1">
- <input id="ratingValueSubmitUrl" type="hidden" value="https://msdn.microsoft.com/en-us/library/feedback/rate/hh706279(d=printer,v=vs.85).aspx">
- <input id="ratingAdditionalSubmitUrl" type="hidden" value="https://msdn.microsoft.com/en-us/library/feedback/additional/hh706279(d=printer,v=vs.85).aspx">
- <input id="isTopicRated" type="hidden" value="false">
- <div id="lib-footer" ms.pgarea="body">
-
-
- <link type="text/css" rel="stylesheet">
-
- <div id="ux-footer" class="" style="" dir="ltr">
-
- <div id="footerSock" class="librarySock both">
- <div id="footerSockInner">
- <a name="feedback"></a>
- <div class="rating">
- <div id="ratingSection1">
- <div class="title">
- Was this page helpful?
- </div>
- <div class="description">
- Your feedback about this content is important.<br>Let us know what you think.
- </div>
- <div class="buttons">
- <button class="button" id="ratingYes" aria-label="Yes, this page was helpful">Yes</button>
- <button class="button" id="ratingNo" aria-label="No, this page was not helpful">No</button>
- </div>
- <input id="ratingValue" type="hidden" value="">
- </div>
- <div id="ratingSection2">
- <div class="title left">
- Additional feedback?
- </div>
- <textarea id="ratingText" rows="6" cols="" maxlength="1500"></textarea>
- <div class="right">
- <div class="counter">
- <span id="feedbackTextCounter">1500</span> characters remaining
- </div>
- <div class="buttons">
- <button class="button" id="ratingSubmit" aria-label="Submit my additional feedback">Submit</button>
- <button class="button" id="ratingSkipThis" aria-label="Skip additional feedback">Skip this</button>
- </div>
- </div>
- </div>
- <div id="ratingSection3">
- <div class="title">
- Thank you!
- </div>
- <div class="description">
- We appreciate your feedback.
- </div>
- </div>
-
-
- <div id="contentFeedbackQAContainer" style="display: none;"></div>
- </div>
-
- <div class="userVoice">
- <div class="title">
- Help us improve MSDN.
- </div>
- <div class="description">
- Visit our UserVoice Page to submit and vote on ideas!
- </div>
- <div class="buttons">
- <a class="button" id="userVoiceButton" href="http://feedback.msdn.com/forums/257782-msdn-feature-suggestions/category/83975" target="_blank">Make a suggestion</a>
- </div>
- </div>
- <div class="clear"></div>
- </div>
- </div>
- <footer class="top">
- <div data-fragmentname="LeftLinks" id="Fragment_LeftLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Dev centers</div>
- <ul class="links">
- <li>
- <a href="https://dev.windows.com/" id="LeftLinks_2148_1" class="windowsBlue" xmlns="http://www.w3.org/1999/xhtml">Windows</a>
- </li>
- <li>
- <a href="http://dev.office.com/" id="LeftLinks_2148_3" class="office" xmlns="http://www.w3.org/1999/xhtml">Office</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/vstudio" id="LeftLinks_2148_4" class="visualStudio" xmlns="http://www.w3.org/1999/xhtml">Visual Studio</a>
- </li>
- <li>
- <a href="http://azure.microsoft.com/en-us/documentation/" target="_blank" id="LeftLinks_2148_12" xmlns="http://www.w3.org/1999/xhtml">Microsoft Azure</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/developer-centers-msdn" id="LeftLinks_2148_5" xmlns="http://www.w3.org/1999/xhtml">More...</a>
- </li>
- </ul>
- </div>
- </div>
- <div id="rightLinks">
- <div data-fragmentname="CenterLinks1" id="Fragment_CenterLinks1" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Learning resources</div>
- <ul class="links">
- <li>
- <a href="http://www.microsoftvirtualacademy.com/" id="CenterLinks1_2151_4" xmlns="http://www.w3.org/1999/xhtml">Microsoft Virtual Academy</a>
- </li>
- <li>
- <a href="http://channel9.msdn.com/" id="CenterLinks1_2151_5" xmlns="http://www.w3.org/1999/xhtml">Channel 9</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/magazine/" id="CenterLinks1_2151_7" xmlns="http://www.w3.org/1999/xhtml">MSDN Magazine</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks2" id="Fragment_CenterLinks2" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Community</div>
- <ul class="links">
- <li>
- <a href="https://social.msdn.microsoft.com/forums/en-us/home" id="CenterLinks2_2151_8" xmlns="http://www.w3.org/1999/xhtml">Forums</a>
- </li>
- <li>
- <a href="http://blogs.msdn.com/b/developer-tools/" id="CenterLinks2_2151_9" xmlns="http://www.w3.org/1999/xhtml">Blogs</a>
- </li>
- <li>
- <a href="http://www.codeplex.com/" id="CenterLinks2_2151_10" xmlns="http://www.w3.org/1999/xhtml">Codeplex</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks3" id="Fragment_CenterLinks3" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Support</div>
- <ul class="links">
- <li>
- <a href="https://msdn.microsoft.com/hh361695" id="CenterLinks3_2151_11" xmlns="http://www.w3.org/1999/xhtml">Self support</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks4" id="Fragment_CenterLinks4" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Programs</div>
- <ul class="links">
- <li>
- <a href="https://www.microsoft.com/bizspark/" id="CenterLinks4_2151_13" xmlns="http://www.w3.org/1999/xhtml">BizSpark (for startups)</a>
- </li>
- <li>
- <a href="https://www.dreamspark.com/" id="CenterLinks4_2151_14" xmlns="http://www.w3.org/1999/xhtml">DreamSpark</a>
- </li>
- <li>
- <a href="http://www.imaginecup.com/" id="CenterLinks4_2151_17" xmlns="http://www.w3.org/1999/xhtml">Imagine Cup</a>
- </li>
- </ul>
- </div>
- </div>
- </div>
- </footer>
- <footer class="bottom">
- <span class="localeContainer">
-
- <form class="selectLocale" id="selectLocaleForm" action="https://msdn.microsoft.com/en-us/selectlocale-dmc">
- <input type="hidden" name="fromPage" value="https%3a%2f%2fmsdn.microsoft.com%2fen-us%2flibrary%2fhh706279(d%3dprinter%2cv%3dvs.85).aspx%3flan%3dCSharp%26cc%3dn%26trm%3dtra%26view%3dbook">
- <a href="http://msdn.microsoft.com/#" onclick="$('#selectLocaleForm').submit();return false;" title="Change your language">United States (English)</a>
- </form>
- </span>
- <div data-fragmentname="BottomLinks" id="Fragment_BottomLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <ul class="links horizontal">
- <li>
- <a href="https://msdn.microsoft.com/newsletter.aspx" id="BottomLinks_2148_7" xmlns="http://www.w3.org/1999/xhtml">Newsletter</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/dn529288" id="BottomLinks_2148_8" xmlns="http://www.w3.org/1999/xhtml">Privacy & cookies</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/cc300389" id="BottomLinks_2148_9" xmlns="http://www.w3.org/1999/xhtml">Terms of use</a>
- </li>
- <li>
- <a href="https://www.microsoft.com/en-us/legal/intellectualproperty/Trademarks/EN-US.aspx" id="BottomLinks_2148_10" xmlns="http://www.w3.org/1999/xhtml">Trademarks</a>
- </li>
- </ul>
- </div>
- </div>
- <span class="logoLegal">
- <span class="logo"></span>
- <span class="copyright">© 2016 Microsoft</span>
- </span>
- </footer>
- </div>
-
- </div>
- <div class="footerPrintView">
- <div class="footerCopyrightPrintView">© 2016 Microsoft</div>
- </div>
-
-
-
-
- <input id="tocPaddingPerLevel" type="hidden" value="17">
- <input id="MtpsDevice" type="hidden" value="Printer">
- <!--[CDATA[ Third party scripts and code linked to or referenced from this website are licensed to you by the parties that own such code, not by Microsoft. See ASP.NET Ajax CDN Terms of Use – http://www.asp.net/ajaxlibrary/CDN.ashx. ]]-->
-
-
-
-
-
- <noscript><div><img alt="DCSIMG" id="Img1" width="1" height="1" src="https://m.webtrends.com/dcsmgru7m99k7mqmgrhudo0k8_8c6m/njs.gif?dcsuri=/nojavascript&amp;WT.js=No" /></div></noscript>
- <div id="globalRequestVerification">
- <input name="__RequestVerificationToken" type="hidden" value="RNt1vz-tqj7psDH9eFA7CHnC8SMUnoMR4c1bJEZbZtL6tI2jXP21VmkTZ0wIMiikyyzHe6qIBfPBAwWF8u77sHsxiDE1">
- </div>
- </div>
-
-
-
-
-
-
- <script type="text/javascript" class="mtps-injected">
- /*<![CDATA[*/
- (function(window,document){"use strict";function preload(scripts){for(var result=[],script,e,i=0;i<scripts.length;i++)script=scripts[i],script.hasOwnProperty("url")&&(e=document.createElement("script"),e.src=script.url,script.throwaway=e),result.push(script);return result}function inject(scripts,index){var script,elem;if(index>=scripts.length){delete mtps.injectScripts;return}script=scripts[index];elem=document.createElement("script");elem.className="mtps-injected";elem.async=!1;var isLoaded=!1,timeoutId=0,injectNextFnName="",injectNext=elem.onerror=function(){isLoaded||(isLoaded=!0,inject(scripts,index+1),window.clearTimeout(timeoutId),elem.onload=elem.onerror=elem.onreadystatechange=null,injectNextFnName&&delete mtps[injectNextFnName],elem.removeEventListener&&elem.removeEventListener("load",injectNext,!1))};elem.addEventListener?elem.addEventListener("load",injectNext,!1):elem.readyState==="uninitialized"?elem.onreadystatechange=function(){(this.readyState==="loaded"||this.readyState==="complete")&&injectNext()}:elem.onload=injectNext;script.hasOwnProperty("url")?(timeoutId=window.setTimeout(injectNext,12e4),elem.src=script.url):(injectNextFnName="_injectNextScript_"+index,mtps[injectNextFnName]=injectNext,timeoutId=window.setTimeout(injectNext,2e3),elem.text="try {\n"+script.txt+"\n} finally { MTPS."+injectNextFnName+" && MTPS."+injectNextFnName+"(); }");parent.appendChild(elem)}var mtps=window.MTPS||(window.MTPS={}),parent=document.getElementsByTagName("head")[0];mtps.injectScripts=function(scripts){inject(preload(scripts),0)}})(window,document);
- MTPS.injectScripts([
- { txt: "/**/\r\n(window.MTPS || (window.MTPS = {})).cdnDomains || (window.MTPS.cdnDomains = { \r\n\t\"image\": \"https://i-msdn.sec.s-msft.com\", \r\n\t\"js\": \"https://i2-msdn.sec.s-msft.com\", \r\n\t\"css\": \"https://i-msdn.sec.s-msft.com\", \r\n\t\"ttf\": \"https://i-msdn.sec.s-msft.com\"\r\n});\r\n/**/" },
- { txt: "//\n var literalNormalizedUrl = \u0027/en-us/library/hh706279(d=printer,l=en-us,v=vs.85).aspx\u0027;\n var wt_nvr_ru = \u0027WT_NVR_RU\u0027;\n var wt_fpcdom = \u0027.microsoft.com\u0027;\n var wt_domlist = \u0027msdn.microsoft.com\u0027;\n var wt_pathlist = \u0027\u0027;\n var wt_paramlist = \u0027DCSext.mtps_devcenter\u0027;\n var wt_siteid = \u0027MSDN\u0027;\n var gDomain = \u0027m.webtrends.com\u0027;\n var gDcsId = \u0027dcsmgru7m99k7mqmgrhudo0k8_8c6m\u0027;\n var gFpc = \u0027WT_FPC\u0027;\n\n\n\n if (document.cookie.indexOf(gFpc + \"=\") == -1) {\n var wtidJs = document.createElement(\"script\");\n wtidJs.src = \"//\" + gDomain + \"/\" + gDcsId + \"/wtid.js\";\n document.getElementsByTagName(\"head\")[0].appendChild(wtidJs);\n }\n\n\n\n var detectedLocale = \u0027en-us\u0027;\n var wtsp = \u0027msdnlib_w32_com\u0027;\n var gTrackEvents = \u00270\u0027;\n/**/" },
- { txt: "//\n\n window.appInsightsId = \u00275eb1b2eb-c47a-497a-a7ac-a1c230b2882f\u0027;\n //" },
- { url: "https://i2-msdn.sec.s-msft.com/Combined.js?resources=0:Utilities,1:Layout,2:Header,1:Rating,2:Footer,0:Topic,3:PabTopic,4:webtrendsscript,0:AppInsightsPerf,0:ABTestControl,5:WEDCS,3:CmpgrpForHeader,0:livefyre,0:Comment,1:SearchBox;/Areas/Epx/Content/Scripts:0,/Areas/Epx/Themes/Base/Content:1,/Areas/Centers/Themes/StandardDevCenter/Content:2,/Areas/Library/Content:3,/Areas/Global/Content/Webtrends/resources:4,/Areas/Library/Themes/Base/Content:5\u0026amp;hashKey=30CEE944AABFEA2C5A338BDB9E000732\u0026amp;v=AE608271C0243AAA0449D3BC0FAD8EB4" },
- { url: "https://i1.services.social.microsoft.com/search/Widgets/SearchBox.jss?boxid=HeaderSearchTextBox\u0026btnid=HeaderSearchButton\u0026pgArea=header\u0026brand=Msdn\u0026loc=en-us\u0026focusOnInit=false\u0026emptyWatermark=true\u0026searchButtonTooltip=Search MSDN" },
- { url: "https://i2-msdn.sec.s-msft.com/Combined.js?resources=0:PrintExportButton,1:Toc_Fixed,1:CodeSnippet,1:TopicNotInScope,1:CollapsibleArea,1:VersionSelector,1:SurveyBroker;/Areas/Library/Themes/Base/Content:0,/Areas/Epx/Content/Scripts:1\u0026amp;hashKey=80F30894E3FB8A3295C923AEC7019CFE\u0026amp;v=AE608271C0243AAA0449D3BC0FAD8EB4" },
- { txt: "$(document).ready(function() {\n try {\n var token = $(\"#globalRequestVerification input[name=\u0027__RequestVerificationToken\u0027]\").clone();\n $(\"#siteFeedbackForm\").append(token);\n } catch(err) {\n \n }\n });" }
- ]);
- /*]]>*/
- </script>
- <link rel="stylesheet" type="text/css" href="./Windows Kernel Development Articles (2016-03-30)_files/Combined.css">
- <div id="page">
-
-
-
-
- <link type="text/css" rel="stylesheet">
-
- <input type="hidden" id="isHeaderBleeding" value="true">
- <div id="ux-header" dir="ltr" class="ltr msdn">
-
- <header>
- <span id="singleCol"></span>
- <span id="doubleCol"></span>
- <span id="isMobile"></span>
- <div>
- <div class="row topRow">
- <div class="top">
- <div class="left">
- <a class="msdnLogoImg" href="https://msdn.microsoft.com/en-us" title="MSDN home">
- <div id="msft-logo" class="msft-logo"></div>
- </a>
- <div class="GrayPipe"></div>
- <a class="DevCenterFullNameNonMegaBlade" href="https://msdn.microsoft.com/en-us">Developer Network</a>
- <a class="DevCenterFullName" href="https://msdn.microsoft.com/en-us">Developer Network</a>
- <a class="DevCenterShortName" href="https://msdn.microsoft.com/en-us">Developer</a>
- </div>
- <div class="right">
- <div id="signIn">
- <div class="profileImage"></div>
- <a class="scarabLink" href="https://login.live.com/login.srf?wa=wsignin1.0&rpsnv=12&ct=1459376422&rver=6.0.5276.0&wp=mcmbi&wlcxt=msdn%24msdn%24msdn&wreply=https%3a%2f%2fmsdn.microsoft.com%2fen-us%2flibrary%2fhh706278%2528d%3dprinter%2cv%3dvs.85%2529.aspx%3flan%3dcsharp%26cc%3dn%26trm%3dtra%26view%3dbook&lc=1033&id=254354&mkt=en-us" title="Sign in">Sign in</a></div>
- <div class="auxNav">
- <div>
- <div data-fragmentname="Subscriptions" id="Fragment_Subscriptions" xmlns="http://www.w3.org/1999/xhtml">
- <a href="https://msdn.microsoft.com/subscriptions/manage/hh442900" id="Subscriptions_2153_1" xmlns="http://www.w3.org/1999/xhtml">MSDN subscriptions</a>
- </div>
- <div data-fragmentname="GetTools" id="Fragment_GetTools" xmlns="http://www.w3.org/1999/xhtml">
- <a href="http://go.microsoft.com/fwlink/?LinkId=309297&clcid=0x409&slcid=0x409&campaign=o~msft~msdn~gettools-header~dn308572" id="GetTools_2153_3" xmlns="http://www.w3.org/1999/xhtml">Get tools</a>
- </div>
- </div>
- <div>
- <div data-fragmentname="SocialLinks" id="Fragment_SocialLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <ul class="links horizontal">
- <li>
- <a href="http://www.facebook.com/microsoftdeveloper" target="_blank" id="SocialLinks_2152_4" class="facebook" xmlns="http://www.w3.org/1999/xhtml">http://www.facebook.com/microsoftdeveloper</a>
- </li>
- <li>
- <a href="https://twitter.com/msdev" target="_blank" id="SocialLinks_2152_5" class="twitter" xmlns="http://www.w3.org/1999/xhtml">https://twitter.com/msdev</a>
- </li>
- <li>
- <a href="http://plus.google.com/111221966647232053570/" target="_blank" id="SocialLinks_2152_6" class="googlePlus" xmlns="http://www.w3.org/1999/xhtml">http://plus.google.com/111221966647232053570/</a>
- </li>
- </ul>
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- <div class="row middleRow">
- <div class="expandTop">
- <div class="left"></div>
- <div class="right"></div>
- </div>
- </div>
- </div>
- <div id="buttomRowWrapper" class="bg_default">
- <div class="row buttomRow bg_default">
- <div class="bottom">
- <div class="left">
- <a id="grip" class="menu-icon" href="javascript:void(0)"></a>
-
- <div id="drawer">
- <div class="toc">
-
- <nav>
- <ul class="navL1">
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Technologies">Technologies</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/cloud-app-development-msdn" title="Cloud">Cloud</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/app-development-msdn" title="App Development">App Development</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/web-app-development-msdn" title="Web">Web</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/big-data-development-msdn" title="Data">Data</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/games-development-msdn" title="Gaming">Gaming</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/internetofthings" title="Internet of Things">Internet of Things</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Downloads">Downloads</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://www.visualstudio.com/downloads/download-visual-studio-vs" title="Visual Studio">Visual Studio</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/subscriptions" title="MSDN subscription access">MSDN subscription access</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/microsoft-sdks-msdn" title="SDKs">SDKs</a>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Trial software">Trial software</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/evalcenter" title="Free downloads">Free downloads</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/officeevaluationresources" title="Office resources">Office resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/sharepoint2013resources" title="SharePoint Server 2013 resources">SharePoint Server 2013 resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/sqlserver2014expressresources" title="SQL Server 2014 Express resources">SQL Server 2014 Express resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/windowsserver2012r2resources" title="Windows Server 2012 resources">Windows Server 2012 resources</a>
- </li>
- </ul>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Programs">Programs</a>
- <ul class="navL2">
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Visual Studio subscriptions">Visual Studio subscriptions</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/msdn-subscriptions-overview" title="Overview">Overview</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/benefits-overview" title="Benefits">Benefits</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/msdn-subscriptions-administration" title="Administrators">Administrators</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Students">Students</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/imagine/imagine-home" title="Microsoft Imagine">Microsoft Imagine</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/microsoftstudentpartners" title="Microsoft Student Partners">Microsoft Student Partners</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Architects">Architects</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-overview-msdn" title="Overview">Overview</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-case-studies-msdn" title="Case studies">Case studies</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-blueprints-msdn" title="Blueprints">Blueprints</a>
- </li>
- <li class="inactive">
- <a href="http://blogs.msdn.com/b/msarchitecture/" title="Blog">Blog</a>
- </li>
- <li class="inactive">
- <a href="http://social.msdn.microsoft.com/forums/en-us/home?brandignore=true&sort=relevancedesc&searchterm=architecture+or+architect" title="Forums">Forums</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/applicationbuilder" title="ISV">ISV</a>
-
- </li>
- <li class="inactive">
- <a href="https://www.microsoft.com/bizspark" title="Startups">Startups</a>
-
- </li>
- <li class="inactive">
- <a href="https://rewards.msdn.microsoft.com/" title="TechRewards">TechRewards</a>
-
- </li>
- <li class="inactive">
- <a href="http://events.msdn.microsoft.com/" title="Events">Events</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Community">Community</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/magazine/dd767791" title="Magazine">Magazine</a>
-
- </li>
- <li class="inactive">
- <a href="https://social.msdn.microsoft.com/forums/" title="Forums">Forums</a>
-
- </li>
- <li class="inactive">
- <a href="http://blogs.msdn.com/b/developer-tools/" title="Blogs">Blogs</a>
-
- </li>
- <li class="inactive">
- <a href="http://tech-advisors.msdn.microsoft.com/en-us" title="Tech Advisors">Tech Advisors</a>
-
- </li>
- <li class="inactive">
- <a href="http://channel9.msdn.com/" title="Channel 9">Channel 9</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive current toggle">
- <a href="javascript:void(0)" title="Documentation">Documentation</a>
- <ul class="navL2">
- <li class="inactive current">
- <a href="https://msdn.microsoft.com/library" title="APIs and reference">APIs and reference</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/developer-centers-msdn" title="Dev centers">Dev centers</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive">
- <a href="https://code.msdn.microsoft.com/" title="Samples">Samples</a>
- </li>
- </ul>
- </nav>
- </div>
- </div>
- </div>
- <div class="right">
- <div data-fragmentname="SearchBox" id="Fragment_SearchBox" xmlns="http://www.w3.org/1999/xhtml">
- <div class="SearchBox">
- <form id="HeaderSearchForm" name="HeaderSearchForm" method="get">
- <button id="FakeHeaderSearchButton" value="Search" type="submit" class="header-search-button">
- <div id="search-finder" class="search-finder"></div>
- </button>
- <button id="HeaderSearchButton" style="display:none"></button>
- <div id="searchSplitter"></div>
- <div id="searchCloseIcon" class="search-clear-x"></div>
- <div id="searchTextContainer" style="width: 0;">
- <input id="HeaderSearchTextBox" name="query" type="text" maxlength="200" onfocus="Epx.Controls.SearchBox.watermarkFocus(event, this.title)" onblur="Epx.Controls.SearchBox.watermarkBlur(event, this.title)">
- </div>
- </form>
-
-
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- </header>
- </div>
-
-
-
- <div class="printExportMenus ltr">
- <a id="isd_printABook" href="http://msdn.microsoft.com/en-us/library/export/help/(d=printer)?returnurl=%2fen-us%2flibrary%2fhh706278(d%3dprinter,v%3dvs.85).aspx%3flan%3dcsharp%26cc%3dn%26trm%3dtra%26view%3dbook">
- Export (<span class="count">0</span>)
- </a>
- <a id="isd_print" href="https://msdn.microsoft.com/en-us/library/hh706278(d=printer,v=vs.85).aspx?lan=csharp&cc=n&trm=tra&view=book" rel="nofollow">
- Print
- </a>
- <a id="isd_archiveControl" style="display:none;" data-include-archive="Include Previous Version" data-exclude-archive="Exclude Previous Version">
- </a>
- </div>
-
- <div class="printExportMenus ltr">
- <a id="expandCollapseAll" accesskey="e" href="javascript:void(0)" title="Expand/Collapse all sections by pressing Ctrl + Shift + e">Expand All</a>
- </div>
-
- <div id="body" ms.pgarea="body">
- <span id="tabletView_large"></span>
- <span id="tabletView_small"></span>
- <span id="mobileView"></span>
-
- <div id="content" class="content">
- <input type="hidden" id="printForPab" value="true">
-
- <div class="topic" xmlns="http://www.w3.org/1999/xhtml">
- <h1 class="title">KMDF extensions and driver triples</h1>
-
- <div id="mainSection">
- <div class="clsServerSDKContent">
- </div>
- <p>In this topic, we discuss class-based extensions to the Kernel Mode Driver Framework (KMDF). Before you read this topic, you should understand the ideas presented in <a href="https://msdn.microsoft.com/en-us/library/hh439643(v=vs.85).aspx">Minidrivers and driver pairs</a> and <a href="https://msdn.microsoft.com/en-us/library/hh706279(v=vs.85).aspx">KMDF as a Generic Driver Pair Model</a>.</p>
- <p>For some device classes, Microsoft provides KMDF extensions that further reduce the amount of processing that must be performed by KMDF drivers. A driver that uses a class-based KMDF extension has these three pieces, which we call a <em>driver triple</em>.</p>
- <ul>
- <li>The Framework, which handles tasks common to most all drivers</li>
- <li>The class-based framework extension, which handles tasks that are specific to a particular class of devices</li>
- <li>The KMDF driver, which handles tasks that are specific to a particular device.</li>
- </ul>
- <p>The three drivers in a driver triple (KMDF driver, device-class KMDF extension, Framework) combine to form a single WDM driver.</p>
- <p>An example of a device-class KMDF extension is SpbCx.sys, which is the KMDF extension for the Simple Peripheral Bus (SPB) device class. The SPB class includes synchronous serial buses such as I2C and SPI. A driver triple for an I2C bus controller would look like this:</p>
- <ul>
- <li>The Framework handles general tasks that are common to most all drivers.</li>
- <li>SpbCx.sys handles tasks that are specific to the SPB bus class. These are tasks that are common to all SPB busses.</li>
- <li>The KMDF driver handles tasks that are specific to an I2C bus. Let's call this driver MyI2CBusDriver.sys.</li>
- </ul><img id="kmdfdrivertriple" alt="KMDF Driver Triple Extension" src="./Windows Kernel Development Articles (2016-03-30)_files/IC831359.png" title="KMDF Driver Triple Extension" xmlns=""><p>The three drivers in the driver triple (MyI2CBusDriver.sys, SpbCx.sys, Wdf01000.sys) combine to form a single WDM driver that serves as the function driver for the I2C bus controller. Wdf01000.sys (the Framework) owns the dispatch table for this driver, so when someone sends an IRP to the driver triple, it goes to the wdf01000.sys. If the wdf01000.sys can handle the IRP by itself, SpbCx.sys and MyI2CBusDriver.sys are not involved. If wdf01000.sys cannot handle the IRP by itself, it gets help by calling an event handler in SbpCx.sys.</p>
- <p></p>
- <p>Here are some examples of event handlers that might be implemented by MyI2CBusDriver.sys:</p>
- <ul>
- <li>EvtSpbControllerLock</li>
- <li>EvtSpbIoRead</li>
- <li>EvtSpbIoSequence</li>
- </ul>
- <p>Here are some examples of event handlers that are implemented by SpbCx.sys</p>
- <ul>
- <li>EvtIoRead</li>
- </ul>
- <p> </p>
- <p> </p>
- <p><a href="mailto:wsddocfb@microsoft.com?subject=Documentation%20feedback%20[wdkgetstart\wdkgetstart]:%20KMDF%20extensions%20and%20driver%20triples%20%20RELEASE:%20(3/4/2016)&body=%0A%0APRIVACY%20STATEMENT%0A%0AWe%20use%20your%20feedback%20to%20improve%20the%20documentation.%20We%20don%27t%20use%20your%20email%20address%20for%20any%20other%20purpose,%20and%20we%27ll%20remove%20your%20email%20address%20from%20our%20system%20after%20the%20issue%20that%20you%27re%20reporting%20is%20fixed.%20While%20we%27re%20working%20to%20fix%20this%20issue,%20we%20might%20send%20you%20an%20email%20message%20to%20ask%20for%20more%20info.%20Later,%20we%20might%20also%20send%20you%20an%20email%20message%20to%20let%20you%20know%20that%20we%27ve%20addressed%20your%20feedback.%0A%0AFor%20more%20info%20about%20Microsoft%27s%20privacy%20policy,%20see%20http://privacy.microsoft.com/en-us/default.aspx." title="Send comments about this topic to Microsoft">Send comments about this topic to Microsoft</a></p>
- </div>
- </div>
-
- </div>
- </div>
- <div class="clear"></div>
-
- <input name="__RequestVerificationToken" type="hidden" value="j_myNCShbY91GYbpu6iC7z2w1tNLZPUMovJORjFTvRGbH8MxtKUcChxB50AgjQB157RA4Dc_yAly8kbhTf--RNnuH4U1">
- <input id="ratingValueSubmitUrl" type="hidden" value="https://msdn.microsoft.com/en-us/library/feedback/rate/hh706278(d=printer,v=vs.85).aspx">
- <input id="ratingAdditionalSubmitUrl" type="hidden" value="https://msdn.microsoft.com/en-us/library/feedback/additional/hh706278(d=printer,v=vs.85).aspx">
- <input id="isTopicRated" type="hidden" value="false">
- <div id="lib-footer" ms.pgarea="body">
-
-
- <link type="text/css" rel="stylesheet">
-
- <div id="ux-footer" class="" style="" dir="ltr">
-
- <div id="footerSock" class="librarySock both">
- <div id="footerSockInner">
- <a name="feedback"></a>
- <div class="rating">
- <div id="ratingSection1">
- <div class="title">
- Was this page helpful?
- </div>
- <div class="description">
- Your feedback about this content is important.<br>Let us know what you think.
- </div>
- <div class="buttons">
- <button class="button" id="ratingYes" aria-label="Yes, this page was helpful">Yes</button>
- <button class="button" id="ratingNo" aria-label="No, this page was not helpful">No</button>
- </div>
- <input id="ratingValue" type="hidden" value="">
- </div>
- <div id="ratingSection2">
- <div class="title left">
- Additional feedback?
- </div>
- <textarea id="ratingText" rows="6" cols="" maxlength="1500"></textarea>
- <div class="right">
- <div class="counter">
- <span id="feedbackTextCounter">1500</span> characters remaining
- </div>
- <div class="buttons">
- <button class="button" id="ratingSubmit" aria-label="Submit my additional feedback">Submit</button>
- <button class="button" id="ratingSkipThis" aria-label="Skip additional feedback">Skip this</button>
- </div>
- </div>
- </div>
- <div id="ratingSection3">
- <div class="title">
- Thank you!
- </div>
- <div class="description">
- We appreciate your feedback.
- </div>
- </div>
-
-
- <div id="contentFeedbackQAContainer" style="display: none;"></div>
- </div>
-
- <div class="userVoice">
- <div class="title">
- Help us improve MSDN.
- </div>
- <div class="description">
- Visit our UserVoice Page to submit and vote on ideas!
- </div>
- <div class="buttons">
- <a class="button" id="userVoiceButton" href="http://feedback.msdn.com/forums/257782-msdn-feature-suggestions/category/83975" target="_blank">Make a suggestion</a>
- </div>
- </div>
- <div class="clear"></div>
- </div>
- </div>
- <footer class="top">
- <div data-fragmentname="LeftLinks" id="Fragment_LeftLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Dev centers</div>
- <ul class="links">
- <li>
- <a href="https://dev.windows.com/" id="LeftLinks_2148_1" class="windowsBlue" xmlns="http://www.w3.org/1999/xhtml">Windows</a>
- </li>
- <li>
- <a href="http://dev.office.com/" id="LeftLinks_2148_3" class="office" xmlns="http://www.w3.org/1999/xhtml">Office</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/vstudio" id="LeftLinks_2148_4" class="visualStudio" xmlns="http://www.w3.org/1999/xhtml">Visual Studio</a>
- </li>
- <li>
- <a href="http://azure.microsoft.com/en-us/documentation/" target="_blank" id="LeftLinks_2148_12" xmlns="http://www.w3.org/1999/xhtml">Microsoft Azure</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/developer-centers-msdn" id="LeftLinks_2148_5" xmlns="http://www.w3.org/1999/xhtml">More...</a>
- </li>
- </ul>
- </div>
- </div>
- <div id="rightLinks">
- <div data-fragmentname="CenterLinks1" id="Fragment_CenterLinks1" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Learning resources</div>
- <ul class="links">
- <li>
- <a href="http://www.microsoftvirtualacademy.com/" id="CenterLinks1_2151_4" xmlns="http://www.w3.org/1999/xhtml">Microsoft Virtual Academy</a>
- </li>
- <li>
- <a href="http://channel9.msdn.com/" id="CenterLinks1_2151_5" xmlns="http://www.w3.org/1999/xhtml">Channel 9</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/magazine/" id="CenterLinks1_2151_7" xmlns="http://www.w3.org/1999/xhtml">MSDN Magazine</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks2" id="Fragment_CenterLinks2" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Community</div>
- <ul class="links">
- <li>
- <a href="https://social.msdn.microsoft.com/forums/en-us/home" id="CenterLinks2_2151_8" xmlns="http://www.w3.org/1999/xhtml">Forums</a>
- </li>
- <li>
- <a href="http://blogs.msdn.com/b/developer-tools/" id="CenterLinks2_2151_9" xmlns="http://www.w3.org/1999/xhtml">Blogs</a>
- </li>
- <li>
- <a href="http://www.codeplex.com/" id="CenterLinks2_2151_10" xmlns="http://www.w3.org/1999/xhtml">Codeplex</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks3" id="Fragment_CenterLinks3" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Support</div>
- <ul class="links">
- <li>
- <a href="https://msdn.microsoft.com/hh361695" id="CenterLinks3_2151_11" xmlns="http://www.w3.org/1999/xhtml">Self support</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks4" id="Fragment_CenterLinks4" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Programs</div>
- <ul class="links">
- <li>
- <a href="https://www.microsoft.com/bizspark/" id="CenterLinks4_2151_13" xmlns="http://www.w3.org/1999/xhtml">BizSpark (for startups)</a>
- </li>
- <li>
- <a href="https://www.dreamspark.com/" id="CenterLinks4_2151_14" xmlns="http://www.w3.org/1999/xhtml">DreamSpark</a>
- </li>
- <li>
- <a href="http://www.imaginecup.com/" id="CenterLinks4_2151_17" xmlns="http://www.w3.org/1999/xhtml">Imagine Cup</a>
- </li>
- </ul>
- </div>
- </div>
- </div>
- </footer>
- <footer class="bottom">
- <span class="localeContainer">
-
- <form class="selectLocale" id="selectLocaleForm" action="https://msdn.microsoft.com/en-us/selectlocale-dmc">
- <input type="hidden" name="fromPage" value="https%3a%2f%2fmsdn.microsoft.com%2fen-us%2flibrary%2fhh706278(d%3dprinter%2cv%3dvs.85).aspx%3flan%3dCSharp%26cc%3dn%26trm%3dtra%26view%3dbook">
- <a href="http://msdn.microsoft.com/#" onclick="$('#selectLocaleForm').submit();return false;" title="Change your language">United States (English)</a>
- </form>
- </span>
- <div data-fragmentname="BottomLinks" id="Fragment_BottomLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <ul class="links horizontal">
- <li>
- <a href="https://msdn.microsoft.com/newsletter.aspx" id="BottomLinks_2148_7" xmlns="http://www.w3.org/1999/xhtml">Newsletter</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/dn529288" id="BottomLinks_2148_8" xmlns="http://www.w3.org/1999/xhtml">Privacy & cookies</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/cc300389" id="BottomLinks_2148_9" xmlns="http://www.w3.org/1999/xhtml">Terms of use</a>
- </li>
- <li>
- <a href="https://www.microsoft.com/en-us/legal/intellectualproperty/Trademarks/EN-US.aspx" id="BottomLinks_2148_10" xmlns="http://www.w3.org/1999/xhtml">Trademarks</a>
- </li>
- </ul>
- </div>
- </div>
- <span class="logoLegal">
- <span class="logo"></span>
- <span class="copyright">© 2016 Microsoft</span>
- </span>
- </footer>
- </div>
-
- </div>
- <div class="footerPrintView">
- <div class="footerCopyrightPrintView">© 2016 Microsoft</div>
- </div>
-
-
-
-
- <input id="tocPaddingPerLevel" type="hidden" value="17">
- <input id="MtpsDevice" type="hidden" value="Printer">
- <!--[CDATA[ Third party scripts and code linked to or referenced from this website are licensed to you by the parties that own such code, not by Microsoft. See ASP.NET Ajax CDN Terms of Use – http://www.asp.net/ajaxlibrary/CDN.ashx. ]]-->
-
-
-
-
-
- <noscript><div><img alt="DCSIMG" id="Img1" width="1" height="1" src="https://m.webtrends.com/dcsmgru7m99k7mqmgrhudo0k8_8c6m/njs.gif?dcsuri=/nojavascript&amp;WT.js=No" /></div></noscript>
- <div id="globalRequestVerification">
- <input name="__RequestVerificationToken" type="hidden" value="yL38rwj5d46EiQaoL2PNFId2uSPnBSPsWLCXa03VLDditXmsN4Ok-ZG1XxShgYE3SqFYCM2GUZFam0DYWh2VkZDM3vs1">
- </div>
- </div>
-
-
-
-
-
-
- <script type="text/javascript" class="mtps-injected">
- /*<![CDATA[*/
- (function(window,document){"use strict";function preload(scripts){for(var result=[],script,e,i=0;i<scripts.length;i++)script=scripts[i],script.hasOwnProperty("url")&&(e=document.createElement("script"),e.src=script.url,script.throwaway=e),result.push(script);return result}function inject(scripts,index){var script,elem;if(index>=scripts.length){delete mtps.injectScripts;return}script=scripts[index];elem=document.createElement("script");elem.className="mtps-injected";elem.async=!1;var isLoaded=!1,timeoutId=0,injectNextFnName="",injectNext=elem.onerror=function(){isLoaded||(isLoaded=!0,inject(scripts,index+1),window.clearTimeout(timeoutId),elem.onload=elem.onerror=elem.onreadystatechange=null,injectNextFnName&&delete mtps[injectNextFnName],elem.removeEventListener&&elem.removeEventListener("load",injectNext,!1))};elem.addEventListener?elem.addEventListener("load",injectNext,!1):elem.readyState==="uninitialized"?elem.onreadystatechange=function(){(this.readyState==="loaded"||this.readyState==="complete")&&injectNext()}:elem.onload=injectNext;script.hasOwnProperty("url")?(timeoutId=window.setTimeout(injectNext,12e4),elem.src=script.url):(injectNextFnName="_injectNextScript_"+index,mtps[injectNextFnName]=injectNext,timeoutId=window.setTimeout(injectNext,2e3),elem.text="try {\n"+script.txt+"\n} finally { MTPS."+injectNextFnName+" && MTPS."+injectNextFnName+"(); }");parent.appendChild(elem)}var mtps=window.MTPS||(window.MTPS={}),parent=document.getElementsByTagName("head")[0];mtps.injectScripts=function(scripts){inject(preload(scripts),0)}})(window,document);
- MTPS.injectScripts([
- { txt: "/**/\r\n(window.MTPS || (window.MTPS = {})).cdnDomains || (window.MTPS.cdnDomains = { \r\n\t\"image\": \"https://i-msdn.sec.s-msft.com\", \r\n\t\"js\": \"https://i2-msdn.sec.s-msft.com\", \r\n\t\"css\": \"https://i-msdn.sec.s-msft.com\", \r\n\t\"ttf\": \"https://i-msdn.sec.s-msft.com\"\r\n});\r\n/**/" },
- { txt: "//\n var literalNormalizedUrl = \u0027/en-us/library/hh706278(d=printer,l=en-us,v=vs.85).aspx\u0027;\n var wt_nvr_ru = \u0027WT_NVR_RU\u0027;\n var wt_fpcdom = \u0027.microsoft.com\u0027;\n var wt_domlist = \u0027msdn.microsoft.com\u0027;\n var wt_pathlist = \u0027\u0027;\n var wt_paramlist = \u0027DCSext.mtps_devcenter\u0027;\n var wt_siteid = \u0027MSDN\u0027;\n var gDomain = \u0027m.webtrends.com\u0027;\n var gDcsId = \u0027dcsmgru7m99k7mqmgrhudo0k8_8c6m\u0027;\n var gFpc = \u0027WT_FPC\u0027;\n\n\n\n if (document.cookie.indexOf(gFpc + \"=\") == -1) {\n var wtidJs = document.createElement(\"script\");\n wtidJs.src = \"//\" + gDomain + \"/\" + gDcsId + \"/wtid.js\";\n document.getElementsByTagName(\"head\")[0].appendChild(wtidJs);\n }\n\n\n\n var detectedLocale = \u0027en-us\u0027;\n var wtsp = \u0027msdnlib_w32_com\u0027;\n var gTrackEvents = \u00270\u0027;\n/**/" },
- { txt: "//\n\n window.appInsightsId = \u00275eb1b2eb-c47a-497a-a7ac-a1c230b2882f\u0027;\n //" },
- { url: "https://i2-msdn.sec.s-msft.com/Combined.js?resources=0:Utilities,1:Layout,2:Header,1:Rating,2:Footer,0:Topic,3:PabTopic,4:webtrendsscript,0:AppInsightsPerf,0:ABTestControl,5:WEDCS,3:CmpgrpForHeader,0:livefyre,0:Comment,1:SearchBox;/Areas/Epx/Content/Scripts:0,/Areas/Epx/Themes/Base/Content:1,/Areas/Centers/Themes/StandardDevCenter/Content:2,/Areas/Library/Content:3,/Areas/Global/Content/Webtrends/resources:4,/Areas/Library/Themes/Base/Content:5\u0026amp;hashKey=30CEE944AABFEA2C5A338BDB9E000732\u0026amp;v=AE608271C0243AAA0449D3BC0FAD8EB4" },
- { url: "https://i1.services.social.microsoft.com/search/Widgets/SearchBox.jss?boxid=HeaderSearchTextBox\u0026btnid=HeaderSearchButton\u0026pgArea=header\u0026brand=Msdn\u0026loc=en-us\u0026focusOnInit=false\u0026emptyWatermark=true\u0026searchButtonTooltip=Search MSDN" },
- { url: "https://i2-msdn.sec.s-msft.com/Combined.js?resources=0:PrintExportButton,1:Toc_Fixed,1:CodeSnippet,1:TopicNotInScope,1:CollapsibleArea,1:VersionSelector,1:SurveyBroker;/Areas/Library/Themes/Base/Content:0,/Areas/Epx/Content/Scripts:1\u0026amp;hashKey=80F30894E3FB8A3295C923AEC7019CFE\u0026amp;v=AE608271C0243AAA0449D3BC0FAD8EB4" },
- { txt: "$(document).ready(function() {\n try {\n var token = $(\"#globalRequestVerification input[name=\u0027__RequestVerificationToken\u0027]\").clone();\n $(\"#siteFeedbackForm\").append(token);\n } catch(err) {\n \n }\n });" }
- ]);
- /*]]>*/
- </script>
- <link rel="stylesheet" type="text/css" href="./Windows Kernel Development Articles (2016-03-30)_files/Combined.css">
- <div id="page">
-
-
-
-
- <link type="text/css" rel="stylesheet">
-
- <input type="hidden" id="isHeaderBleeding" value="true">
- <div id="ux-header" dir="ltr" class="ltr msdn">
-
- <header>
- <span id="singleCol"></span>
- <span id="doubleCol"></span>
- <span id="isMobile"></span>
- <div>
- <div class="row topRow">
- <div class="top">
- <div class="left">
- <a class="msdnLogoImg" href="https://msdn.microsoft.com/en-us" title="MSDN home">
- <div id="msft-logo" class="msft-logo"></div>
- </a>
- <div class="GrayPipe"></div>
- <a class="DevCenterFullNameNonMegaBlade" href="https://msdn.microsoft.com/en-us">Developer Network</a>
- <a class="DevCenterFullName" href="https://msdn.microsoft.com/en-us">Developer Network</a>
- <a class="DevCenterShortName" href="https://msdn.microsoft.com/en-us">Developer</a>
- </div>
- <div class="right">
- <div id="signIn">
- <div class="profileImage"></div>
- <a class="scarabLink" href="https://login.live.com/login.srf?wa=wsignin1.0&rpsnv=12&ct=1459376424&rver=6.0.5276.0&wp=mcmbi&wlcxt=msdn%24msdn%24msdn&wreply=https%3a%2f%2fmsdn.microsoft.com%2fen-us%2flibrary%2fhh706280%2528d%3dprinter%2cv%3dvs.85%2529.aspx%3flan%3dcsharp%26cc%3dn%26trm%3dtra%26view%3dbook&lc=1033&id=254354&mkt=en-us" title="Sign in">Sign in</a></div>
- <div class="auxNav">
- <div>
- <div data-fragmentname="Subscriptions" id="Fragment_Subscriptions" xmlns="http://www.w3.org/1999/xhtml">
- <a href="https://msdn.microsoft.com/subscriptions/manage/hh442900" id="Subscriptions_2153_1" xmlns="http://www.w3.org/1999/xhtml">MSDN subscriptions</a>
- </div>
- <div data-fragmentname="GetTools" id="Fragment_GetTools" xmlns="http://www.w3.org/1999/xhtml">
- <a href="http://go.microsoft.com/fwlink/?LinkId=309297&clcid=0x409&slcid=0x409&campaign=o~msft~msdn~gettools-header~dn308572" id="GetTools_2153_3" xmlns="http://www.w3.org/1999/xhtml">Get tools</a>
- </div>
- </div>
- <div>
- <div data-fragmentname="SocialLinks" id="Fragment_SocialLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <ul class="links horizontal">
- <li>
- <a href="http://www.facebook.com/microsoftdeveloper" target="_blank" id="SocialLinks_2152_4" class="facebook" xmlns="http://www.w3.org/1999/xhtml">http://www.facebook.com/microsoftdeveloper</a>
- </li>
- <li>
- <a href="https://twitter.com/msdev" target="_blank" id="SocialLinks_2152_5" class="twitter" xmlns="http://www.w3.org/1999/xhtml">https://twitter.com/msdev</a>
- </li>
- <li>
- <a href="http://plus.google.com/111221966647232053570/" target="_blank" id="SocialLinks_2152_6" class="googlePlus" xmlns="http://www.w3.org/1999/xhtml">http://plus.google.com/111221966647232053570/</a>
- </li>
- </ul>
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- <div class="row middleRow">
- <div class="expandTop">
- <div class="left"></div>
- <div class="right"></div>
- </div>
- </div>
- </div>
- <div id="buttomRowWrapper" class="bg_default">
- <div class="row buttomRow bg_default">
- <div class="bottom">
- <div class="left">
- <a id="grip" class="menu-icon" href="javascript:void(0)"></a>
-
- <div id="drawer">
- <div class="toc">
-
- <nav>
- <ul class="navL1">
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Technologies">Technologies</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/cloud-app-development-msdn" title="Cloud">Cloud</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/app-development-msdn" title="App Development">App Development</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/web-app-development-msdn" title="Web">Web</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/big-data-development-msdn" title="Data">Data</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/games-development-msdn" title="Gaming">Gaming</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/internetofthings" title="Internet of Things">Internet of Things</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Downloads">Downloads</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://www.visualstudio.com/downloads/download-visual-studio-vs" title="Visual Studio">Visual Studio</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/subscriptions" title="MSDN subscription access">MSDN subscription access</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/microsoft-sdks-msdn" title="SDKs">SDKs</a>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Trial software">Trial software</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/evalcenter" title="Free downloads">Free downloads</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/officeevaluationresources" title="Office resources">Office resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/sharepoint2013resources" title="SharePoint Server 2013 resources">SharePoint Server 2013 resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/sqlserver2014expressresources" title="SQL Server 2014 Express resources">SQL Server 2014 Express resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/windowsserver2012r2resources" title="Windows Server 2012 resources">Windows Server 2012 resources</a>
- </li>
- </ul>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Programs">Programs</a>
- <ul class="navL2">
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Visual Studio subscriptions">Visual Studio subscriptions</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/msdn-subscriptions-overview" title="Overview">Overview</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/benefits-overview" title="Benefits">Benefits</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/msdn-subscriptions-administration" title="Administrators">Administrators</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Students">Students</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/imagine/imagine-home" title="Microsoft Imagine">Microsoft Imagine</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/microsoftstudentpartners" title="Microsoft Student Partners">Microsoft Student Partners</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Architects">Architects</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-overview-msdn" title="Overview">Overview</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-case-studies-msdn" title="Case studies">Case studies</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-blueprints-msdn" title="Blueprints">Blueprints</a>
- </li>
- <li class="inactive">
- <a href="http://blogs.msdn.com/b/msarchitecture/" title="Blog">Blog</a>
- </li>
- <li class="inactive">
- <a href="http://social.msdn.microsoft.com/forums/en-us/home?brandignore=true&sort=relevancedesc&searchterm=architecture+or+architect" title="Forums">Forums</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/applicationbuilder" title="ISV">ISV</a>
-
- </li>
- <li class="inactive">
- <a href="https://www.microsoft.com/bizspark" title="Startups">Startups</a>
-
- </li>
- <li class="inactive">
- <a href="https://rewards.msdn.microsoft.com/" title="TechRewards">TechRewards</a>
-
- </li>
- <li class="inactive">
- <a href="http://events.msdn.microsoft.com/" title="Events">Events</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Community">Community</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/magazine/dd767791" title="Magazine">Magazine</a>
-
- </li>
- <li class="inactive">
- <a href="https://social.msdn.microsoft.com/forums/" title="Forums">Forums</a>
-
- </li>
- <li class="inactive">
- <a href="http://blogs.msdn.com/b/developer-tools/" title="Blogs">Blogs</a>
-
- </li>
- <li class="inactive">
- <a href="http://tech-advisors.msdn.microsoft.com/en-us" title="Tech Advisors">Tech Advisors</a>
-
- </li>
- <li class="inactive">
- <a href="http://channel9.msdn.com/" title="Channel 9">Channel 9</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive current toggle">
- <a href="javascript:void(0)" title="Documentation">Documentation</a>
- <ul class="navL2">
- <li class="inactive current">
- <a href="https://msdn.microsoft.com/library" title="APIs and reference">APIs and reference</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/developer-centers-msdn" title="Dev centers">Dev centers</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive">
- <a href="https://code.msdn.microsoft.com/" title="Samples">Samples</a>
- </li>
- </ul>
- </nav>
- </div>
- </div>
- </div>
- <div class="right">
- <div data-fragmentname="SearchBox" id="Fragment_SearchBox" xmlns="http://www.w3.org/1999/xhtml">
- <div class="SearchBox">
- <form id="HeaderSearchForm" name="HeaderSearchForm" method="get">
- <button id="FakeHeaderSearchButton" value="Search" type="submit" class="header-search-button">
- <div id="search-finder" class="search-finder"></div>
- </button>
- <button id="HeaderSearchButton" style="display:none"></button>
- <div id="searchSplitter"></div>
- <div id="searchCloseIcon" class="search-clear-x"></div>
- <div id="searchTextContainer" style="width: 0;">
- <input id="HeaderSearchTextBox" name="query" type="text" maxlength="200" onfocus="Epx.Controls.SearchBox.watermarkFocus(event, this.title)" onblur="Epx.Controls.SearchBox.watermarkBlur(event, this.title)">
- </div>
- </form>
-
-
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- </header>
- </div>
-
-
-
- <div class="printExportMenus ltr">
- <a id="isd_printABook" href="http://msdn.microsoft.com/en-us/library/export/help/(d=printer)?returnurl=%2fen-us%2flibrary%2fhh706280(d%3dprinter,v%3dvs.85).aspx%3flan%3dcsharp%26cc%3dn%26trm%3dtra%26view%3dbook">
- Export (<span class="count">0</span>)
- </a>
- <a id="isd_print" href="https://msdn.microsoft.com/en-us/library/hh706280(d=printer,v=vs.85).aspx?lan=csharp&cc=n&trm=tra&view=book" rel="nofollow">
- Print
- </a>
- <a id="isd_archiveControl" style="display:none;" data-include-archive="Include Previous Version" data-exclude-archive="Exclude Previous Version">
- </a>
- </div>
-
- <div class="printExportMenus ltr">
- <a id="expandCollapseAll" accesskey="e" href="javascript:void(0)" title="Expand/Collapse all sections by pressing Ctrl + Shift + e">Expand All</a>
- </div>
-
- <div id="body" ms.pgarea="body">
- <span id="tabletView_large"></span>
- <span id="tabletView_small"></span>
- <span id="mobileView"></span>
-
- <div id="content" class="content">
- <input type="hidden" id="printForPab" value="true">
-
- <div class="topic" xmlns="http://www.w3.org/1999/xhtml">
- <h1 class="title">Upper and lower edges of drivers</h1>
-
- <div id="mainSection">
- <div class="clsServerSDKContent">
- </div>
- <p>The sequence of drivers that participate in an I/O request is called the driver stack for the request. A driver can call into the upper edge of a lower driver in the stack. A driver can also call into the lower edge of a higher driver in the stack.</p>
- <p>Before you read this topic, you should understand the ideas presented in <a href="https://msdn.microsoft.com/en-us/library/ff554721(v=vs.85).aspx">Device nodes and device stacks</a> and <a href="https://msdn.microsoft.com/en-us/library/hh439632(v=vs.85).aspx">Driver stacks</a>.</p>
- <p> I/O requests are processed first by the top driver in the driver stack, then by the next lower driver, and so on until the request is fully processed. </p>
- <p>When a driver implements a set of functions that a higher driver can call, that set of functions is called the <em>upper edge</em> of the driver or the <em>upper-edge interface</em> of the driver.</p>
- <p>When a driver implements a set of functions that a lower driver can call, that set of functions is called the <em>lower edge</em> of the driver or the <em>lower-edge interface</em> of the driver.</p>
- <h3><a id="Audio_example"></a><a id="audio_example"></a><a id="AUDIO_EXAMPLE"></a>Audio example</h3>
- <p>We can think of an audio miniport driver sitting below an audio port driver in a driver stack. The port driver makes calls to the miniport driver's upper edge. The miniport driver makes calls to the port driver's lower edge.</p><img id="AudioDrvStack" alt="Diagram of audio port driver above miniport driver" src="./Windows Kernel Development Articles (2016-03-30)_files/IC534970.png" title="Diagram of audio port driver above miniport driver" xmlns=""><p>The preceding diagram illustrates that it is sometimes useful to think of a port driver sitting above a miniport driver in a driver stack. Because I/O requests are processed first by the port driver and then by the miniport driver, it is reasonable to think of the port driver as being above the miniport driver. Keep in mind, however, that a (miniport, port) driver pair usually sits at a single level in a device stack, as shown here.</p><img id="upperloweredge01" alt="Diagram of device stack with (miniport/port) pair" src="./Windows Kernel Development Articles (2016-03-30)_files/IC554551.png" title="Diagram of device stack with (miniport/port) pair" xmlns=""><p>Note that a <em>device stack</em> is not the same thing as a <em>driver stack</em>. For definitions of these terms, and for a discussion of how a pair of drivers can form a single WDM driver that occupies one level in a device stack, see <a href="https://msdn.microsoft.com/en-us/library/hh439643(v=vs.85).aspx">Minidrivers and driver pairs</a>. </p>
- <p>Here's another way to draw a diagram of the same device node and device stack:</p><img id="upperloweredge02" alt="Diagram of device stack with port driver above miniport" src="./Windows Kernel Development Articles (2016-03-30)_files/IC554552.png" title="Diagram of device stack with port driver above miniport" xmlns=""><p>In the preceding diagram, we see that the (miniport, port) pair forms a single WDM driver that is associated with a single device object (the FDO) in the device stack; that is, the (miniport, port) pair occupies only one level in the device stack. But we also see a vertical relationship between the miniport and port drivers. The port driver is shown above the miniport driver to indicate that the port driver processes I/O requests first and then calls into the miniport driver for additional processing.</p>
- <p>The key point is that when the port driver calls into the miniport driver's upper-edge interface, that is not the same as passing an I/O request down the device stack. In a driver stack (not device stack) you can choose to draw a port driver above a miniport driver, but that does not mean that the port driver is above the miniport driver in the device stack.</p>
- <h3><a id="NDIS_example"></a><a id="ndis_example"></a><a id="NDIS_EXAMPLE"></a>NDIS example</h3>
- <p>Sometimes a driver calls the upper edge of a lower driver indirectly. For example, suppose a <a href="https://msdn.microsoft.com/en-us/library/ff556929(v=vs.85).aspx">TCP/IP protocol driver</a> sits above an <a href="https://msdn.microsoft.com/en-us/library/ff565448(v=vs.85).aspx">NDIS</a> miniport driver in a driver stack. The miniport driver implements a set of <em>MiniportXxx</em> functions that form the miniport driver's upper edge. We say that the TCP/IP protocol driver <em>binds</em> to the upper edge of the NDIS miniport driver. But the TCP/IP driver does not call the <em>MiniportXxx</em> functions directly. Instead, it calls functions in the NDIS library, which then call the <em>MiniportXxx</em> functions.</p><img id="UpperLowerEdge03" alt="Diagram of TCP/IP and NDIS miniport stack" src="./Windows Kernel Development Articles (2016-03-30)_files/IC686629.png" title="Diagram of TCP/IP and NDIS miniport stack" xmlns=""><p>The preceding diagram shows a driver stack. Here's another view of the same drivers.</p><img id="UpperLowerEdge04" alt="Diagram of device stack for a network card" src="./Windows Kernel Development Articles (2016-03-30)_files/IC686630.png" title="Diagram of device stack for a network card" xmlns=""><p>The preceding diagram shows the device node for a network interface card (NIC). The device node has a position in the Plug and Play (PnP) device tree. The device node for the NIC has a device stack with three device objects. Notice that the NDIS miniport driver and the NDIS library work as a pair. The pair (MyMiniport.sys, Ndis.sys) forms a single WDM driver that is represented by the functional device object (FDO).</p>
- <p>Also notice that the protocol driver Tcpip.sys is not part of the device stack for the NIC. In fact, Tcpip.sys is not part of the PnP device tree at all.</p>
- <h2><a id="Summary"></a><a id="summary"></a><a id="SUMMARY"></a>Summary</h2>
- <p>The terms <em>upper edge</em> and <em>lower edge</em> are used to describe the interfaces that drivers in a stack use to communicate with each other. A <a href="https://msdn.microsoft.com/en-us/library/hh439632(v=vs.85).aspx"><em xmlns="http://www.w3.org/1999/xhtml">driver stack</em></a> is not the same thing as <a href="https://msdn.microsoft.com/en-us/library/ff554721(v=vs.85).aspx"><em xmlns="http://www.w3.org/1999/xhtml">device stack</em></a>. Two drivers that are shown vertically in a driver stack might form a driver pair that sits at a single level in a device stack. Some drivers are not part of the PnP device tree.</p>
- <h2><a id="related_topics"></a>Related topics</h2>
- <dl>
- <dt>
- <a href="https://msdn.microsoft.com/en-us/library/ff554731(v=vs.85).aspx">Concepts for all driver developers</a>
- </dt>
- <dt>
- <a href="https://msdn.microsoft.com/en-us/library/ff554721(v=vs.85).aspx">Device nodes and device stacks</a>
- </dt>
- <dt>
- <a href="https://msdn.microsoft.com/en-us/library/hh439632(v=vs.85).aspx">Driver stacks</a>
- </dt>
- <dt>
- <a href="https://msdn.microsoft.com/en-us/library/ff537760(v=vs.85).aspx">Audio Devices</a>
- </dt>
- <dt>
- <a href="https://msdn.microsoft.com/en-us/library/ff570021(v=vs.85).aspx">Network Drivers Starting with Windows Vista</a>
- </dt>
- </dl>
- <p> </p>
- <p> </p>
- <p><a href="mailto:wsddocfb@microsoft.com?subject=Documentation%20feedback%20[wdkgetstart\wdkgetstart]:%20Upper%20and%20lower%20edges%20of%20drivers%20%20RELEASE:%20(3/4/2016)&body=%0A%0APRIVACY%20STATEMENT%0A%0AWe%20use%20your%20feedback%20to%20improve%20the%20documentation.%20We%20don%27t%20use%20your%20email%20address%20for%20any%20other%20purpose,%20and%20we%27ll%20remove%20your%20email%20address%20from%20our%20system%20after%20the%20issue%20that%20you%27re%20reporting%20is%20fixed.%20While%20we%27re%20working%20to%20fix%20this%20issue,%20we%20might%20send%20you%20an%20email%20message%20to%20ask%20for%20more%20info.%20Later,%20we%20might%20also%20send%20you%20an%20email%20message%20to%20let%20you%20know%20that%20we%27ve%20addressed%20your%20feedback.%0A%0AFor%20more%20info%20about%20Microsoft%27s%20privacy%20policy,%20see%20http://privacy.microsoft.com/en-us/default.aspx." title="Send comments about this topic to Microsoft">Send comments about this topic to Microsoft</a></p>
- </div>
- </div>
-
- </div>
- </div>
- <div class="clear"></div>
-
- <input name="__RequestVerificationToken" type="hidden" value="SDi3NEs0Ttio3gIIxosJTqw0UU61jQzns5TorVsx3Hx0IiOW57tePFlBg0iNDsklKikv8hntrop62m_RlWXQdqtqbjE1">
- <input id="ratingValueSubmitUrl" type="hidden" value="https://msdn.microsoft.com/en-us/library/feedback/rate/hh706280(d=printer,v=vs.85).aspx">
- <input id="ratingAdditionalSubmitUrl" type="hidden" value="https://msdn.microsoft.com/en-us/library/feedback/additional/hh706280(d=printer,v=vs.85).aspx">
- <input id="isTopicRated" type="hidden" value="false">
- <div id="lib-footer" ms.pgarea="body">
-
-
- <link type="text/css" rel="stylesheet">
-
- <div id="ux-footer" class="" style="" dir="ltr">
-
- <div id="footerSock" class="librarySock both">
- <div id="footerSockInner">
- <a name="feedback"></a>
- <div class="rating">
- <div id="ratingSection1">
- <div class="title">
- Was this page helpful?
- </div>
- <div class="description">
- Your feedback about this content is important.<br>Let us know what you think.
- </div>
- <div class="buttons">
- <button class="button" id="ratingYes" aria-label="Yes, this page was helpful">Yes</button>
- <button class="button" id="ratingNo" aria-label="No, this page was not helpful">No</button>
- </div>
- <input id="ratingValue" type="hidden" value="">
- </div>
- <div id="ratingSection2">
- <div class="title left">
- Additional feedback?
- </div>
- <textarea id="ratingText" rows="6" cols="" maxlength="1500"></textarea>
- <div class="right">
- <div class="counter">
- <span id="feedbackTextCounter">1500</span> characters remaining
- </div>
- <div class="buttons">
- <button class="button" id="ratingSubmit" aria-label="Submit my additional feedback">Submit</button>
- <button class="button" id="ratingSkipThis" aria-label="Skip additional feedback">Skip this</button>
- </div>
- </div>
- </div>
- <div id="ratingSection3">
- <div class="title">
- Thank you!
- </div>
- <div class="description">
- We appreciate your feedback.
- </div>
- </div>
-
-
- <div id="contentFeedbackQAContainer" style="display: none;"></div>
- </div>
-
- <div class="userVoice">
- <div class="title">
- Help us improve MSDN.
- </div>
- <div class="description">
- Visit our UserVoice Page to submit and vote on ideas!
- </div>
- <div class="buttons">
- <a class="button" id="userVoiceButton" href="http://feedback.msdn.com/forums/257782-msdn-feature-suggestions/category/83975" target="_blank">Make a suggestion</a>
- </div>
- </div>
- <div class="clear"></div>
- </div>
- </div>
- <footer class="top">
- <div data-fragmentname="LeftLinks" id="Fragment_LeftLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Dev centers</div>
- <ul class="links">
- <li>
- <a href="https://dev.windows.com/" id="LeftLinks_2148_1" class="windowsBlue" xmlns="http://www.w3.org/1999/xhtml">Windows</a>
- </li>
- <li>
- <a href="http://dev.office.com/" id="LeftLinks_2148_3" class="office" xmlns="http://www.w3.org/1999/xhtml">Office</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/vstudio" id="LeftLinks_2148_4" class="visualStudio" xmlns="http://www.w3.org/1999/xhtml">Visual Studio</a>
- </li>
- <li>
- <a href="http://azure.microsoft.com/en-us/documentation/" target="_blank" id="LeftLinks_2148_12" xmlns="http://www.w3.org/1999/xhtml">Microsoft Azure</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/developer-centers-msdn" id="LeftLinks_2148_5" xmlns="http://www.w3.org/1999/xhtml">More...</a>
- </li>
- </ul>
- </div>
- </div>
- <div id="rightLinks">
- <div data-fragmentname="CenterLinks1" id="Fragment_CenterLinks1" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Learning resources</div>
- <ul class="links">
- <li>
- <a href="http://www.microsoftvirtualacademy.com/" id="CenterLinks1_2151_4" xmlns="http://www.w3.org/1999/xhtml">Microsoft Virtual Academy</a>
- </li>
- <li>
- <a href="http://channel9.msdn.com/" id="CenterLinks1_2151_5" xmlns="http://www.w3.org/1999/xhtml">Channel 9</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/magazine/" id="CenterLinks1_2151_7" xmlns="http://www.w3.org/1999/xhtml">MSDN Magazine</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks2" id="Fragment_CenterLinks2" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Community</div>
- <ul class="links">
- <li>
- <a href="https://social.msdn.microsoft.com/forums/en-us/home" id="CenterLinks2_2151_8" xmlns="http://www.w3.org/1999/xhtml">Forums</a>
- </li>
- <li>
- <a href="http://blogs.msdn.com/b/developer-tools/" id="CenterLinks2_2151_9" xmlns="http://www.w3.org/1999/xhtml">Blogs</a>
- </li>
- <li>
- <a href="http://www.codeplex.com/" id="CenterLinks2_2151_10" xmlns="http://www.w3.org/1999/xhtml">Codeplex</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks3" id="Fragment_CenterLinks3" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Support</div>
- <ul class="links">
- <li>
- <a href="https://msdn.microsoft.com/hh361695" id="CenterLinks3_2151_11" xmlns="http://www.w3.org/1999/xhtml">Self support</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks4" id="Fragment_CenterLinks4" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Programs</div>
- <ul class="links">
- <li>
- <a href="https://www.microsoft.com/bizspark/" id="CenterLinks4_2151_13" xmlns="http://www.w3.org/1999/xhtml">BizSpark (for startups)</a>
- </li>
- <li>
- <a href="https://www.dreamspark.com/" id="CenterLinks4_2151_14" xmlns="http://www.w3.org/1999/xhtml">DreamSpark</a>
- </li>
- <li>
- <a href="http://www.imaginecup.com/" id="CenterLinks4_2151_17" xmlns="http://www.w3.org/1999/xhtml">Imagine Cup</a>
- </li>
- </ul>
- </div>
- </div>
- </div>
- </footer>
- <footer class="bottom">
- <span class="localeContainer">
-
- <form class="selectLocale" id="selectLocaleForm" action="https://msdn.microsoft.com/en-us/selectlocale-dmc">
- <input type="hidden" name="fromPage" value="https%3a%2f%2fmsdn.microsoft.com%2fen-us%2flibrary%2fhh706280(d%3dprinter%2cv%3dvs.85).aspx%3flan%3dCSharp%26cc%3dn%26trm%3dtra%26view%3dbook">
- <a href="http://msdn.microsoft.com/#" onclick="$('#selectLocaleForm').submit();return false;" title="Change your language">United States (English)</a>
- </form>
- </span>
- <div data-fragmentname="BottomLinks" id="Fragment_BottomLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <ul class="links horizontal">
- <li>
- <a href="https://msdn.microsoft.com/newsletter.aspx" id="BottomLinks_2148_7" xmlns="http://www.w3.org/1999/xhtml">Newsletter</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/dn529288" id="BottomLinks_2148_8" xmlns="http://www.w3.org/1999/xhtml">Privacy & cookies</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/cc300389" id="BottomLinks_2148_9" xmlns="http://www.w3.org/1999/xhtml">Terms of use</a>
- </li>
- <li>
- <a href="https://www.microsoft.com/en-us/legal/intellectualproperty/Trademarks/EN-US.aspx" id="BottomLinks_2148_10" xmlns="http://www.w3.org/1999/xhtml">Trademarks</a>
- </li>
- </ul>
- </div>
- </div>
- <span class="logoLegal">
- <span class="logo"></span>
- <span class="copyright">© 2016 Microsoft</span>
- </span>
- </footer>
- </div>
-
- </div>
- <div class="footerPrintView">
- <div class="footerCopyrightPrintView">© 2016 Microsoft</div>
- </div>
-
-
-
-
- <input id="tocPaddingPerLevel" type="hidden" value="17">
- <input id="MtpsDevice" type="hidden" value="Printer">
- <!--[CDATA[ Third party scripts and code linked to or referenced from this website are licensed to you by the parties that own such code, not by Microsoft. See ASP.NET Ajax CDN Terms of Use – http://www.asp.net/ajaxlibrary/CDN.ashx. ]]-->
-
-
-
-
-
- <noscript><div><img alt="DCSIMG" id="Img1" width="1" height="1" src="https://m.webtrends.com/dcsmgru7m99k7mqmgrhudo0k8_8c6m/njs.gif?dcsuri=/nojavascript&amp;WT.js=No" /></div></noscript>
- <div id="globalRequestVerification">
- <input name="__RequestVerificationToken" type="hidden" value="vAi_s2dp4YfQo7a52UO_dFqAse7Opkhnlyp7jaIakhRcDP5uHq79QE2hVSDkPAj80BqwaSW_2MMQjJocsVopF76vH2A1">
- </div>
- </div>
-
-
-
-
-
-
- <script type="text/javascript" class="mtps-injected">
- /*<![CDATA[*/
- (function(window,document){"use strict";function preload(scripts){for(var result=[],script,e,i=0;i<scripts.length;i++)script=scripts[i],script.hasOwnProperty("url")&&(e=document.createElement("script"),e.src=script.url,script.throwaway=e),result.push(script);return result}function inject(scripts,index){var script,elem;if(index>=scripts.length){delete mtps.injectScripts;return}script=scripts[index];elem=document.createElement("script");elem.className="mtps-injected";elem.async=!1;var isLoaded=!1,timeoutId=0,injectNextFnName="",injectNext=elem.onerror=function(){isLoaded||(isLoaded=!0,inject(scripts,index+1),window.clearTimeout(timeoutId),elem.onload=elem.onerror=elem.onreadystatechange=null,injectNextFnName&&delete mtps[injectNextFnName],elem.removeEventListener&&elem.removeEventListener("load",injectNext,!1))};elem.addEventListener?elem.addEventListener("load",injectNext,!1):elem.readyState==="uninitialized"?elem.onreadystatechange=function(){(this.readyState==="loaded"||this.readyState==="complete")&&injectNext()}:elem.onload=injectNext;script.hasOwnProperty("url")?(timeoutId=window.setTimeout(injectNext,12e4),elem.src=script.url):(injectNextFnName="_injectNextScript_"+index,mtps[injectNextFnName]=injectNext,timeoutId=window.setTimeout(injectNext,2e3),elem.text="try {\n"+script.txt+"\n} finally { MTPS."+injectNextFnName+" && MTPS."+injectNextFnName+"(); }");parent.appendChild(elem)}var mtps=window.MTPS||(window.MTPS={}),parent=document.getElementsByTagName("head")[0];mtps.injectScripts=function(scripts){inject(preload(scripts),0)}})(window,document);
- MTPS.injectScripts([
- { txt: "/**/\r\n(window.MTPS || (window.MTPS = {})).cdnDomains || (window.MTPS.cdnDomains = { \r\n\t\"image\": \"https://i-msdn.sec.s-msft.com\", \r\n\t\"js\": \"https://i2-msdn.sec.s-msft.com\", \r\n\t\"css\": \"https://i-msdn.sec.s-msft.com\", \r\n\t\"ttf\": \"https://i-msdn.sec.s-msft.com\"\r\n});\r\n/**/" },
- { txt: "//\n var literalNormalizedUrl = \u0027/en-us/library/hh706280(d=printer,l=en-us,v=vs.85).aspx\u0027;\n var wt_nvr_ru = \u0027WT_NVR_RU\u0027;\n var wt_fpcdom = \u0027.microsoft.com\u0027;\n var wt_domlist = \u0027msdn.microsoft.com\u0027;\n var wt_pathlist = \u0027\u0027;\n var wt_paramlist = \u0027DCSext.mtps_devcenter\u0027;\n var wt_siteid = \u0027MSDN\u0027;\n var gDomain = \u0027m.webtrends.com\u0027;\n var gDcsId = \u0027dcsmgru7m99k7mqmgrhudo0k8_8c6m\u0027;\n var gFpc = \u0027WT_FPC\u0027;\n\n\n\n if (document.cookie.indexOf(gFpc + \"=\") == -1) {\n var wtidJs = document.createElement(\"script\");\n wtidJs.src = \"//\" + gDomain + \"/\" + gDcsId + \"/wtid.js\";\n document.getElementsByTagName(\"head\")[0].appendChild(wtidJs);\n }\n\n\n\n var detectedLocale = \u0027en-us\u0027;\n var wtsp = \u0027msdnlib_w32_com\u0027;\n var gTrackEvents = \u00270\u0027;\n/**/" },
- { txt: "//\n\n window.appInsightsId = \u00275eb1b2eb-c47a-497a-a7ac-a1c230b2882f\u0027;\n //" },
- { url: "https://i2-msdn.sec.s-msft.com/Combined.js?resources=0:Utilities,1:Layout,2:Header,1:Rating,2:Footer,0:Topic,3:PabTopic,4:webtrendsscript,0:AppInsightsPerf,0:ABTestControl,5:WEDCS,3:CmpgrpForHeader,0:livefyre,0:Comment,1:SearchBox;/Areas/Epx/Content/Scripts:0,/Areas/Epx/Themes/Base/Content:1,/Areas/Centers/Themes/StandardDevCenter/Content:2,/Areas/Library/Content:3,/Areas/Global/Content/Webtrends/resources:4,/Areas/Library/Themes/Base/Content:5\u0026amp;hashKey=30CEE944AABFEA2C5A338BDB9E000732\u0026amp;v=AE608271C0243AAA0449D3BC0FAD8EB4" },
- { url: "https://i1.services.social.microsoft.com/search/Widgets/SearchBox.jss?boxid=HeaderSearchTextBox\u0026btnid=HeaderSearchButton\u0026pgArea=header\u0026brand=Msdn\u0026loc=en-us\u0026focusOnInit=false\u0026emptyWatermark=true\u0026searchButtonTooltip=Search MSDN" },
- { url: "https://i2-msdn.sec.s-msft.com/Combined.js?resources=0:PrintExportButton,1:Toc_Fixed,1:CodeSnippet,1:TopicNotInScope,1:CollapsibleArea,1:VersionSelector,1:SurveyBroker;/Areas/Library/Themes/Base/Content:0,/Areas/Epx/Content/Scripts:1\u0026amp;hashKey=80F30894E3FB8A3295C923AEC7019CFE\u0026amp;v=AE608271C0243AAA0449D3BC0FAD8EB4" },
- { txt: "$(document).ready(function() {\n try {\n var token = $(\"#globalRequestVerification input[name=\u0027__RequestVerificationToken\u0027]\").clone();\n $(\"#siteFeedbackForm\").append(token);\n } catch(err) {\n \n }\n });" }
- ]);
- /*]]>*/
- </script>
- <link rel="stylesheet" type="text/css" href="./Windows Kernel Development Articles (2016-03-30)_files/Combined.css">
- <div id="page">
-
-
-
-
- <link type="text/css" rel="stylesheet">
-
- <input type="hidden" id="isHeaderBleeding" value="true">
- <div id="ux-header" dir="ltr" class="ltr msdn">
-
- <header>
- <span id="singleCol"></span>
- <span id="doubleCol"></span>
- <span id="isMobile"></span>
- <div>
- <div class="row topRow">
- <div class="top">
- <div class="left">
- <a class="msdnLogoImg" href="https://msdn.microsoft.com/en-us" title="MSDN home">
- <div id="msft-logo" class="msft-logo"></div>
- </a>
- <div class="GrayPipe"></div>
- <a class="DevCenterFullNameNonMegaBlade" href="https://msdn.microsoft.com/en-us">Developer Network</a>
- <a class="DevCenterFullName" href="https://msdn.microsoft.com/en-us">Developer Network</a>
- <a class="DevCenterShortName" href="https://msdn.microsoft.com/en-us">Developer</a>
- </div>
- <div class="right">
- <div id="signIn">
- <div class="profileImage"></div>
- <a class="scarabLink" href="https://login.live.com/login.srf?wa=wsignin1.0&rpsnv=12&ct=1459376424&rver=6.0.5276.0&wp=mcmbi&wlcxt=msdn%24msdn%24msdn&wreply=https%3a%2f%2fmsdn.microsoft.com%2fen-us%2flibrary%2fff554695%2528d%3dprinter%2cv%3dvs.85%2529.aspx%3flan%3dcsharp%26cc%3dn%26trm%3dtra%26view%3dbook&lc=1033&id=254354&mkt=en-us" title="Sign in">Sign in</a></div>
- <div class="auxNav">
- <div>
- <div data-fragmentname="Subscriptions" id="Fragment_Subscriptions" xmlns="http://www.w3.org/1999/xhtml">
- <a href="https://msdn.microsoft.com/subscriptions/manage/hh442900" id="Subscriptions_2153_1" xmlns="http://www.w3.org/1999/xhtml">MSDN subscriptions</a>
- </div>
- <div data-fragmentname="GetTools" id="Fragment_GetTools" xmlns="http://www.w3.org/1999/xhtml">
- <a href="http://go.microsoft.com/fwlink/?LinkId=309297&clcid=0x409&slcid=0x409&campaign=o~msft~msdn~gettools-header~dn308572" id="GetTools_2153_3" xmlns="http://www.w3.org/1999/xhtml">Get tools</a>
- </div>
- </div>
- <div>
- <div data-fragmentname="SocialLinks" id="Fragment_SocialLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <ul class="links horizontal">
- <li>
- <a href="http://www.facebook.com/microsoftdeveloper" target="_blank" id="SocialLinks_2152_4" class="facebook" xmlns="http://www.w3.org/1999/xhtml">http://www.facebook.com/microsoftdeveloper</a>
- </li>
- <li>
- <a href="https://twitter.com/msdev" target="_blank" id="SocialLinks_2152_5" class="twitter" xmlns="http://www.w3.org/1999/xhtml">https://twitter.com/msdev</a>
- </li>
- <li>
- <a href="http://plus.google.com/111221966647232053570/" target="_blank" id="SocialLinks_2152_6" class="googlePlus" xmlns="http://www.w3.org/1999/xhtml">http://plus.google.com/111221966647232053570/</a>
- </li>
- </ul>
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- <div class="row middleRow">
- <div class="expandTop">
- <div class="left"></div>
- <div class="right"></div>
- </div>
- </div>
- </div>
- <div id="buttomRowWrapper" class="bg_default">
- <div class="row buttomRow bg_default">
- <div class="bottom">
- <div class="left">
- <a id="grip" class="menu-icon" href="javascript:void(0)"></a>
-
- <div id="drawer">
- <div class="toc">
-
- <nav>
- <ul class="navL1">
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Technologies">Technologies</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/cloud-app-development-msdn" title="Cloud">Cloud</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/app-development-msdn" title="App Development">App Development</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/web-app-development-msdn" title="Web">Web</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/big-data-development-msdn" title="Data">Data</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/games-development-msdn" title="Gaming">Gaming</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/internetofthings" title="Internet of Things">Internet of Things</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Downloads">Downloads</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://www.visualstudio.com/downloads/download-visual-studio-vs" title="Visual Studio">Visual Studio</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/subscriptions" title="MSDN subscription access">MSDN subscription access</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/microsoft-sdks-msdn" title="SDKs">SDKs</a>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Trial software">Trial software</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/evalcenter" title="Free downloads">Free downloads</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/officeevaluationresources" title="Office resources">Office resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/sharepoint2013resources" title="SharePoint Server 2013 resources">SharePoint Server 2013 resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/sqlserver2014expressresources" title="SQL Server 2014 Express resources">SQL Server 2014 Express resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/windowsserver2012r2resources" title="Windows Server 2012 resources">Windows Server 2012 resources</a>
- </li>
- </ul>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Programs">Programs</a>
- <ul class="navL2">
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Visual Studio subscriptions">Visual Studio subscriptions</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/msdn-subscriptions-overview" title="Overview">Overview</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/benefits-overview" title="Benefits">Benefits</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/msdn-subscriptions-administration" title="Administrators">Administrators</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Students">Students</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/imagine/imagine-home" title="Microsoft Imagine">Microsoft Imagine</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/microsoftstudentpartners" title="Microsoft Student Partners">Microsoft Student Partners</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Architects">Architects</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-overview-msdn" title="Overview">Overview</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-case-studies-msdn" title="Case studies">Case studies</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-blueprints-msdn" title="Blueprints">Blueprints</a>
- </li>
- <li class="inactive">
- <a href="http://blogs.msdn.com/b/msarchitecture/" title="Blog">Blog</a>
- </li>
- <li class="inactive">
- <a href="http://social.msdn.microsoft.com/forums/en-us/home?brandignore=true&sort=relevancedesc&searchterm=architecture+or+architect" title="Forums">Forums</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/applicationbuilder" title="ISV">ISV</a>
-
- </li>
- <li class="inactive">
- <a href="https://www.microsoft.com/bizspark" title="Startups">Startups</a>
-
- </li>
- <li class="inactive">
- <a href="https://rewards.msdn.microsoft.com/" title="TechRewards">TechRewards</a>
-
- </li>
- <li class="inactive">
- <a href="http://events.msdn.microsoft.com/" title="Events">Events</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Community">Community</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/magazine/dd767791" title="Magazine">Magazine</a>
-
- </li>
- <li class="inactive">
- <a href="https://social.msdn.microsoft.com/forums/" title="Forums">Forums</a>
-
- </li>
- <li class="inactive">
- <a href="http://blogs.msdn.com/b/developer-tools/" title="Blogs">Blogs</a>
-
- </li>
- <li class="inactive">
- <a href="http://tech-advisors.msdn.microsoft.com/en-us" title="Tech Advisors">Tech Advisors</a>
-
- </li>
- <li class="inactive">
- <a href="http://channel9.msdn.com/" title="Channel 9">Channel 9</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive current toggle">
- <a href="javascript:void(0)" title="Documentation">Documentation</a>
- <ul class="navL2">
- <li class="inactive current">
- <a href="https://msdn.microsoft.com/library" title="APIs and reference">APIs and reference</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/developer-centers-msdn" title="Dev centers">Dev centers</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive">
- <a href="https://code.msdn.microsoft.com/" title="Samples">Samples</a>
- </li>
- </ul>
- </nav>
- </div>
- </div>
- </div>
- <div class="right">
- <div data-fragmentname="SearchBox" id="Fragment_SearchBox" xmlns="http://www.w3.org/1999/xhtml">
- <div class="SearchBox">
- <form id="HeaderSearchForm" name="HeaderSearchForm" method="get">
- <button id="FakeHeaderSearchButton" value="Search" type="submit" class="header-search-button">
- <div id="search-finder" class="search-finder"></div>
- </button>
- <button id="HeaderSearchButton" style="display:none"></button>
- <div id="searchSplitter"></div>
- <div id="searchCloseIcon" class="search-clear-x"></div>
- <div id="searchTextContainer" style="width: 0;">
- <input id="HeaderSearchTextBox" name="query" type="text" maxlength="200" onfocus="Epx.Controls.SearchBox.watermarkFocus(event, this.title)" onblur="Epx.Controls.SearchBox.watermarkBlur(event, this.title)">
- </div>
- </form>
-
-
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- </header>
- </div>
-
-
-
- <div class="printExportMenus ltr">
- <a id="isd_printABook" href="http://msdn.microsoft.com/en-us/library/export/help/(d=printer)?returnurl=%2fen-us%2flibrary%2fff554695(d%3dprinter,v%3dvs.85).aspx%3flan%3dcsharp%26cc%3dn%26trm%3dtra%26view%3dbook">
- Export (<span class="count">0</span>)
- </a>
- <a id="isd_print" href="https://msdn.microsoft.com/en-us/library/ff554695(d=printer,v=vs.85).aspx?lan=csharp&cc=n&trm=tra&view=book" rel="nofollow">
- Print
- </a>
- <a id="isd_archiveControl" style="display:none;" data-include-archive="Include Previous Version" data-exclude-archive="Exclude Previous Version">
- </a>
- </div>
-
- <div class="printExportMenus ltr">
- <a id="expandCollapseAll" accesskey="e" href="javascript:void(0)" title="Expand/Collapse all sections by pressing Ctrl + Shift + e">Expand All</a>
- </div>
-
- <div id="body" ms.pgarea="body">
- <span id="tabletView_large"></span>
- <span id="tabletView_small"></span>
- <span id="mobileView"></span>
-
- <div id="content" class="content">
- <input type="hidden" id="printForPab" value="true">
-
- <div class="topic" xmlns="http://www.w3.org/1999/xhtml">
- <h1 class="title">Header files in the Windows Driver Kit</h1>
-
- <div id="mainSection">
- <div class="clsServerSDKContent">
- </div>
- <p>The <a href="https://msdn.microsoft.com/en-us/library/ff557573(v=vs.85).aspx">Windows Driver Kit (WDK)</a> contains all the header files (.h files) that you need to build kernel-mode and user-mode drivers. Header files are in the Include folder in your WDK installation folder. Example: C:\Program Files (x86)\Windows Kits\10\Include.</p>
- <p>The header files contain version information so that you can use the same set of header files regardless of which version of Windows your driver will run on.</p>
- <h2><a id="Constants_that_represent_Windows_versions"></a><a id="constants_that_represent_windows_versions"></a><a id="CONSTANTS_THAT_REPRESENT_WINDOWS_VERSIONS"></a>Constants that represent Windows versions</h2>
- <p>Header files in the WDK contain conditional statements that specify programming elements that are available only in certain versions of the Windows operating system. The versioned elements include functions, enumerations, structures, and structure members.</p>
- <p>To specify the programming elements that are available in each operating system version, the header files contain preprocessor conditionals that compare the value of NTDDI_VERSION with a set of predefined constant values that are defined in Sdkddkver.h.</p>
- <p>Here are the predefined constant values that represent versions of the Microsoft Windows operating system. </p>
- <table responsive="true">
- <tbody><tr responsive="true"><th>Constant</th><th>Operating system version</th></tr>
- <tr><td data-th="Constant">
- <p>NTDDI_WIN10</p>
- </td><td data-th="Operating system version">
- <p>Windows 10</p>
- </td></tr>
- <tr><td data-th="Constant">
- <p>NTDDI_WINBLUE</p>
- </td><td data-th="Operating system version">
- <p>Windows 8.1</p>
- </td></tr>
- <tr><td data-th="Constant">
- <p>NTDDI_WIN8</p>
- </td><td data-th="Operating system version">
- <p>Windows 8</p>
- </td></tr>
- <tr><td data-th="Constant">
- <p>NTDDI_WIN7</p>
- </td><td data-th="Operating system version">
- <p>Windows 7</p>
- </td></tr>
- <tr><td data-th="Constant">
- <p>NTDDI_WS08SP4</p>
- </td><td data-th="Operating system version">
- <p>Windows Server 2008 with SP4</p>
- </td></tr>
- <tr><td data-th="Constant">
- <p>NTDDI_WS08SP3</p>
- </td><td data-th="Operating system version">
- <p>Windows Server 2008 with SP3</p>
- </td></tr>
- <tr><td data-th="Constant">
- <p>NTDDI_WS08SP2</p>
- </td><td data-th="Operating system version">
- <p>Windows Server 2008 with SP2</p>
- </td></tr>
- <tr><td data-th="Constant">
- <p>NTDDI_WS08</p>
- </td><td data-th="Operating system version">
- <p>Windows Server 2008</p>
- </td></tr>
- </tbody></table>
- <p> </p>
- <p>You can see many examples of version-specific DDI elements in the WDK header files. This conditional declaration appears in Wdm.h, which is a header file that might be included by a kernel-mode driver.</p>
- <div id="code-snippet-1" class="codeSnippetContainer" xmlns="http://www.w3.org/1999/xhtml">
- <div class="codeSnippetContainerTabs">
- <div class="codeSnippetContainerTab codeSnippetContainerTabActive" dir="ltr">
- <a></a>
- </div>
- </div>
- <div class="codeSnippetContainerCodeContainer">
- <div class="codeSnippetToolBar"></div>
- <div class="codeSnippetContainerCode" dir="ltr">
- <div style="color:Black;"><pre>
- #if (NTDDI_VERSION >= NTDDI_WIN7)
- _Must_inspect_result_
- NTKERNELAPI
- NTSTATUS
- KeSetTargetProcessorDpcEx (
- _Inout_ PKDPC Dpc,
- _In_ PPROCESSOR_NUMBER ProcNumber
- );
- #endif
- </pre></div>
- </div>
- </div>
- </div>
- <p>In the example you can see that the <a href="https://msdn.microsoft.com/en-us/library/ff553279(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">KeSetTargetProcessorDpcEx</strong></a> function is available only in Windows 7 and later versions of Windows. </p>
- <p>This conditional declaration appears in Winspool.h, which is a header file that might be included by a user-mode driver. </p>
- <div id="code-snippet-2" class="codeSnippetContainer" xmlns="http://www.w3.org/1999/xhtml">
- <div class="codeSnippetContainerTabs">
- <div class="codeSnippetContainerTab codeSnippetContainerTabActive" dir="ltr">
- <a>C++</a>
- </div>
- </div>
- <div class="codeSnippetContainerCodeContainer">
- <div class="codeSnippetToolBar"></div>
- <div class="codeSnippetContainerCode" dir="ltr">
- <div style="color:Black;"><pre>
- #<span style="color:Blue;">if</span> (NTDDI_VERSION >= NTDDI_WIN7)
- ...
- BOOL
- WINAPI
- GetPrintExecutionData(
- _Out_ PRINT_EXECUTION_DATA *pData
- );
- #endif <span style="color:Green;">// (NTDDI_VERSION >= NTDDI_WIN7)</span>
- </pre></div>
- </div>
- </div>
- </div>
- <p>In the example can see that the <a href="https://msdn.microsoft.com/en-us/library/ee264322(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">GetPrintExecutionData</strong></a> function is available only in Windows 7 and later versions of Windows. </p>
- <h2><a id="Header_files_for_the_Kernel_Mode_Driver_Framework"></a><a id="header_files_for_the_kernel_mode_driver_framework"></a><a id="HEADER_FILES_FOR_THE_KERNEL_MODE_DRIVER_FRAMEWORK"></a>Header files for the Kernel Mode Driver Framework</h2>
- <p>The WDK supports several versions of Windows, and it also supports several versions of the Kernel Mode Driver Framework (KMDF) and User Mode Driver Framework (UMDF). The versioning information in the WDK header files pertains to Windows versions, but not to KMDF or UMDF versions. Header files for different versions of KMDF and UMDF are placed in separate directories.</p>
- <p> </p>
- <p> </p>
- <p><a href="mailto:wsddocfb@microsoft.com?subject=Documentation%20feedback%20[wdkgetstart\wdkgetstart]:%20Header%20files%20in%20the%20Windows%20Driver%20Kit%20%20RELEASE:%20(3/4/2016)&body=%0A%0APRIVACY%20STATEMENT%0A%0AWe%20use%20your%20feedback%20to%20improve%20the%20documentation.%20We%20don%27t%20use%20your%20email%20address%20for%20any%20other%20purpose,%20and%20we%27ll%20remove%20your%20email%20address%20from%20our%20system%20after%20the%20issue%20that%20you%27re%20reporting%20is%20fixed.%20While%20we%27re%20working%20to%20fix%20this%20issue,%20we%20might%20send%20you%20an%20email%20message%20to%20ask%20for%20more%20info.%20Later,%20we%20might%20also%20send%20you%20an%20email%20message%20to%20let%20you%20know%20that%20we%27ve%20addressed%20your%20feedback.%0A%0AFor%20more%20info%20about%20Microsoft%27s%20privacy%20policy,%20see%20http://privacy.microsoft.com/en-us/default.aspx." title="Send comments about this topic to Microsoft">Send comments about this topic to Microsoft</a></p>
- </div>
- </div>
-
- </div>
- </div>
- <div class="clear"></div>
-
- <input name="__RequestVerificationToken" type="hidden" value="RVJg7wyDF6W9g5E5Jh4tFmqUZBZOboyQ5yxvxGXMTCYYUn3UZlNRVbCN86vEKfyGiBA5TJ-iuQmJH7CKydqkI1VYdOA1">
- <input id="ratingValueSubmitUrl" type="hidden" value="https://msdn.microsoft.com/en-us/library/feedback/rate/ff554695(d=printer,v=vs.85).aspx">
- <input id="ratingAdditionalSubmitUrl" type="hidden" value="https://msdn.microsoft.com/en-us/library/feedback/additional/ff554695(d=printer,v=vs.85).aspx">
- <input id="isTopicRated" type="hidden" value="false">
- <div id="lib-footer" ms.pgarea="body">
-
-
- <link type="text/css" rel="stylesheet">
-
- <div id="ux-footer" class="" style="" dir="ltr">
-
- <div id="footerSock" class="librarySock both">
- <div id="footerSockInner">
- <a name="feedback"></a>
- <div class="rating">
- <div id="ratingSection1">
- <div class="title">
- Was this page helpful?
- </div>
- <div class="description">
- Your feedback about this content is important.<br>Let us know what you think.
- </div>
- <div class="buttons">
- <button class="button" id="ratingYes" aria-label="Yes, this page was helpful">Yes</button>
- <button class="button" id="ratingNo" aria-label="No, this page was not helpful">No</button>
- </div>
- <input id="ratingValue" type="hidden" value="">
- </div>
- <div id="ratingSection2">
- <div class="title left">
- Additional feedback?
- </div>
- <textarea id="ratingText" rows="6" cols="" maxlength="1500"></textarea>
- <div class="right">
- <div class="counter">
- <span id="feedbackTextCounter">1500</span> characters remaining
- </div>
- <div class="buttons">
- <button class="button" id="ratingSubmit" aria-label="Submit my additional feedback">Submit</button>
- <button class="button" id="ratingSkipThis" aria-label="Skip additional feedback">Skip this</button>
- </div>
- </div>
- </div>
- <div id="ratingSection3">
- <div class="title">
- Thank you!
- </div>
- <div class="description">
- We appreciate your feedback.
- </div>
- </div>
-
-
- <div id="contentFeedbackQAContainer" style="display: none;"></div>
- </div>
-
- <div class="userVoice">
- <div class="title">
- Help us improve MSDN.
- </div>
- <div class="description">
- Visit our UserVoice Page to submit and vote on ideas!
- </div>
- <div class="buttons">
- <a class="button" id="userVoiceButton" href="http://feedback.msdn.com/forums/257782-msdn-feature-suggestions/category/83975" target="_blank">Make a suggestion</a>
- </div>
- </div>
- <div class="clear"></div>
- </div>
- </div>
- <footer class="top">
- <div data-fragmentname="LeftLinks" id="Fragment_LeftLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Dev centers</div>
- <ul class="links">
- <li>
- <a href="https://dev.windows.com/" id="LeftLinks_2148_1" class="windowsBlue" xmlns="http://www.w3.org/1999/xhtml">Windows</a>
- </li>
- <li>
- <a href="http://dev.office.com/" id="LeftLinks_2148_3" class="office" xmlns="http://www.w3.org/1999/xhtml">Office</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/vstudio" id="LeftLinks_2148_4" class="visualStudio" xmlns="http://www.w3.org/1999/xhtml">Visual Studio</a>
- </li>
- <li>
- <a href="http://azure.microsoft.com/en-us/documentation/" target="_blank" id="LeftLinks_2148_12" xmlns="http://www.w3.org/1999/xhtml">Microsoft Azure</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/developer-centers-msdn" id="LeftLinks_2148_5" xmlns="http://www.w3.org/1999/xhtml">More...</a>
- </li>
- </ul>
- </div>
- </div>
- <div id="rightLinks">
- <div data-fragmentname="CenterLinks1" id="Fragment_CenterLinks1" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Learning resources</div>
- <ul class="links">
- <li>
- <a href="http://www.microsoftvirtualacademy.com/" id="CenterLinks1_2151_4" xmlns="http://www.w3.org/1999/xhtml">Microsoft Virtual Academy</a>
- </li>
- <li>
- <a href="http://channel9.msdn.com/" id="CenterLinks1_2151_5" xmlns="http://www.w3.org/1999/xhtml">Channel 9</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/magazine/" id="CenterLinks1_2151_7" xmlns="http://www.w3.org/1999/xhtml">MSDN Magazine</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks2" id="Fragment_CenterLinks2" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Community</div>
- <ul class="links">
- <li>
- <a href="https://social.msdn.microsoft.com/forums/en-us/home" id="CenterLinks2_2151_8" xmlns="http://www.w3.org/1999/xhtml">Forums</a>
- </li>
- <li>
- <a href="http://blogs.msdn.com/b/developer-tools/" id="CenterLinks2_2151_9" xmlns="http://www.w3.org/1999/xhtml">Blogs</a>
- </li>
- <li>
- <a href="http://www.codeplex.com/" id="CenterLinks2_2151_10" xmlns="http://www.w3.org/1999/xhtml">Codeplex</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks3" id="Fragment_CenterLinks3" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Support</div>
- <ul class="links">
- <li>
- <a href="https://msdn.microsoft.com/hh361695" id="CenterLinks3_2151_11" xmlns="http://www.w3.org/1999/xhtml">Self support</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks4" id="Fragment_CenterLinks4" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Programs</div>
- <ul class="links">
- <li>
- <a href="https://www.microsoft.com/bizspark/" id="CenterLinks4_2151_13" xmlns="http://www.w3.org/1999/xhtml">BizSpark (for startups)</a>
- </li>
- <li>
- <a href="https://www.dreamspark.com/" id="CenterLinks4_2151_14" xmlns="http://www.w3.org/1999/xhtml">DreamSpark</a>
- </li>
- <li>
- <a href="http://www.imaginecup.com/" id="CenterLinks4_2151_17" xmlns="http://www.w3.org/1999/xhtml">Imagine Cup</a>
- </li>
- </ul>
- </div>
- </div>
- </div>
- </footer>
- <footer class="bottom">
- <span class="localeContainer">
-
- <form class="selectLocale" id="selectLocaleForm" action="https://msdn.microsoft.com/en-us/selectlocale-dmc">
- <input type="hidden" name="fromPage" value="https%3a%2f%2fmsdn.microsoft.com%2fen-us%2flibrary%2fff554695(d%3dprinter%2cv%3dvs.85).aspx%3flan%3dCSharp%26cc%3dn%26trm%3dtra%26view%3dbook">
- <a href="http://msdn.microsoft.com/#" onclick="$('#selectLocaleForm').submit();return false;" title="Change your language">United States (English)</a>
- </form>
- </span>
- <div data-fragmentname="BottomLinks" id="Fragment_BottomLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <ul class="links horizontal">
- <li>
- <a href="https://msdn.microsoft.com/newsletter.aspx" id="BottomLinks_2148_7" xmlns="http://www.w3.org/1999/xhtml">Newsletter</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/dn529288" id="BottomLinks_2148_8" xmlns="http://www.w3.org/1999/xhtml">Privacy & cookies</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/cc300389" id="BottomLinks_2148_9" xmlns="http://www.w3.org/1999/xhtml">Terms of use</a>
- </li>
- <li>
- <a href="https://www.microsoft.com/en-us/legal/intellectualproperty/Trademarks/EN-US.aspx" id="BottomLinks_2148_10" xmlns="http://www.w3.org/1999/xhtml">Trademarks</a>
- </li>
- </ul>
- </div>
- </div>
- <span class="logoLegal">
- <span class="logo"></span>
- <span class="copyright">© 2016 Microsoft</span>
- </span>
- </footer>
- </div>
-
- </div>
- <div class="footerPrintView">
- <div class="footerCopyrightPrintView">© 2016 Microsoft</div>
- </div>
-
-
-
-
- <input id="tocPaddingPerLevel" type="hidden" value="17">
- <input id="MtpsDevice" type="hidden" value="Printer">
- <!--[CDATA[ Third party scripts and code linked to or referenced from this website are licensed to you by the parties that own such code, not by Microsoft. See ASP.NET Ajax CDN Terms of Use – http://www.asp.net/ajaxlibrary/CDN.ashx. ]]-->
-
-
-
-
-
- <noscript><div><img alt="DCSIMG" id="Img1" width="1" height="1" src="https://m.webtrends.com/dcsmgru7m99k7mqmgrhudo0k8_8c6m/njs.gif?dcsuri=/nojavascript&amp;WT.js=No" /></div></noscript>
- <div id="globalRequestVerification">
- <input name="__RequestVerificationToken" type="hidden" value="Y1wTVs9PoWeJ6NCjt9TJ06BcTYiGpZg2KiAgREVat586xVONgdN8mQcF93AusPg1Xv8bxuAmGBHdCIWbJ0-b8N0VY-s1">
- </div>
- </div>
-
-
-
-
-
-
- <script type="text/javascript" class="mtps-injected">
- /*<![CDATA[*/
- (function(window,document){"use strict";function preload(scripts){for(var result=[],script,e,i=0;i<scripts.length;i++)script=scripts[i],script.hasOwnProperty("url")&&(e=document.createElement("script"),e.src=script.url,script.throwaway=e),result.push(script);return result}function inject(scripts,index){var script,elem;if(index>=scripts.length){delete mtps.injectScripts;return}script=scripts[index];elem=document.createElement("script");elem.className="mtps-injected";elem.async=!1;var isLoaded=!1,timeoutId=0,injectNextFnName="",injectNext=elem.onerror=function(){isLoaded||(isLoaded=!0,inject(scripts,index+1),window.clearTimeout(timeoutId),elem.onload=elem.onerror=elem.onreadystatechange=null,injectNextFnName&&delete mtps[injectNextFnName],elem.removeEventListener&&elem.removeEventListener("load",injectNext,!1))};elem.addEventListener?elem.addEventListener("load",injectNext,!1):elem.readyState==="uninitialized"?elem.onreadystatechange=function(){(this.readyState==="loaded"||this.readyState==="complete")&&injectNext()}:elem.onload=injectNext;script.hasOwnProperty("url")?(timeoutId=window.setTimeout(injectNext,12e4),elem.src=script.url):(injectNextFnName="_injectNextScript_"+index,mtps[injectNextFnName]=injectNext,timeoutId=window.setTimeout(injectNext,2e3),elem.text="try {\n"+script.txt+"\n} finally { MTPS."+injectNextFnName+" && MTPS."+injectNextFnName+"(); }");parent.appendChild(elem)}var mtps=window.MTPS||(window.MTPS={}),parent=document.getElementsByTagName("head")[0];mtps.injectScripts=function(scripts){inject(preload(scripts),0)}})(window,document);
- MTPS.injectScripts([
- { txt: "/**/\r\n(window.MTPS || (window.MTPS = {})).cdnDomains || (window.MTPS.cdnDomains = { \r\n\t\"image\": \"https://i-msdn.sec.s-msft.com\", \r\n\t\"js\": \"https://i2-msdn.sec.s-msft.com\", \r\n\t\"css\": \"https://i-msdn.sec.s-msft.com\", \r\n\t\"ttf\": \"https://i-msdn.sec.s-msft.com\"\r\n});\r\n/**/" },
- { txt: "//\n var literalNormalizedUrl = \u0027/en-us/library/ff554695(d=printer,l=en-us,v=vs.85).aspx\u0027;\n var wt_nvr_ru = \u0027WT_NVR_RU\u0027;\n var wt_fpcdom = \u0027.microsoft.com\u0027;\n var wt_domlist = \u0027msdn.microsoft.com\u0027;\n var wt_pathlist = \u0027\u0027;\n var wt_paramlist = \u0027DCSext.mtps_devcenter\u0027;\n var wt_siteid = \u0027MSDN\u0027;\n var gDomain = \u0027m.webtrends.com\u0027;\n var gDcsId = \u0027dcsmgru7m99k7mqmgrhudo0k8_8c6m\u0027;\n var gFpc = \u0027WT_FPC\u0027;\n\n\n\n if (document.cookie.indexOf(gFpc + \"=\") == -1) {\n var wtidJs = document.createElement(\"script\");\n wtidJs.src = \"//\" + gDomain + \"/\" + gDcsId + \"/wtid.js\";\n document.getElementsByTagName(\"head\")[0].appendChild(wtidJs);\n }\n\n\n\n var detectedLocale = \u0027en-us\u0027;\n var wtsp = \u0027msdnlib_w32_com\u0027;\n var gTrackEvents = \u00270\u0027;\n/**/" },
- { txt: "//\n\n window.appInsightsId = \u00275eb1b2eb-c47a-497a-a7ac-a1c230b2882f\u0027;\n //" },
- { url: "https://i2-msdn.sec.s-msft.com/Combined.js?resources=0:Utilities,1:Layout,2:Header,1:Rating,2:Footer,0:Topic,3:PabTopic,4:webtrendsscript,0:AppInsightsPerf,0:ABTestControl,5:WEDCS,3:CmpgrpForHeader,0:livefyre,0:Comment,1:SearchBox;/Areas/Epx/Content/Scripts:0,/Areas/Epx/Themes/Base/Content:1,/Areas/Centers/Themes/StandardDevCenter/Content:2,/Areas/Library/Content:3,/Areas/Global/Content/Webtrends/resources:4,/Areas/Library/Themes/Base/Content:5\u0026amp;hashKey=30CEE944AABFEA2C5A338BDB9E000732\u0026amp;v=AE608271C0243AAA0449D3BC0FAD8EB4" },
- { url: "https://i1.services.social.microsoft.com/search/Widgets/SearchBox.jss?boxid=HeaderSearchTextBox\u0026btnid=HeaderSearchButton\u0026pgArea=header\u0026brand=Msdn\u0026loc=en-us\u0026focusOnInit=false\u0026emptyWatermark=true\u0026searchButtonTooltip=Search MSDN" },
- { url: "https://i2-msdn.sec.s-msft.com/Combined.js?resources=0:PrintExportButton,1:Toc_Fixed,1:CodeSnippet,1:TopicNotInScope,1:CollapsibleArea,1:VersionSelector,1:SurveyBroker;/Areas/Library/Themes/Base/Content:0,/Areas/Epx/Content/Scripts:1\u0026amp;hashKey=80F30894E3FB8A3295C923AEC7019CFE\u0026amp;v=AE608271C0243AAA0449D3BC0FAD8EB4" },
- { txt: "$(document).ready(function() {\n try {\n var token = $(\"#globalRequestVerification input[name=\u0027__RequestVerificationToken\u0027]\").clone();\n $(\"#siteFeedbackForm\").append(token);\n } catch(err) {\n \n }\n });" }
- ]);
- /*]]>*/
- </script>
- <link rel="stylesheet" type="text/css" href="./Windows Kernel Development Articles (2016-03-30)_files/Combined.css">
- <div id="page">
-
-
-
-
- <link type="text/css" rel="stylesheet">
-
- <input type="hidden" id="isHeaderBleeding" value="true">
- <div id="ux-header" dir="ltr" class="ltr msdn">
-
- <header>
- <span id="singleCol"></span>
- <span id="doubleCol"></span>
- <span id="isMobile"></span>
- <div>
- <div class="row topRow">
- <div class="top">
- <div class="left">
- <a class="msdnLogoImg" href="https://msdn.microsoft.com/en-us" title="MSDN home">
- <div id="msft-logo" class="msft-logo"></div>
- </a>
- <div class="GrayPipe"></div>
- <a class="DevCenterFullNameNonMegaBlade" href="https://msdn.microsoft.com/en-us">Developer Network</a>
- <a class="DevCenterFullName" href="https://msdn.microsoft.com/en-us">Developer Network</a>
- <a class="DevCenterShortName" href="https://msdn.microsoft.com/en-us">Developer</a>
- </div>
- <div class="right">
- <div id="signIn">
- <div class="profileImage"></div>
- <a class="scarabLink" href="https://login.live.com/login.srf?wa=wsignin1.0&rpsnv=12&ct=1459376425&rver=6.0.5276.0&wp=mcmbi&wlcxt=msdn%24msdn%24msdn&wreply=https%3a%2f%2fmsdn.microsoft.com%2fen-us%2flibrary%2fff554887%2528d%3dprinter%2cv%3dvs.85%2529.aspx%3flan%3dcsharp%26cc%3dn%26trm%3dtra%26view%3dbook&lc=1033&id=254354&mkt=en-us" title="Sign in">Sign in</a></div>
- <div class="auxNav">
- <div>
- <div data-fragmentname="Subscriptions" id="Fragment_Subscriptions" xmlns="http://www.w3.org/1999/xhtml">
- <a href="https://msdn.microsoft.com/subscriptions/manage/hh442900" id="Subscriptions_2153_1" xmlns="http://www.w3.org/1999/xhtml">MSDN subscriptions</a>
- </div>
- <div data-fragmentname="GetTools" id="Fragment_GetTools" xmlns="http://www.w3.org/1999/xhtml">
- <a href="http://go.microsoft.com/fwlink/?LinkId=309297&clcid=0x409&slcid=0x409&campaign=o~msft~msdn~gettools-header~dn308572" id="GetTools_2153_3" xmlns="http://www.w3.org/1999/xhtml">Get tools</a>
- </div>
- </div>
- <div>
- <div data-fragmentname="SocialLinks" id="Fragment_SocialLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <ul class="links horizontal">
- <li>
- <a href="http://www.facebook.com/microsoftdeveloper" target="_blank" id="SocialLinks_2152_4" class="facebook" xmlns="http://www.w3.org/1999/xhtml">http://www.facebook.com/microsoftdeveloper</a>
- </li>
- <li>
- <a href="https://twitter.com/msdev" target="_blank" id="SocialLinks_2152_5" class="twitter" xmlns="http://www.w3.org/1999/xhtml">https://twitter.com/msdev</a>
- </li>
- <li>
- <a href="http://plus.google.com/111221966647232053570/" target="_blank" id="SocialLinks_2152_6" class="googlePlus" xmlns="http://www.w3.org/1999/xhtml">http://plus.google.com/111221966647232053570/</a>
- </li>
- </ul>
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- <div class="row middleRow">
- <div class="expandTop">
- <div class="left"></div>
- <div class="right"></div>
- </div>
- </div>
- </div>
- <div id="buttomRowWrapper" class="bg_default">
- <div class="row buttomRow bg_default">
- <div class="bottom">
- <div class="left">
- <a id="grip" class="menu-icon" href="javascript:void(0)"></a>
-
- <div id="drawer">
- <div class="toc">
-
- <nav>
- <ul class="navL1">
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Technologies">Technologies</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/cloud-app-development-msdn" title="Cloud">Cloud</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/app-development-msdn" title="App Development">App Development</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/web-app-development-msdn" title="Web">Web</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/big-data-development-msdn" title="Data">Data</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/games-development-msdn" title="Gaming">Gaming</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/internetofthings" title="Internet of Things">Internet of Things</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Downloads">Downloads</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://www.visualstudio.com/downloads/download-visual-studio-vs" title="Visual Studio">Visual Studio</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/subscriptions" title="MSDN subscription access">MSDN subscription access</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/microsoft-sdks-msdn" title="SDKs">SDKs</a>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Trial software">Trial software</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/evalcenter" title="Free downloads">Free downloads</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/officeevaluationresources" title="Office resources">Office resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/sharepoint2013resources" title="SharePoint Server 2013 resources">SharePoint Server 2013 resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/sqlserver2014expressresources" title="SQL Server 2014 Express resources">SQL Server 2014 Express resources</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/windowsserver2012r2resources" title="Windows Server 2012 resources">Windows Server 2012 resources</a>
- </li>
- </ul>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Programs">Programs</a>
- <ul class="navL2">
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Visual Studio subscriptions">Visual Studio subscriptions</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/msdn-subscriptions-overview" title="Overview">Overview</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/benefits-overview" title="Benefits">Benefits</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/msdn-subscriptions-administration" title="Administrators">Administrators</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Students">Students</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/imagine/imagine-home" title="Microsoft Imagine">Microsoft Imagine</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/microsoftstudentpartners" title="Microsoft Student Partners">Microsoft Student Partners</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Architects">Architects</a>
- <ul class="navL3">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-overview-msdn" title="Overview">Overview</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-case-studies-msdn" title="Case studies">Case studies</a>
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/architects-blueprints-msdn" title="Blueprints">Blueprints</a>
- </li>
- <li class="inactive">
- <a href="http://blogs.msdn.com/b/msarchitecture/" title="Blog">Blog</a>
- </li>
- <li class="inactive">
- <a href="http://social.msdn.microsoft.com/forums/en-us/home?brandignore=true&sort=relevancedesc&searchterm=architecture+or+architect" title="Forums">Forums</a>
- </li>
- </ul>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/applicationbuilder" title="ISV">ISV</a>
-
- </li>
- <li class="inactive">
- <a href="https://www.microsoft.com/bizspark" title="Startups">Startups</a>
-
- </li>
- <li class="inactive">
- <a href="https://rewards.msdn.microsoft.com/" title="TechRewards">TechRewards</a>
-
- </li>
- <li class="inactive">
- <a href="http://events.msdn.microsoft.com/" title="Events">Events</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive toggle">
- <a href="javascript:void(0)" title="Community">Community</a>
- <ul class="navL2">
- <li class="inactive">
- <a href="https://msdn.microsoft.com/magazine/dd767791" title="Magazine">Magazine</a>
-
- </li>
- <li class="inactive">
- <a href="https://social.msdn.microsoft.com/forums/" title="Forums">Forums</a>
-
- </li>
- <li class="inactive">
- <a href="http://blogs.msdn.com/b/developer-tools/" title="Blogs">Blogs</a>
-
- </li>
- <li class="inactive">
- <a href="http://tech-advisors.msdn.microsoft.com/en-us" title="Tech Advisors">Tech Advisors</a>
-
- </li>
- <li class="inactive">
- <a href="http://channel9.msdn.com/" title="Channel 9">Channel 9</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive current toggle">
- <a href="javascript:void(0)" title="Documentation">Documentation</a>
- <ul class="navL2">
- <li class="inactive current">
- <a href="https://msdn.microsoft.com/library" title="APIs and reference">APIs and reference</a>
-
- </li>
- <li class="inactive">
- <a href="https://msdn.microsoft.com/developer-centers-msdn" title="Dev centers">Dev centers</a>
-
- </li>
- </ul>
- </li>
- <li class="inactive">
- <a href="https://code.msdn.microsoft.com/" title="Samples">Samples</a>
- </li>
- </ul>
- </nav>
- </div>
- </div>
- </div>
- <div class="right">
- <div data-fragmentname="SearchBox" id="Fragment_SearchBox" xmlns="http://www.w3.org/1999/xhtml">
- <div class="SearchBox">
- <form id="HeaderSearchForm" name="HeaderSearchForm" method="get">
- <button id="FakeHeaderSearchButton" value="Search" type="submit" class="header-search-button">
- <div id="search-finder" class="search-finder"></div>
- </button>
- <button id="HeaderSearchButton" style="display:none"></button>
- <div id="searchSplitter"></div>
- <div id="searchCloseIcon" class="search-clear-x"></div>
- <div id="searchTextContainer" style="width: 0;">
- <input id="HeaderSearchTextBox" name="query" type="text" maxlength="200" onfocus="Epx.Controls.SearchBox.watermarkFocus(event, this.title)" onblur="Epx.Controls.SearchBox.watermarkBlur(event, this.title)">
- </div>
- </form>
-
-
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- </header>
- </div>
-
-
-
- <div class="printExportMenus ltr">
- <a id="isd_printABook" href="http://msdn.microsoft.com/en-us/library/export/help/(d=printer)?returnurl=%2fen-us%2flibrary%2fff554887(d%3dprinter,v%3dvs.85).aspx%3flan%3dcsharp%26cc%3dn%26trm%3dtra%26view%3dbook">
- Export (<span class="count">0</span>)
- </a>
- <a id="isd_print" href="https://msdn.microsoft.com/en-us/library/ff554887(d=printer,v=vs.85).aspx?lan=csharp&cc=n&trm=tra&view=book" rel="nofollow">
- Print
- </a>
- <a id="isd_archiveControl" style="display:none;" data-include-archive="Include Previous Version" data-exclude-archive="Exclude Previous Version">
- </a>
- </div>
-
- <div class="printExportMenus ltr">
- <a id="expandCollapseAll" accesskey="e" href="javascript:void(0)" title="Expand/Collapse all sections by pressing Ctrl + Shift + e">Expand All</a>
- </div>
-
- <div id="body" ms.pgarea="body">
- <span id="tabletView_large"></span>
- <span id="tabletView_small"></span>
- <span id="mobileView"></span>
-
- <div id="content" class="content">
- <input type="hidden" id="printForPab" value="true">
-
- <div class="topic" xmlns="http://www.w3.org/1999/xhtml">
- <h1 class="title">Writing drivers for different versions of Windows</h1>
-
- <div id="mainSection">
- <div class="clsServerSDKContent">
- </div>
- <p>When you create a driver project, you specify the minimum target operating system, which is the minimum version of Windows that your driver will run on. For example, you could specify that Windows 7 is the minimum target operating system. In that case, your driver would run on Windows 7 and later versions of Windows.</p>
- <div class="alert"><strong>Note</strong> If you develop a driver for a particular minimum version of Windows and you want your driver to work on later versions of Windows, you must not use any undocumented functions, and you must not use documented functions in any way other than how it is described in the documentation. Otherwise your driver might fail to run on the later versions of Windows. Even if you have been careful to use only documented functions, you should test your driver on the new version of Windows each time one is released.</div>
- <div> </div>
- <h2><a id="Writing_a_multiversion_driver_using_only_common_features"></a><a id="writing_a_multiversion_driver_using_only_common_features"></a><a id="WRITING_A_MULTIVERSION_DRIVER_USING_ONLY_COMMON_FEATURES"></a>Writing a multiversion driver using only common features</h2>
- <p>When you design a driver that will run on multiple versions of Windows, the simplest approach is to allow the driver to use only DDI functions and structures that are common to all versions of Windows that the driver will run on. In this situation, you set the minimum target operating system to the earliest version of Windows that the driver will support.</p>
- <p>For example, to support all versions of Windows, starting with Windows 7, you should:</p>
- <ol>
- <li>
- <p>Design and implement the driver so that it uses only those features that are present in Windows 7. </p>
- </li>
- <li>
- <p>When you build your driver, specify Windows 7 as the minimum target operating system.</p>
- </li>
- </ol>
- <p>While this process is simple, it might restrict the driver to use only a subset of the functionality that is available on later versions of Windows. </p>
- <h2><a id="Writing_a_multiversion_driver_that_uses_version-dependent_features"></a><a id="writing_a_multiversion_driver_that_uses_version-dependent_features"></a><a id="WRITING_A_MULTIVERSION_DRIVER_THAT_USES_VERSION-DEPENDENT_FEATURES"></a>Writing a multiversion driver that uses version-dependent features</h2>
- <p>A kernel-mode driver can dynamically determine which version of Windows it is running on and choose to use features that are available in that version. For example, a driver that must support all versions of Windows, starting with Windows 7, can determine, at run time, the version of Windows that it is running on. If the driver is running on Windows 7, it must use only the DDI functions that Windows 7 supports. However, the same driver can use additional DDI functions that are unique to Windows 8, for example, when its run-time check determines that it is running on Windows 8.</p>
- <h3><a id="determining_the_windows_version"></a><a id="DETERMINING_THE_WINDOWS_VERSION"></a>Determining the Windows version</h3>
- <p>
- <a href="https://msdn.microsoft.com/en-us/library/ff561954(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">RtlIsNtDdiVersionAvailable</strong></a> is a function that drivers can use to determine, at run time, if the features that are provided by a particular version of Windows are available. The prototype for this function is as follows:</p>
- <div id="code-snippet-1" class="codeSnippetContainer" xmlns="http://www.w3.org/1999/xhtml">
- <div class="codeSnippetContainerTabs">
- <div class="codeSnippetContainerTab codeSnippetContainerTabActive" dir="ltr">
- <a></a>
- </div>
- </div>
- <div class="codeSnippetContainerCodeContainer">
- <div class="codeSnippetToolBar"></div>
- <div class="codeSnippetContainerCode" dir="ltr">
- <div style="color:Black;"><pre>
- BOOLEAN RtlIsNtDdiVersionAvailable(IN ULONG Version)
- </pre></div>
- </div>
- </div>
- </div>
- <p>In this prototype, <em>Version</em> is a value that indicates the required version of the Windows DDI. This value must be one of the DDI version constants, defined in sdkddkver.h, such as NTDDI_WIN8 or NTDDI_WIN7.</p>
- <p>
- <a href="https://msdn.microsoft.com/en-us/library/ff561954(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">RtlIsNtDdiVersionAvailable</strong></a> returns TRUE when the caller is running on a version of Windows that is the same as, or later than, the one that is specified by <em>Version.</em></p>
- <p>Your driver can also check for a specific service pack by calling the <a href="https://msdn.microsoft.com/en-us/library/ff561956(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">RtlIsServicePackVersionInstalled</strong></a> function. The prototype for this function is as follows:</p>
- <div id="code-snippet-2" class="codeSnippetContainer" xmlns="http://www.w3.org/1999/xhtml">
- <div class="codeSnippetContainerTabs">
- <div class="codeSnippetContainerTab codeSnippetContainerTabActive" dir="ltr">
- <a></a>
- </div>
- </div>
- <div class="codeSnippetContainerCodeContainer">
- <div class="codeSnippetToolBar"></div>
- <div class="codeSnippetContainerCode" dir="ltr">
- <div style="color:Black;"><pre>
- BOOLEAN RtlIsServicePackVersionInstalled(IN ULONG Version)
- </pre></div>
- </div>
- </div>
- </div>
- <p>In this prototype, <em>Version</em> is a value that indicates the required Windows version and service pack. This value must be one of the DDI version constants, defined in sdkddkver.h, such as NTDDI_WS08SP3.</p>
- <p>Note that <a href="https://msdn.microsoft.com/en-us/library/ff561956(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">RtlIsServicePackVersionInstalled</strong></a> returns TRUE only when the operating system version exactly matches the specified version. Thus, a call to <strong>RtlIsServicePackVersionInstalled</strong> with <em>Version</em> set to NTDDI_WS08SP3 will fail if the driver is not running on Windows Server 2008 with SP4.</p>
- <h3><a id="conditionally_calling_windows_version_dependent_functions"></a><a id="CONDITIONALLY_CALLING_WINDOWS_VERSION_DEPENDENT_FUNCTIONS"></a>Conditionally calling Windows version-dependent functions</h3>
- <p>After a driver determines that a specific operating system version is available on the computer, the driver can use the <a href="https://msdn.microsoft.com/en-us/library/ff554563(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">MmGetSystemRoutineAddress</strong></a> function to dynamically locate the routine and call it through a pointer. This function is available in Windows 7 and later operating system versions.</p>
- <div class="alert"><strong>Note</strong> To help preserve type checking and prevent unintentional errors, you should create a typedef that mirrors the original function type. </div>
- <div> </div>
- <h3><a id="example__determining_the_windows_version_and_conditionally_calling_a_v"></a><a id="EXAMPLE__DETERMINING_THE_WINDOWS_VERSION_AND_CONDITIONALLY_CALLING_A_V"></a>Example: Determining the Windows version and conditionally calling a version-dependent function</h3>
- <p>This code example, which is from a driver's header file, defines the PAISQSL type as a pointer to the <a href="https://msdn.microsoft.com/en-us/library/ff551899(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">KeAcquireInStackQueuedSpinLock</strong></a> function. The example then declares a <code>AcquireInStackQueuedSpinLock</code> variable with this type.</p>
- <div id="code-snippet-3" class="codeSnippetContainer" xmlns="http://www.w3.org/1999/xhtml">
- <div class="codeSnippetContainerTabs">
- <div class="codeSnippetContainerTab codeSnippetContainerTabActive" dir="ltr">
- <a></a>
- </div>
- </div>
- <div class="codeSnippetContainerCodeContainer">
- <div class="codeSnippetToolBar"></div>
- <div class="codeSnippetContainerCode" dir="ltr">
- <div style="color:Black;"><pre>
- ...
- //
- // Pointer to the ordered spin lock function.
- // This function is only available on Windows 7 and
- // later systems
- typedef (* PAISQSL) (KeAcquireInStackQueuedSpinLock);
- PAISQSL AcquireInStackQueued = NULL;
- ...
-
- </pre></div>
- </div>
- </div>
- </div>
- <p>This code example, which is from the driver's initialization code, determines whether the driver is running on Windows 7 or a later operating system. If it is, the code retrieves a pointer to <a href="https://msdn.microsoft.com/en-us/library/ff551899(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">KeAcquireInStackQueuedSpinLock</strong></a>. </p>
- <div id="code-snippet-4" class="codeSnippetContainer" xmlns="http://www.w3.org/1999/xhtml">
- <div class="codeSnippetContainerTabs">
- <div class="codeSnippetContainerTab codeSnippetContainerTabActive" dir="ltr">
- <a></a>
- </div>
- </div>
- <div class="codeSnippetContainerCodeContainer">
- <div class="codeSnippetToolBar"></div>
- <div class="codeSnippetContainerCode" dir="ltr">
- <div style="color:Black;"><pre>
- ...
-
- //
- // Are we running on Windows 7 or later?
- //
- if (RtlIsNtDdiVersionAvailable(NTDDI_WIN7) ) {
-
- //
- // Yes... Windows 7 or later it is!
- //
- RtlInitUnicodeString(&funcName,
- L"KeAcquireInStackQueuedSpinLock");
-
- //
- // Get a pointer to Windows implementation
- // of KeAcquireInStackQueuedSpinLock into our
- // variable "AcquireInStackQueued"
- AcquireInStackQueued = (PAISQSL)
- MmGetSystemRoutineAddress(&funcName);
- }
-
- ...
- // Acquire a spin lock.
-
- if( NULL != AcquireInStackQueued) {
- (AcquireInStackQueued)(&SpinLock, &lockHandle);
- } else {
- KeAcquireSpinLock(&SpinLock);
- }
-
- </pre></div>
- </div>
- </div>
- </div>
- <p>In the example the driver calls <a href="https://msdn.microsoft.com/en-us/library/ff561954(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">RtlIsNtDdiVersionAvailable</strong></a> to determine whether the driver is running on Windows 7 or later. If the version is Windows 7 or later, the driver calls <a href="https://msdn.microsoft.com/en-us/library/ff554563(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">MmGetSystemRoutineAddress</strong></a> to get a pointer to the <a href="https://msdn.microsoft.com/en-us/library/ff551899(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">KeAcquireInStackQueuedSpinLock</strong></a> function and stores this pointer in the variable named <code>AcquireInStackQueued</code> (which was declared as a PAISQSL type).</p>
- <p>Later, when the driver must acquire a spin lock, it checks to see whether it has received a pointer to the <a href="https://msdn.microsoft.com/en-us/library/ff551899(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">KeAcquireInStackQueuedSpinLock</strong></a> function. If the driver has received this pointer, the driver uses the pointer to call <strong>KeAcquireInStackQueuedSpinLock</strong>. If the pointer to <strong>KeAcquireInStackQueuedSpinLock</strong> is null, the driver uses <a href="https://msdn.microsoft.com/en-us/library/ff551917(v=vs.85).aspx"><strong xmlns="http://www.w3.org/1999/xhtml">KeAcquireSpinLock</strong></a> to acquire the spin lock.</p>
- <p> </p>
- <p> </p>
- <p><a href="mailto:wsddocfb@microsoft.com?subject=Documentation%20feedback%20[wdkgetstart\wdkgetstart]:%20Writing%20drivers%20for%20different%20versions%20of%20Windows%20%20RELEASE:%20(3/4/2016)&body=%0A%0APRIVACY%20STATEMENT%0A%0AWe%20use%20your%20feedback%20to%20improve%20the%20documentation.%20We%20don%27t%20use%20your%20email%20address%20for%20any%20other%20purpose,%20and%20we%27ll%20remove%20your%20email%20address%20from%20our%20system%20after%20the%20issue%20that%20you%27re%20reporting%20is%20fixed.%20While%20we%27re%20working%20to%20fix%20this%20issue,%20we%20might%20send%20you%20an%20email%20message%20to%20ask%20for%20more%20info.%20Later,%20we%20might%20also%20send%20you%20an%20email%20message%20to%20let%20you%20know%20that%20we%27ve%20addressed%20your%20feedback.%0A%0AFor%20more%20info%20about%20Microsoft%27s%20privacy%20policy,%20see%20http://privacy.microsoft.com/en-us/default.aspx." title="Send comments about this topic to Microsoft">Send comments about this topic to Microsoft</a></p>
- </div>
- </div>
-
- </div>
- </div>
- <div class="clear"></div>
-
- <input name="__RequestVerificationToken" type="hidden" value="JptfarzzsqmAcEj8i7r-GuOsOjryrVn1xtKGqVeRsq3Lg9fuDow3XWWeMaDMUESY7kv3bafp5-XXRH5iPPAWMR5Bqp01">
- <input id="ratingValueSubmitUrl" type="hidden" value="https://msdn.microsoft.com/en-us/library/feedback/rate/ff554887(d=printer,v=vs.85).aspx">
- <input id="ratingAdditionalSubmitUrl" type="hidden" value="https://msdn.microsoft.com/en-us/library/feedback/additional/ff554887(d=printer,v=vs.85).aspx">
- <input id="isTopicRated" type="hidden" value="false">
- <div id="lib-footer" ms.pgarea="body">
-
-
- <link type="text/css" rel="stylesheet">
-
- <div id="ux-footer" class="" style="" dir="ltr">
-
- <div id="footerSock" class="librarySock both">
- <div id="footerSockInner">
- <a name="feedback"></a>
- <div class="rating">
- <div id="ratingSection1">
- <div class="title">
- Was this page helpful?
- </div>
- <div class="description">
- Your feedback about this content is important.<br>Let us know what you think.
- </div>
- <div class="buttons">
- <button class="button" id="ratingYes" aria-label="Yes, this page was helpful">Yes</button>
- <button class="button" id="ratingNo" aria-label="No, this page was not helpful">No</button>
- </div>
- <input id="ratingValue" type="hidden" value="">
- </div>
- <div id="ratingSection2">
- <div class="title left">
- Additional feedback?
- </div>
- <textarea id="ratingText" rows="6" cols="" maxlength="1500"></textarea>
- <div class="right">
- <div class="counter">
- <span id="feedbackTextCounter">1500</span> characters remaining
- </div>
- <div class="buttons">
- <button class="button" id="ratingSubmit" aria-label="Submit my additional feedback">Submit</button>
- <button class="button" id="ratingSkipThis" aria-label="Skip additional feedback">Skip this</button>
- </div>
- </div>
- </div>
- <div id="ratingSection3">
- <div class="title">
- Thank you!
- </div>
- <div class="description">
- We appreciate your feedback.
- </div>
- </div>
-
-
- <div id="contentFeedbackQAContainer" style="display: none;"></div>
- </div>
-
- <div class="userVoice">
- <div class="title">
- Help us improve MSDN.
- </div>
- <div class="description">
- Visit our UserVoice Page to submit and vote on ideas!
- </div>
- <div class="buttons">
- <a class="button" id="userVoiceButton" href="http://feedback.msdn.com/forums/257782-msdn-feature-suggestions/category/83975" target="_blank">Make a suggestion</a>
- </div>
- </div>
- <div class="clear"></div>
- </div>
- </div>
- <footer class="top">
- <div data-fragmentname="LeftLinks" id="Fragment_LeftLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Dev centers</div>
- <ul class="links">
- <li>
- <a href="https://dev.windows.com/" id="LeftLinks_2148_1" class="windowsBlue" xmlns="http://www.w3.org/1999/xhtml">Windows</a>
- </li>
- <li>
- <a href="http://dev.office.com/" id="LeftLinks_2148_3" class="office" xmlns="http://www.w3.org/1999/xhtml">Office</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/vstudio" id="LeftLinks_2148_4" class="visualStudio" xmlns="http://www.w3.org/1999/xhtml">Visual Studio</a>
- </li>
- <li>
- <a href="http://azure.microsoft.com/en-us/documentation/" target="_blank" id="LeftLinks_2148_12" xmlns="http://www.w3.org/1999/xhtml">Microsoft Azure</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/developer-centers-msdn" id="LeftLinks_2148_5" xmlns="http://www.w3.org/1999/xhtml">More...</a>
- </li>
- </ul>
- </div>
- </div>
- <div id="rightLinks">
- <div data-fragmentname="CenterLinks1" id="Fragment_CenterLinks1" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Learning resources</div>
- <ul class="links">
- <li>
- <a href="http://www.microsoftvirtualacademy.com/" id="CenterLinks1_2151_4" xmlns="http://www.w3.org/1999/xhtml">Microsoft Virtual Academy</a>
- </li>
- <li>
- <a href="http://channel9.msdn.com/" id="CenterLinks1_2151_5" xmlns="http://www.w3.org/1999/xhtml">Channel 9</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/magazine/" id="CenterLinks1_2151_7" xmlns="http://www.w3.org/1999/xhtml">MSDN Magazine</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks2" id="Fragment_CenterLinks2" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Community</div>
- <ul class="links">
- <li>
- <a href="https://social.msdn.microsoft.com/forums/en-us/home" id="CenterLinks2_2151_8" xmlns="http://www.w3.org/1999/xhtml">Forums</a>
- </li>
- <li>
- <a href="http://blogs.msdn.com/b/developer-tools/" id="CenterLinks2_2151_9" xmlns="http://www.w3.org/1999/xhtml">Blogs</a>
- </li>
- <li>
- <a href="http://www.codeplex.com/" id="CenterLinks2_2151_10" xmlns="http://www.w3.org/1999/xhtml">Codeplex</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks3" id="Fragment_CenterLinks3" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Support</div>
- <ul class="links">
- <li>
- <a href="https://msdn.microsoft.com/hh361695" id="CenterLinks3_2151_11" xmlns="http://www.w3.org/1999/xhtml">Self support</a>
- </li>
- </ul>
- </div>
- </div>
- <div data-fragmentname="CenterLinks4" id="Fragment_CenterLinks4" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <div class="linkListTitle">Programs</div>
- <ul class="links">
- <li>
- <a href="https://www.microsoft.com/bizspark/" id="CenterLinks4_2151_13" xmlns="http://www.w3.org/1999/xhtml">BizSpark (for startups)</a>
- </li>
- <li>
- <a href="https://www.dreamspark.com/" id="CenterLinks4_2151_14" xmlns="http://www.w3.org/1999/xhtml">DreamSpark</a>
- </li>
- <li>
- <a href="http://www.imaginecup.com/" id="CenterLinks4_2151_17" xmlns="http://www.w3.org/1999/xhtml">Imagine Cup</a>
- </li>
- </ul>
- </div>
- </div>
- </div>
- </footer>
- <footer class="bottom">
- <span class="localeContainer">
-
- <form class="selectLocale" id="selectLocaleForm" action="https://msdn.microsoft.com/en-us/selectlocale-dmc">
- <input type="hidden" name="fromPage" value="https%3a%2f%2fmsdn.microsoft.com%2fen-us%2flibrary%2fff554887(d%3dprinter%2cv%3dvs.85).aspx%3flan%3dCSharp%26cc%3dn%26trm%3dtra%26view%3dbook">
- <a href="http://msdn.microsoft.com/#" onclick="$('#selectLocaleForm').submit();return false;" title="Change your language">United States (English)</a>
- </form>
- </span>
- <div data-fragmentname="BottomLinks" id="Fragment_BottomLinks" xmlns="http://www.w3.org/1999/xhtml">
-
- <div class="linkList">
- <ul class="links horizontal">
- <li>
- <a href="https://msdn.microsoft.com/newsletter.aspx" id="BottomLinks_2148_7" xmlns="http://www.w3.org/1999/xhtml">Newsletter</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/dn529288" id="BottomLinks_2148_8" xmlns="http://www.w3.org/1999/xhtml">Privacy & cookies</a>
- </li>
- <li>
- <a href="https://msdn.microsoft.com/cc300389" id="BottomLinks_2148_9" xmlns="http://www.w3.org/1999/xhtml">Terms of use</a>
- </li>
- <li>
- <a href="https://www.microsoft.com/en-us/legal/intellectualproperty/Trademarks/EN-US.aspx" id="BottomLinks_2148_10" xmlns="http://www.w3.org/1999/xhtml">Trademarks</a>
- </li>
- </ul>
- </div>
- </div>
- <span class="logoLegal">
- <span class="logo"></span>
- <span class="copyright">© 2016 Microsoft</span>
- </span>
- </footer>
- </div>
-
- </div>
- <div class="footerPrintView">
- <div class="footerCopyrightPrintView">© 2016 Microsoft</div>
- </div>
-
-
-
-
- <input id="tocPaddingPerLevel" type="hidden" value="17">
- <input id="MtpsDevice" type="hidden" value="Printer">
- <!--[CDATA[ Third party scripts and code linked to or referenced from this website are licensed to you by the parties that own such code, not by Microsoft. See ASP.NET Ajax CDN Terms of Use – http://www.asp.net/ajaxlibrary/CDN.ashx. ]]-->
-
-
-
-
-
- <noscript><div><img alt="DCSIMG" id="Img1" width="1" height="1" src="https://m.webtrends.com/dcsmgru7m99k7mqmgrhudo0k8_8c6m/njs.gif?dcsuri=/nojavascript&amp;WT.js=No" /></div></noscript>
- <div id="globalRequestVerification">
- <input name="__RequestVerificationToken" type="hidden" value="F3UvdPo5EosJimvWSZG06N1SN0PiydqJYUaPgOTLdO1DspN2nBCNSOq3Y_M0WX14oRtwAqI6ZEAkAdgwqJ8kksrWdkk1">
- </div>
- </div>
-
-
-
-
-
-
- <script type="text/javascript" class="mtps-injected">
- /*<![CDATA[*/
- (function(window,document){"use strict";function preload(scripts){for(var result=[],script,e,i=0;i<scripts.length;i++)script=scripts[i],script.hasOwnProperty("url")&&(e=document.createElement("script"),e.src=script.url,script.throwaway=e),result.push(script);return result}function inject(scripts,index){var script,elem;if(index>=scripts.length){delete mtps.injectScripts;return}script=scripts[index];elem=document.createElement("script");elem.className="mtps-injected";elem.async=!1;var isLoaded=!1,timeoutId=0,injectNextFnName="",injectNext=elem.onerror=function(){isLoaded||(isLoaded=!0,inject(scripts,index+1),window.clearTimeout(timeoutId),elem.onload=elem.onerror=elem.onreadystatechange=null,injectNextFnName&&delete mtps[injectNextFnName],elem.removeEventListener&&elem.removeEventListener("load",injectNext,!1))};elem.addEventListener?elem.addEventListener("load",injectNext,!1):elem.readyState==="uninitialized"?elem.onreadystatechange=function(){(this.readyState==="loaded"||this.readyState==="complete")&&injectNext()}:elem.onload=injectNext;script.hasOwnProperty("url")?(timeoutId=window.setTimeout(injectNext,12e4),elem.src=script.url):(injectNextFnName="_injectNextScript_"+index,mtps[injectNextFnName]=injectNext,timeoutId=window.setTimeout(injectNext,2e3),elem.text="try {\n"+script.txt+"\n} finally { MTPS."+injectNextFnName+" && MTPS."+injectNextFnName+"(); }");parent.appendChild(elem)}var mtps=window.MTPS||(window.MTPS={}),parent=document.getElementsByTagName("head")[0];mtps.injectScripts=function(scripts){inject(preload(scripts),0)}})(window,document);
- MTPS.injectScripts([
- { txt: "/**/\r\n(window.MTPS || (window.MTPS = {})).cdnDomains || (window.MTPS.cdnDomains = { \r\n\t\"image\": \"https://i-msdn.sec.s-msft.com\", \r\n\t\"js\": \"https://i2-msdn.sec.s-msft.com\", \r\n\t\"css\": \"https://i-msdn.sec.s-msft.com\", \r\n\t\"ttf\": \"https://i-msdn.sec.s-msft.com\"\r\n});\r\n/**/" },
- { txt: "//\n var literalNormalizedUrl = \u0027/en-us/library/ff554887(d=printer,l=en-us,v=vs.85).aspx\u0027;\n var wt_nvr_ru = \u0027WT_NVR_RU\u0027;\n var wt_fpcdom = \u0027.microsoft.com\u0027;\n var wt_domlist = \u0027msdn.microsoft.com\u0027;\n var wt_pathlist = \u0027\u0027;\n var wt_paramlist = \u0027DCSext.mtps_devcenter\u0027;\n var wt_siteid = \u0027MSDN\u0027;\n var gDomain = \u0027m.webtrends.com\u0027;\n var gDcsId = \u0027dcsmgru7m99k7mqmgrhudo0k8_8c6m\u0027;\n var gFpc = \u0027WT_FPC\u0027;\n\n\n\n if (document.cookie.indexOf(gFpc + \"=\") == -1) {\n var wtidJs = document.createElement(\"script\");\n wtidJs.src = \"//\" + gDomain + \"/\" + gDcsId + \"/wtid.js\";\n document.getElementsByTagName(\"head\")[0].appendChild(wtidJs);\n }\n\n\n\n var detectedLocale = \u0027en-us\u0027;\n var wtsp = \u0027msdnlib_w32_com\u0027;\n var gTrackEvents = \u00270\u0027;\n/**/" },
- { txt: "//\n\n window.appInsightsId = \u00275eb1b2eb-c47a-497a-a7ac-a1c230b2882f\u0027;\n //" },
- { url: "https://i2-msdn.sec.s-msft.com/Combined.js?resources=0:Utilities,1:Layout,2:Header,1:Rating,2:Footer,0:Topic,3:PabTopic,4:webtrendsscript,0:AppInsightsPerf,0:ABTestControl,5:WEDCS,3:CmpgrpForHeader,0:livefyre,0:Comment,1:SearchBox;/Areas/Epx/Content/Scripts:0,/Areas/Epx/Themes/Base/Content:1,/Areas/Centers/Themes/StandardDevCenter/Content:2,/Areas/Library/Content:3,/Areas/Global/Content/Webtrends/resources:4,/Areas/Library/Themes/Base/Content:5\u0026amp;hashKey=30CEE944AABFEA2C5A338BDB9E000732\u0026amp;v=AE608271C0243AAA0449D3BC0FAD8EB4" },
- { url: "https://i1.services.social.microsoft.com/search/Widgets/SearchBox.jss?boxid=HeaderSearchTextBox\u0026btnid=HeaderSearchButton\u0026pgArea=header\u0026brand=Msdn\u0026loc=en-us\u0026focusOnInit=false\u0026emptyWatermark=true\u0026searchButtonTooltip=Search MSDN" },
- { url: "https://i2-msdn.sec.s-msft.com/Combined.js?resources=0:PrintExportButton,1:Toc_Fixed,1:CodeSnippet,1:TopicNotInScope,1:CollapsibleArea,1:VersionSelector,1:SurveyBroker;/Areas/Library/Themes/Base/Content:0,/Areas/Epx/Content/Scripts:1\u0026amp;hashKey=80F30894E3FB8A3295C923AEC7019CFE\u0026amp;v=AE608271C0243AAA0449D3BC0FAD8EB4" },
- { txt: "$(document).ready(function() {\n try {\n var token = $(\"#globalRequestVerification input[name=\u0027__RequestVerificationToken\u0027]\").clone();\n $(\"#siteFeedbackForm\").append(token);\n } catch(err) {\n \n }\n });" }
- ]);
- /*]]>*/
- </script>
- </body></html>
|
