Tao.Platform.Windows.xml 282 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353235423552356235723582359236023612362236323642365236623672368236923702371237223732374237523762377237823792380238123822383238423852386238723882389239023912392239323942395239623972398239924002401240224032404240524062407240824092410241124122413241424152416241724182419242024212422242324242425242624272428242924302431243224332434243524362437243824392440244124422443244424452446244724482449245024512452245324542455245624572458245924602461246224632464246524662467246824692470247124722473247424752476247724782479248024812482248324842485248624872488248924902491249224932494249524962497249824992500250125022503250425052506250725082509251025112512251325142515251625172518251925202521252225232524252525262527252825292530253125322533253425352536253725382539254025412542254325442545254625472548254925502551255225532554255525562557255825592560256125622563256425652566256725682569257025712572257325742575257625772578257925802581258225832584258525862587258825892590259125922593259425952596259725982599260026012602260326042605260626072608260926102611261226132614261526162617261826192620262126222623262426252626262726282629263026312632263326342635263626372638263926402641264226432644264526462647264826492650265126522653265426552656265726582659266026612662266326642665266626672668266926702671267226732674267526762677267826792680268126822683268426852686268726882689269026912692269326942695269626972698269927002701270227032704270527062707270827092710271127122713271427152716271727182719272027212722272327242725272627272728272927302731273227332734273527362737273827392740274127422743274427452746274727482749275027512752275327542755275627572758275927602761276227632764276527662767276827692770277127722773277427752776277727782779278027812782278327842785278627872788278927902791279227932794279527962797279827992800280128022803280428052806280728082809281028112812281328142815281628172818281928202821282228232824282528262827282828292830283128322833283428352836283728382839284028412842284328442845284628472848284928502851285228532854285528562857285828592860286128622863286428652866286728682869287028712872287328742875287628772878287928802881288228832884288528862887288828892890289128922893289428952896289728982899290029012902290329042905290629072908290929102911291229132914291529162917291829192920292129222923292429252926292729282929293029312932293329342935293629372938293929402941294229432944294529462947294829492950295129522953295429552956295729582959296029612962296329642965296629672968296929702971297229732974297529762977297829792980298129822983298429852986298729882989299029912992299329942995299629972998299930003001300230033004300530063007300830093010301130123013301430153016301730183019302030213022302330243025302630273028302930303031303230333034303530363037303830393040304130423043304430453046304730483049305030513052305330543055305630573058305930603061306230633064306530663067306830693070307130723073307430753076307730783079308030813082308330843085308630873088308930903091309230933094309530963097309830993100310131023103310431053106310731083109311031113112311331143115311631173118311931203121312231233124312531263127312831293130313131323133313431353136313731383139314031413142314331443145314631473148314931503151315231533154315531563157315831593160316131623163316431653166316731683169317031713172317331743175317631773178317931803181318231833184318531863187318831893190319131923193319431953196319731983199320032013202320332043205320632073208320932103211321232133214321532163217321832193220322132223223322432253226322732283229323032313232323332343235323632373238323932403241324232433244324532463247324832493250325132523253325432553256325732583259326032613262326332643265326632673268326932703271327232733274327532763277327832793280328132823283328432853286328732883289329032913292329332943295329632973298329933003301330233033304330533063307330833093310331133123313331433153316331733183319332033213322332333243325332633273328332933303331333233333334333533363337333833393340334133423343334433453346334733483349335033513352335333543355335633573358335933603361336233633364336533663367336833693370337133723373337433753376337733783379338033813382338333843385338633873388338933903391339233933394339533963397339833993400340134023403340434053406340734083409341034113412341334143415341634173418341934203421342234233424342534263427342834293430343134323433343434353436343734383439344034413442344334443445344634473448344934503451345234533454345534563457345834593460346134623463346434653466346734683469347034713472347334743475347634773478347934803481348234833484348534863487348834893490349134923493349434953496349734983499350035013502350335043505350635073508350935103511351235133514351535163517351835193520352135223523352435253526352735283529353035313532353335343535353635373538353935403541354235433544354535463547354835493550355135523553355435553556355735583559356035613562356335643565356635673568356935703571357235733574357535763577357835793580358135823583358435853586358735883589359035913592359335943595359635973598359936003601360236033604360536063607360836093610361136123613361436153616361736183619362036213622362336243625362636273628362936303631363236333634363536363637363836393640364136423643364436453646364736483649365036513652365336543655365636573658365936603661366236633664366536663667366836693670367136723673367436753676367736783679368036813682368336843685368636873688368936903691369236933694369536963697369836993700370137023703370437053706370737083709371037113712371337143715371637173718371937203721372237233724372537263727372837293730373137323733373437353736373737383739374037413742374337443745374637473748374937503751375237533754375537563757375837593760376137623763376437653766376737683769377037713772377337743775377637773778377937803781378237833784378537863787378837893790379137923793379437953796379737983799380038013802380338043805380638073808380938103811381238133814381538163817381838193820382138223823382438253826382738283829383038313832383338343835383638373838383938403841384238433844384538463847384838493850385138523853385438553856385738583859386038613862386338643865386638673868386938703871387238733874387538763877387838793880388138823883388438853886388738883889389038913892389338943895389638973898389939003901390239033904390539063907390839093910391139123913391439153916391739183919392039213922392339243925392639273928392939303931393239333934393539363937393839393940394139423943394439453946394739483949395039513952395339543955395639573958395939603961396239633964396539663967396839693970397139723973397439753976397739783979398039813982398339843985398639873988398939903991399239933994399539963997399839994000400140024003400440054006400740084009401040114012401340144015401640174018401940204021402240234024402540264027402840294030403140324033403440354036403740384039404040414042404340444045404640474048404940504051405240534054405540564057405840594060406140624063406440654066406740684069407040714072407340744075407640774078407940804081408240834084408540864087408840894090409140924093409440954096409740984099410041014102410341044105410641074108410941104111411241134114411541164117411841194120412141224123412441254126412741284129413041314132413341344135413641374138413941404141414241434144414541464147414841494150415141524153415441554156415741584159416041614162416341644165416641674168416941704171417241734174417541764177417841794180418141824183418441854186418741884189419041914192419341944195419641974198419942004201420242034204420542064207420842094210421142124213421442154216421742184219422042214222422342244225422642274228422942304231423242334234423542364237423842394240424142424243424442454246424742484249425042514252425342544255425642574258425942604261426242634264426542664267426842694270427142724273427442754276427742784279428042814282428342844285428642874288428942904291429242934294429542964297429842994300430143024303430443054306430743084309431043114312431343144315431643174318431943204321432243234324432543264327432843294330433143324333433443354336433743384339434043414342434343444345434643474348434943504351435243534354435543564357435843594360436143624363436443654366436743684369437043714372437343744375437643774378437943804381438243834384438543864387438843894390439143924393439443954396439743984399440044014402440344044405440644074408440944104411441244134414441544164417441844194420442144224423442444254426442744284429443044314432443344344435443644374438443944404441444244434444444544464447444844494450445144524453445444554456445744584459446044614462446344644465446644674468446944704471447244734474447544764477447844794480448144824483448444854486448744884489449044914492449344944495449644974498449945004501450245034504450545064507450845094510451145124513451445154516451745184519452045214522452345244525452645274528452945304531453245334534453545364537453845394540454145424543454445454546454745484549455045514552455345544555455645574558455945604561456245634564456545664567456845694570457145724573457445754576457745784579458045814582458345844585458645874588458945904591459245934594459545964597459845994600460146024603460446054606460746084609461046114612461346144615461646174618461946204621462246234624462546264627462846294630463146324633463446354636463746384639464046414642464346444645464646474648464946504651465246534654465546564657465846594660466146624663466446654666466746684669467046714672467346744675467646774678467946804681468246834684468546864687468846894690469146924693469446954696469746984699470047014702470347044705470647074708470947104711471247134714471547164717471847194720472147224723472447254726472747284729473047314732473347344735473647374738473947404741474247434744474547464747474847494750475147524753475447554756475747584759476047614762476347644765476647674768476947704771477247734774477547764777477847794780478147824783478447854786478747884789479047914792479347944795479647974798479948004801480248034804480548064807480848094810481148124813481448154816481748184819482048214822482348244825482648274828482948304831483248334834483548364837483848394840484148424843484448454846484748484849485048514852485348544855485648574858485948604861486248634864486548664867486848694870487148724873487448754876487748784879488048814882488348844885488648874888488948904891489248934894489548964897489848994900490149024903490449054906490749084909491049114912491349144915491649174918491949204921492249234924492549264927492849294930493149324933493449354936493749384939494049414942494349444945494649474948494949504951495249534954495549564957495849594960496149624963496449654966496749684969497049714972497349744975497649774978497949804981498249834984498549864987498849894990499149924993499449954996499749984999500050015002500350045005500650075008500950105011501250135014501550165017501850195020502150225023502450255026502750285029503050315032503350345035503650375038503950405041504250435044504550465047504850495050505150525053505450555056505750585059506050615062506350645065506650675068506950705071507250735074507550765077507850795080508150825083508450855086508750885089509050915092509350945095509650975098509951005101510251035104510551065107510851095110511151125113511451155116511751185119512051215122512351245125512651275128512951305131513251335134513551365137513851395140514151425143514451455146514751485149515051515152515351545155515651575158515951605161516251635164516551665167516851695170517151725173517451755176517751785179518051815182518351845185518651875188518951905191519251935194519551965197519851995200520152025203520452055206520752085209521052115212521352145215521652175218521952205221522252235224522552265227522852295230523152325233523452355236523752385239524052415242524352445245524652475248524952505251525252535254525552565257525852595260526152625263526452655266526752685269527052715272527352745275527652775278527952805281528252835284528552865287528852895290529152925293529452955296529752985299530053015302530353045305530653075308530953105311531253135314531553165317531853195320532153225323532453255326532753285329533053315332533353345335533653375338533953405341534253435344534553465347534853495350535153525353535453555356535753585359536053615362536353645365536653675368536953705371537253735374537553765377537853795380538153825383538453855386538753885389539053915392539353945395539653975398539954005401540254035404540554065407540854095410541154125413541454155416541754185419542054215422542354245425542654275428542954305431543254335434543554365437543854395440544154425443544454455446544754485449545054515452545354545455545654575458545954605461546254635464546554665467546854695470547154725473547454755476547754785479548054815482548354845485548654875488548954905491549254935494549554965497549854995500550155025503550455055506550755085509551055115512551355145515551655175518551955205521552255235524552555265527552855295530553155325533553455355536553755385539554055415542554355445545554655475548554955505551555255535554555555565557555855595560556155625563556455655566556755685569557055715572557355745575557655775578557955805581558255835584558555865587558855895590559155925593559455955596559755985599560056015602560356045605560656075608560956105611561256135614561556165617561856195620562156225623562456255626562756285629563056315632563356345635563656375638563956405641564256435644564556465647564856495650565156525653565456555656565756585659566056615662566356645665566656675668566956705671567256735674567556765677567856795680568156825683568456855686568756885689569056915692569356945695569656975698569957005701570257035704570557065707570857095710571157125713571457155716571757185719572057215722572357245725572657275728572957305731573257335734573557365737573857395740574157425743574457455746574757485749575057515752575357545755575657575758575957605761576257635764576557665767576857695770577157725773577457755776577757785779578057815782578357845785
  1. <?xml version="1.0"?>
  2. <doc>
  3. <assembly>
  4. <name>Tao.Platform.Windows</name>
  5. </assembly>
  6. <members>
  7. <member name="T:Tao.Platform.Windows.WinNt">
  8. <summary>
  9. WinNT binding for .NET, implementing Windows NT-specific functionality.
  10. </summary>
  11. </member>
  12. <member name="F:Tao.Platform.Windows.WinNt.PROCESSOR_INTEL_386">
  13. <summary>
  14. Intel i386 processor.
  15. </summary>
  16. </member>
  17. <member name="F:Tao.Platform.Windows.WinNt.PROCESSOR_INTEL_486">
  18. <summary>
  19. Intel i486 processor.
  20. </summary>
  21. </member>
  22. <member name="F:Tao.Platform.Windows.WinNt.PROCESSOR_INTEL_PENTIUM">
  23. <summary>
  24. Intel Pentium processor.
  25. </summary>
  26. </member>
  27. <member name="F:Tao.Platform.Windows.WinNt.PROCESSOR_INTEL_IA64">
  28. <summary>
  29. Intel IA64 processor.
  30. </summary>
  31. </member>
  32. <member name="F:Tao.Platform.Windows.WinNt.PROCESSOR_AMD_X8664">
  33. <summary>
  34. AMD X86 64 processor.
  35. </summary>
  36. </member>
  37. <member name="F:Tao.Platform.Windows.WinNt.PROCESSOR_MIPS_R4000">
  38. <summary>
  39. MIPS R4000, R4101, R3910 processor.
  40. </summary>
  41. </member>
  42. <member name="F:Tao.Platform.Windows.WinNt.PROCESSOR_ALPHA_21064">
  43. <summary>
  44. Alpha 210 64 processor.
  45. </summary>
  46. </member>
  47. <member name="F:Tao.Platform.Windows.WinNt.PROCESSOR_PPC_601">
  48. <summary>
  49. PPC 601 processor.
  50. </summary>
  51. </member>
  52. <member name="F:Tao.Platform.Windows.WinNt.PROCESSOR_PPC_603">
  53. <summary>
  54. PPC 603 processor.
  55. </summary>
  56. </member>
  57. <member name="F:Tao.Platform.Windows.WinNt.PROCESSOR_PPC_604">
  58. <summary>
  59. PPC 604 processor.
  60. </summary>
  61. </member>
  62. <member name="F:Tao.Platform.Windows.WinNt.PROCESSOR_PPC_620">
  63. <summary>
  64. PPC 620 processor.
  65. </summary>
  66. </member>
  67. <member name="F:Tao.Platform.Windows.WinNt.PROCESSOR_HITACHI_SH3">
  68. <summary>
  69. Hitachi SH3 processor.
  70. </summary>
  71. </member>
  72. <member name="F:Tao.Platform.Windows.WinNt.PROCESSOR_HITACHI_SH3E">
  73. <summary>
  74. Hitachi SH3E processor.
  75. </summary>
  76. </member>
  77. <member name="F:Tao.Platform.Windows.WinNt.PROCESSOR_HITACHI_SH4">
  78. <summary>
  79. Hitachi SH4 processor.
  80. </summary>
  81. </member>
  82. <member name="F:Tao.Platform.Windows.WinNt.PROCESSOR_MOTOROLA_821">
  83. <summary>
  84. Motorola 821 processor.
  85. </summary>
  86. </member>
  87. <member name="F:Tao.Platform.Windows.WinNt.PROCESSOR_SHx_SH3">
  88. <summary>
  89. SHx SH3 processor.
  90. </summary>
  91. </member>
  92. <member name="F:Tao.Platform.Windows.WinNt.PROCESSOR_SHx_SH4">
  93. <summary>
  94. SHx SH4 processor.
  95. </summary>
  96. </member>
  97. <member name="F:Tao.Platform.Windows.WinNt.PROCESSOR_STRONGARM">
  98. <summary>
  99. StrongARM processor.
  100. </summary>
  101. </member>
  102. <member name="F:Tao.Platform.Windows.WinNt.PROCESSOR_ARM720">
  103. <summary>
  104. ARM 720 processor.
  105. </summary>
  106. </member>
  107. <member name="F:Tao.Platform.Windows.WinNt.PROCESSOR_ARM820">
  108. <summary>
  109. ARM 820 processor.
  110. </summary>
  111. </member>
  112. <member name="F:Tao.Platform.Windows.WinNt.PROCESSOR_ARM920">
  113. <summary>
  114. ARM 920 processor.
  115. </summary>
  116. </member>
  117. <member name="F:Tao.Platform.Windows.WinNt.PROCESSOR_ARM_7TDMI">
  118. <summary>
  119. ARM 7TDMI processor.
  120. </summary>
  121. </member>
  122. <member name="F:Tao.Platform.Windows.WinNt.PROCESSOR_OPTIL">
  123. <summary>
  124. MSIL processor.
  125. </summary>
  126. </member>
  127. <member name="F:Tao.Platform.Windows.WinNt.PROCESSOR_ARCHITECTURE_INTEL">
  128. <summary>
  129. Intel architecture.
  130. </summary>
  131. </member>
  132. <member name="F:Tao.Platform.Windows.WinNt.PROCESSOR_ARCHITECTURE_MIPS">
  133. <summary>
  134. MIPS architecture.
  135. </summary>
  136. </member>
  137. <member name="F:Tao.Platform.Windows.WinNt.PROCESSOR_ARCHITECTURE_ALPHA">
  138. <summary>
  139. Alpha architecture.
  140. </summary>
  141. </member>
  142. <member name="F:Tao.Platform.Windows.WinNt.PROCESSOR_ARCHITECTURE_PPC">
  143. <summary>
  144. PPC architecture.
  145. </summary>
  146. </member>
  147. <member name="F:Tao.Platform.Windows.WinNt.PROCESSOR_ARCHITECTURE_SHX">
  148. <summary>
  149. SHX architecture.
  150. </summary>
  151. </member>
  152. <member name="F:Tao.Platform.Windows.WinNt.PROCESSOR_ARCHITECTURE_ARM">
  153. <summary>
  154. ARM architecture.
  155. </summary>
  156. </member>
  157. <member name="F:Tao.Platform.Windows.WinNt.PROCESSOR_ARCHITECTURE_IA64">
  158. <summary>
  159. IA64 architecture.
  160. </summary>
  161. </member>
  162. <member name="F:Tao.Platform.Windows.WinNt.PROCESSOR_ARCHITECTURE_ALPHA64">
  163. <summary>
  164. Alpha64 architecture.
  165. </summary>
  166. </member>
  167. <member name="F:Tao.Platform.Windows.WinNt.PROCESSOR_ARCHITECTURE_MSIL">
  168. <summary>
  169. MSIL architecture.
  170. </summary>
  171. </member>
  172. <member name="F:Tao.Platform.Windows.WinNt.PROCESSOR_ARCHITECTURE_AMD64">
  173. <summary>
  174. AMD64 architecture.
  175. </summary>
  176. </member>
  177. <member name="F:Tao.Platform.Windows.WinNt.PROCESSOR_ARCHITECTURE_IA32_ON_WIN64">
  178. <summary>
  179. IA32 On Win64 architecture.
  180. </summary>
  181. </member>
  182. <member name="F:Tao.Platform.Windows.WinNt.PROCESSOR_ARCHITECTURE_UNKNOWN">
  183. <summary>
  184. Unknown architecture.
  185. </summary>
  186. </member>
  187. <member name="F:Tao.Platform.Windows.WinNt.PF_FLOATING_POINT_PRECISION_ERRATA">
  188. <summary>
  189. In rare circumstances, on a Pentium, a floating-point precision error can occur.
  190. </summary>
  191. </member>
  192. <member name="F:Tao.Platform.Windows.WinNt.PF_FLOATING_POINT_EMULATED">
  193. <summary>
  194. Floating-point operations are emulated using a software emulator.
  195. </summary>
  196. </member>
  197. <member name="F:Tao.Platform.Windows.WinNt.PF_COMPARE_EXCHANGE_DOUBLE">
  198. <summary>
  199. The compare and exchange double operation is available (Pentium, MIPS, and Alpha).
  200. </summary>
  201. </member>
  202. <member name="F:Tao.Platform.Windows.WinNt.PF_MMX_INSTRUCTIONS_AVAILABLE">
  203. <summary>
  204. The MMX instruction set is available.
  205. </summary>
  206. </member>
  207. <member name="F:Tao.Platform.Windows.WinNt.PF_PPC_MOVEMEM_64BIT_OK">
  208. <summary>
  209. Unknown.
  210. </summary>
  211. </member>
  212. <member name="F:Tao.Platform.Windows.WinNt.PF_ALPHA_BYTE_INSTRUCTIONS">
  213. <summary>
  214. Unknown.
  215. </summary>
  216. </member>
  217. <member name="F:Tao.Platform.Windows.WinNt.PF_XMMI_INSTRUCTIONS_AVAILABLE">
  218. <summary>
  219. The SSE instruction set is available.
  220. </summary>
  221. </member>
  222. <member name="F:Tao.Platform.Windows.WinNt.PF_3DNOW_INSTRUCTIONS_AVAILABLE">
  223. <summary>
  224. The 3D-Now instruction set is available.
  225. </summary>
  226. </member>
  227. <member name="F:Tao.Platform.Windows.WinNt.PF_RDTSC_INSTRUCTION_AVAILABLE">
  228. <summary>
  229. The RDTSC instruction is available.
  230. </summary>
  231. </member>
  232. <member name="F:Tao.Platform.Windows.WinNt.PF_PAE_ENABLED">
  233. <summary>
  234. The processor is PAE-enabled.
  235. </summary>
  236. </member>
  237. <member name="F:Tao.Platform.Windows.WinNt.PF_XMMI64_INSTRUCTIONS_AVAILABLE">
  238. <summary>
  239. The SSE2 instruction set is available.
  240. </summary>
  241. </member>
  242. <member name="T:Tao.Platform.Windows.Kernel">
  243. <summary>
  244. Kernel binding for .NET, implementing Windows-specific kernel functionality.
  245. </summary>
  246. <remarks>
  247. Binds functions and definitions in kernel32.dll.
  248. </remarks>
  249. </member>
  250. <member name="F:Tao.Platform.Windows.Kernel.KERNEL_NATIVE_LIBRARY">
  251. <summary>
  252. Specifies Kernel32's native library archive.
  253. </summary>
  254. <remarks>
  255. Specifies kernel32.dll for Windows.
  256. </remarks>
  257. </member>
  258. <member name="F:Tao.Platform.Windows.Kernel.CALLING_CONVENTION">
  259. <summary>
  260. Specifies the calling convention.
  261. </summary>
  262. <remarks>
  263. Specifies <see cref="F:System.Runtime.InteropServices.CallingConvention.StdCall"/>.
  264. </remarks>
  265. </member>
  266. <member name="M:Tao.Platform.Windows.Kernel.Beep(System.Int32,System.Int32)">
  267. <summary>
  268. The <b>Beep</b> function generates simple tones on the speaker. The function is
  269. synchronous; it does not return control to its caller until the sound finishes.
  270. </summary>
  271. <param name="frequency">
  272. <para>
  273. Frequency of the sound, in hertz. This parameter must be in the range
  274. 37 through 32,767 (0x25 through 0x7FFF).
  275. </para>
  276. <para>
  277. <b>Windows 95/98/Me:</b> The <b>Beep</b> function ignores this parameter.
  278. </para>
  279. </param>
  280. <param name="duration">
  281. <para>
  282. Duration of the sound, in milliseconds.
  283. </para>
  284. <para>
  285. <b>Windows 95/98/Me:</b> The <b>Beep</b> function ignores this parameter.
  286. </para>
  287. </param>
  288. <returns>
  289. <para>
  290. If the function succeeds, the return value is true.
  291. </para>
  292. <para>
  293. If the function fails, the return value is false. To get extended error
  294. information, call <see cref="M:System.Runtime.InteropServices.Marshal.GetLastWin32Error"/>.
  295. </para>
  296. </returns>
  297. <remarks>
  298. <para>
  299. <b>Terminal Services:</b> The beep is redirected to the client.
  300. </para>
  301. <para>
  302. <b>Windows 95/98/Me:</b> On computers with a sound card, the function
  303. plays the default sound event. On computers without a sound card, the
  304. function plays the standard system beep.
  305. </para>
  306. </remarks>
  307. </member>
  308. <member name="M:Tao.Platform.Windows.Kernel.FreeLibrary(System.IntPtr)">
  309. <summary>
  310. The <b>FreeLibrary</b> function decrements the reference count of the loaded
  311. dynamic-link library (DLL). When the reference count reaches zero, the module
  312. is unmapped from the address space of the calling process and the handle is no
  313. longer valid.
  314. </summary>
  315. <param name="moduleHandle">
  316. Handle to the loaded DLL module. The <see cref="M:Tao.Platform.Windows.Kernel.LoadLibrary(System.String)"/> or
  317. <see cref="M:Tao.Platform.Windows.Kernel.GetModuleHandle(System.String)"/> function returns this handle.
  318. </param>
  319. <returns>
  320. <para>
  321. If the function succeeds, the return value is true.
  322. </para>
  323. <para>
  324. If the function fails, the return value is false. To get extended error
  325. information, call <see cref="M:System.Runtime.InteropServices.Marshal.GetLastWin32Error"/>.
  326. </para>
  327. </returns>
  328. <remarks>
  329. <para>
  330. Each process maintains a reference count for each loaded library module. This
  331. reference count is incremented each time <see cref="M:Tao.Platform.Windows.Kernel.LoadLibrary(System.String)"/> is called
  332. and is decremented each time <b>FreeLibrary</b> is called. A DLL module
  333. loaded at process initialization due to load-time dynamic linking has a
  334. reference count of one. This count is incremented if the same module is
  335. loaded by a call to <see cref="M:Tao.Platform.Windows.Kernel.LoadLibrary(System.String)"/>.
  336. </para>
  337. <para>
  338. Before unmapping a library module, the system enables the DLL to detach from
  339. the process by calling the DLL's <b>DllMain</b> function, if it has one, with
  340. the DLL_PROCESS_DETACH value. Doing so gives the DLL an opportunity to clean
  341. up resources allocated on behalf of the current process. After the
  342. entry-point function returns, the library module is removed from the address
  343. space of the current process.
  344. </para>
  345. <para>
  346. It is not safe to call <b>FreeLibrary</b> from <b>DllMain</b>. For more
  347. information, see the Remarks section in <b>DllMain</b>.
  348. </para>
  349. <para>
  350. Calling <b>FreeLibrary</b> does not affect other processes using the same
  351. library module.
  352. </para>
  353. </remarks>
  354. <seealso cref="M:Tao.Platform.Windows.Kernel.GetModuleHandle(System.String)"/>
  355. <seealso cref="M:Tao.Platform.Windows.Kernel.LoadLibrary(System.String)"/>
  356. </member>
  357. <member name="M:Tao.Platform.Windows.Kernel.GetDllDirectory(System.Int32,System.Text.StringBuilder)">
  358. <summary>
  359. The <b>GetDllDirectory</b> function retrieves the application-specific portion of
  360. the search path used to locate DLLs for the application.
  361. </summary>
  362. <param name="bufferLength">
  363. Size of the output buffer, in characters.
  364. </param>
  365. <param name="buffer">
  366. Pointer to a buffer that receives the application-specific portion of the search path.
  367. </param>
  368. <returns>
  369. <para>
  370. If the function succeeds, the return value is the length of the string copied
  371. to <i>buffer</i>, in characters, not including the terminating null character.
  372. If the return value is greater than <i>bufferLength</i>, it specifies the size
  373. of the buffer required for the path.
  374. </para>
  375. <para>
  376. If the function fails, the return value is zero. To get extended error
  377. information, call <see cref="M:System.Runtime.InteropServices.Marshal.GetLastWin32Error"/>.
  378. </para>
  379. </returns>
  380. <seealso cref="M:Tao.Platform.Windows.Kernel.SetDllDirectory(System.String)"/>
  381. </member>
  382. <member name="M:Tao.Platform.Windows.Kernel.GetModuleFileName(System.IntPtr,System.Text.StringBuilder,System.Int32)">
  383. <summary>
  384. <para>
  385. The <b>GetModuleFileName</b> function retrieves the fully qualified path for
  386. the specified module.
  387. </para>
  388. <para>
  389. To specify the process that contains the module, use the
  390. <b>GetModuleFileNameEx</b> function.
  391. </para>
  392. </summary>
  393. <param name="module">
  394. Handle to the module whose path is being requested. If this parameter is NULL,
  395. <b>GetModuleFileName</b> retrieves the path for the current module.
  396. </param>
  397. <param name="fileName">
  398. <para>
  399. Pointer to a buffer that receives a null-terminated string that specifies the
  400. fully-qualified path of the module. If the length of the path exceeds the
  401. size specified by the <i>size</i> parameter, the function succeeds and the
  402. string is truncated to <i>size</i> characters and null terminated.
  403. </para>
  404. <para>
  405. The path can have the prefix "\\?\", depending on how the module was loaded.
  406. </para>
  407. </param>
  408. <param name="size">
  409. Size of the <i>filename</i> buffer, in TCHARs.
  410. </param>
  411. <returns>
  412. <para>
  413. If the function succeeds, the return value is the length of the string copied
  414. to the buffer, in TCHARs. If the buffer is too small to hold the module name,
  415. the string is truncated to <i>size</i>, and the function returns <i>size</i>.
  416. </para>
  417. <para>
  418. If the function fails, the return value is zero. To get extended error
  419. information, call <see cref="M:System.Runtime.InteropServices.Marshal.GetLastWin32Error"/>.
  420. </para>
  421. </returns>
  422. <remarks>
  423. <para>
  424. If a DLL is loaded in two processes, its file name in one process may differ
  425. in case from its file name in the other process.
  426. </para>
  427. <para>
  428. For the ANSI version of the function, the number of TCHARs is the number of
  429. bytes; for the Unicode version, it is the number of characters.
  430. </para>
  431. <para>
  432. <b>Windows Me/98/95:</b> This function retrieves long file names when an
  433. application's version number is greater than or equal to 4.00 and the long
  434. file name is available. Otherwise, it returns only 8.3 format file names.
  435. </para>
  436. </remarks>
  437. <seealso cref="M:Tao.Platform.Windows.Kernel.GetModuleHandle(System.String)"/>
  438. <seealso cref="M:Tao.Platform.Windows.Kernel.LoadLibrary(System.String)"/>
  439. </member>
  440. <member name="M:Tao.Platform.Windows.Kernel.GetModuleHandle(System.String)">
  441. <summary>
  442. <para>
  443. The <b>GetModuleHandle</b> function retrieves a module handle for the
  444. specified module if the file has been mapped into the address space of the
  445. calling process.
  446. </para>
  447. <para>
  448. To avoid the race conditions described in the Remarks section, use the
  449. <b>GetModuleHandleEx</b> function.
  450. </para>
  451. </summary>
  452. <param name="moduleName">
  453. <para>
  454. Pointer to a null-terminated string that contains the name of the module
  455. (either a .dll or .exe file). If the file name extension is omitted, the
  456. default library extension .dll is appended. The file name string can include
  457. a trailing point character (.) to indicate that the module name has no
  458. extension. The string does not have to specify a path. When specifying a
  459. path, be sure to use backslashes (\), not forward slashes (/). The name is
  460. compared (case independently) to the names of modules currently mapped into
  461. the address space of the calling process.
  462. </para>
  463. <para>
  464. If this parameter is NULL, <b>GetModuleHandle</b> returns a handle to the
  465. file used to create the calling process.
  466. </para>
  467. </param>
  468. <returns>
  469. <para>
  470. If the function succeeds, the return value is a handle to the specified module
  471. (IntPtr).
  472. </para>
  473. <para>
  474. If the function fails, the return value is NULL (IntPtr.Zero). To get
  475. extended error information, call <see cref="M:System.Runtime.InteropServices.Marshal.GetLastWin32Error"/>.
  476. </para>
  477. </returns>
  478. <remarks>
  479. <para>
  480. The returned handle is not global or inheritable. It cannot be duplicated
  481. or used by another process.
  482. </para>
  483. <para>
  484. The <b>GetModuleHandle</b> function returns a handle to a mapped module
  485. without incrementing its reference count. Therefore, use care when passing
  486. the handle to the <see cref="M:Tao.Platform.Windows.Kernel.FreeLibrary(System.IntPtr)"/> function, because doing so can
  487. cause a DLL module to be unmapped prematurely.
  488. </para>
  489. <para>
  490. This function must be used carefully in a multithreaded application. There
  491. is no guarantee that the module handle remains valid between the time this
  492. function returns the handle and the time it is used. For example, a thread
  493. retrieves a module handle, but before it uses the handle, a second thread
  494. frees the module. If the system loads another module, it could reuse the
  495. module handle that was recently freed. Therefore, first thread would have
  496. a handle to a module different than the one intended.
  497. </para>
  498. </remarks>
  499. <seealso cref="M:Tao.Platform.Windows.Kernel.FreeLibrary(System.IntPtr)"/>
  500. <seealso cref="M:Tao.Platform.Windows.Kernel.GetModuleFileName(System.IntPtr,System.Text.StringBuilder,System.Int32)"/>
  501. </member>
  502. <member name="M:Tao.Platform.Windows.Kernel.GetProcAddress(System.IntPtr,System.String)">
  503. <summary>
  504. The <b>GetProcAddress</b> function retrieves the address of an exported function
  505. or variable from the specified dynamic-link library (DLL).
  506. </summary>
  507. <param name="module">
  508. Handle to the DLL module that contains the function or variable. The
  509. <see cref="M:Tao.Platform.Windows.Kernel.LoadLibrary(System.String)"/> or <see cref="M:Tao.Platform.Windows.Kernel.GetModuleHandle(System.String)"/> function returns
  510. this handle.
  511. </param>
  512. <param name="processName">
  513. Pointer to a null-terminated string that specifies the function or variable name,
  514. or the function's ordinal value. If this parameter is an ordinal value, it must
  515. be in the low-order word; the high-order word must be zero.
  516. </param>
  517. <returns>
  518. <para>
  519. If the function succeeds, the return value is the address of the exported
  520. function or variable.
  521. </para>
  522. <para>
  523. If the function fails, the return value is NULL (IntPtr.Zero). To get
  524. extended error information, call <see cref="M:System.Runtime.InteropServices.Marshal.GetLastWin32Error"/>.
  525. </para>
  526. </returns>
  527. <remarks>
  528. <para>
  529. The spelling and case of a function name pointed to by <i>processName</i> must
  530. be identical to that in the EXPORTS statement of the source DLL's
  531. module-definition (.def) file. The exported names of functions may differ
  532. from the names you use when calling these functions in your code. This
  533. difference is hidden by macros used in the SDK header files.
  534. </para>
  535. <para>
  536. The <i>processName</i> parameter can identify the DLL function by specifying
  537. an ordinal value associated with the function in the EXPORTS statement.
  538. <b>GetProcAddress</b> verifies that the specified ordinal is in the range 1
  539. through the highest ordinal value exported in the .def file. The function
  540. then uses the ordinal as an index to read the function's address from a
  541. function table. If the .def file does not number the functions consecutively
  542. from 1 to N (where N is the number of exported functions), an error can occur
  543. where <b>GetProcAddress</b> returns an invalid, non-NULL address, even though
  544. there is no function with the specified ordinal.
  545. </para>
  546. <para>
  547. In cases where the function may not exist, the function should be specified by
  548. name rather than by ordinal value.
  549. </para>
  550. </remarks>
  551. <seealso cref="M:Tao.Platform.Windows.Kernel.FreeLibrary(System.IntPtr)"/>
  552. <seealso cref="M:Tao.Platform.Windows.Kernel.GetModuleHandle(System.String)"/>
  553. <seealso cref="M:Tao.Platform.Windows.Kernel.LoadLibrary(System.String)"/>
  554. </member>
  555. <member name="M:Tao.Platform.Windows.Kernel.GetProcessWorkingSetSize(System.IntPtr,System.Int32@,System.Int32@)">
  556. <summary>
  557. The <b>GetProcessWorkingSetSize</b> function retrieves the minimum and maximum
  558. working set sizes of the specified process.
  559. </summary>
  560. <param name="process">
  561. Handle to the process whose working set sizes will be obtained. The handle must
  562. have the PROCESS_QUERY_INFORMATION access right.
  563. </param>
  564. <param name="minimumWorkingSetSize">
  565. Pointer to a variable that receives the minimum working set size of the specified
  566. process, in bytes. The virtual memory manager attempts to keep at least this much
  567. memory resident in the process whenever the process is active.
  568. </param>
  569. <param name="maximumWorkingSetSize">
  570. Pointer to a variable that receives the maximum working set size of the specified
  571. process, in bytes. The virtual memory manager attempts to keep no more than this
  572. much memory resident in the process whenever the process is active when memory is
  573. in short supply.
  574. </param>
  575. <returns>
  576. <para>
  577. If the function succeeds, the return value is true.
  578. </para>
  579. <para>
  580. If the function fails, the return value is false. To get extended error
  581. information, call <see cref="M:System.Runtime.InteropServices.Marshal.GetLastWin32Error"/>.
  582. </para>
  583. </returns>
  584. <remarks>
  585. The "working set" of a process is the set of memory pages currently visible to
  586. the process in physical RAM memory. These pages are resident and available for
  587. an application to use without triggering a page fault. The minimum and maximum
  588. working set sizes affect the virtual memory paging behavior of a process.
  589. </remarks>
  590. <seealso cref="M:Tao.Platform.Windows.Kernel.SetProcessWorkingSetSize(System.IntPtr,System.Int32,System.Int32)"/>
  591. </member>
  592. <member name="M:Tao.Platform.Windows.Kernel.GetSystemDirectory(System.Text.StringBuilder,System.Int32)">
  593. <summary>
  594. <para>
  595. The <b>GetSystemDirectory</b> function retrieves the path of the system
  596. directory. The system directory contains system such files such as
  597. dynamic-link libraries, drivers, and font files.
  598. </para>
  599. <para>
  600. This function is provided primarily for compatibility. Applications should
  601. store code in the Program Files folder and persistent data in the Application
  602. Data folder in the user's profile.
  603. </para>
  604. </summary>
  605. <param name="buffer">
  606. Pointer to the buffer to receive the null-terminated string containing the path.
  607. This path does not end with a backslash unless the system directory is the root
  608. directory. For example, if the system directory is named Windows\System on drive
  609. C, the path of the system directory retrieved by this function is
  610. C:\Windows\System.
  611. </param>
  612. <param name="size">
  613. Maximum size of the buffer, in TCHARs. This value should be set to at least
  614. MAX_PATH+1 to allow sufficient space for the path and the null terminator.
  615. </param>
  616. <returns>
  617. <para>
  618. If the function succeeds, the return value is the length, in TCHARs, of the
  619. string copied to the buffer, not including the terminating null character. If
  620. the length is greater than the size of the buffer, the return value is the
  621. size of the buffer required to hold the path.
  622. </para>
  623. <para>
  624. If the function fails, the return value is zero. To get extended error
  625. information, call <see cref="M:System.Runtime.InteropServices.Marshal.GetLastWin32Error"/>.
  626. </para>
  627. </returns>
  628. <remarks>
  629. Applications should not create files in the system directory. If the user is
  630. running a shared version of the operating system, the application does not have
  631. write access to the system directory.
  632. </remarks>
  633. <seealso cref="M:Tao.Platform.Windows.Kernel.GetWindowsDirectory(System.Text.StringBuilder,System.Int32)"/>
  634. </member>
  635. <member name="M:Tao.Platform.Windows.Kernel.GetSystemInfo(Tao.Platform.Windows.Kernel.SYSTEM_INFO@)">
  636. <summary>
  637. <para>
  638. The <b>GetSystemInfo</b> function returns information about the current
  639. system.
  640. </para>
  641. <para>
  642. To retrieve accurate information for a Win32-based application running on
  643. WOW64, call the <b>GetNativeSystemInfo</b> function.
  644. </para>
  645. </summary>
  646. <param name="systemInfo">
  647. Pointer to a <see cref="T:Tao.Platform.Windows.Kernel.SYSTEM_INFO"/> structure that receives the information.
  648. </param>
  649. <seealso cref="T:Tao.Platform.Windows.Kernel.SYSTEM_INFO"/>
  650. </member>
  651. <member name="M:Tao.Platform.Windows.Kernel.GetSystemWindowsDirectory(System.Text.StringBuilder,System.Int32)">
  652. <summary>
  653. The <b>GetSystemWindowsDirectory</b> function retrieves the path of the shared
  654. Windows directory on a multi-user system.
  655. </summary>
  656. <param name="buffer">
  657. Pointer to the buffer to receive a null-terminated string containing the path.
  658. This path does not end with a backslash unless the Windows directory is the root
  659. directory. For example, if the Windows directory is named Windows on drive C,
  660. the path of the Windows directory retrieved by this function is C:\Windows. If
  661. the system was installed in the root directory of drive C, the path retrieved
  662. is C:\.
  663. </param>
  664. <param name="size">
  665. Maximum size of the buffer specified by the <i>buffer</i> parameter, in TCHARs.
  666. This value should be set to at least MAX_PATH+1 to allow sufficient space for the
  667. path and the null-terminating character.
  668. </param>
  669. <returns>
  670. <para>
  671. If the function succeeds, the return value is the length of the string copied
  672. to the buffer, in TCHARs, not including the terminating null character.
  673. </para>
  674. <para>
  675. If the length is greater than the size of the buffer, the return value is the
  676. size of the buffer required to hold the path.
  677. </para>
  678. <para>
  679. If the function fails, the return value is zero. To get extended error
  680. information, call <see cref="M:System.Runtime.InteropServices.Marshal.GetLastWin32Error"/>.
  681. </para>
  682. </returns>
  683. <remarks>
  684. <para>
  685. On a system that is running Terminal Server, each user has a unique Windows
  686. directory. The system Windows directory is shared by all users, so it is the
  687. directory where an application should store initialization and help files that
  688. apply to all users.
  689. </para>
  690. <para>
  691. With Terminal Services, the <b>GetSystemWindowsDirectory</b> function
  692. retrieves the path of the system Windows directory, while the
  693. <see cref="M:Tao.Platform.Windows.Kernel.GetWindowsDirectory(System.Text.StringBuilder,System.Int32)"/> function retrieves the path of a Windows
  694. directory that is private for each user. On a single-user system,
  695. <b>GetSystemWindowsDirectory</b> is the same as
  696. <see cref="M:Tao.Platform.Windows.Kernel.GetWindowsDirectory(System.Text.StringBuilder,System.Int32)"/>.
  697. </para>
  698. <para>
  699. <b>Windows NT 4.0 Terminal Server Edition:</b> To retrieve the shared
  700. Windows directory, call <see cref="M:Tao.Platform.Windows.Kernel.GetSystemDirectory(System.Text.StringBuilder,System.Int32)"/> and trim the
  701. "System32" element from the end of the returned path.
  702. </para>
  703. </remarks>
  704. <seealso cref="M:Tao.Platform.Windows.Kernel.GetWindowsDirectory(System.Text.StringBuilder,System.Int32)"/>
  705. </member>
  706. <member name="M:Tao.Platform.Windows.Kernel.GetTickCount">
  707. <summary>
  708. The <b>GetTickCount</b> function retrieves the number of milliseconds that have
  709. elapsed since the system was started. It is limited to the resolution of the
  710. system timer. To obtain the system timer resolution, use the
  711. <b>GetSystemTimeAdjustment</b> function.
  712. </summary>
  713. <returns>
  714. The return value is the number of milliseconds that have elapsed since the system
  715. was started.
  716. </returns>
  717. <remarks>
  718. <para>
  719. The elapsed time is stored as a DWORD value. Therefore, the time will wrap
  720. around to zero if the system is run continuously for 49.7 days.
  721. </para>
  722. <para>
  723. If you need a higher resolution timer, use a multimedia timer or a
  724. high-resolution timer.
  725. </para>
  726. <para>
  727. To obtain the time elapsed since the computer was started, retrieve the System
  728. Up Time counter in the performance data in the registry key
  729. HKEY_PERFORMANCE_DATA. The value returned is an 8-byte value.
  730. </para>
  731. </remarks>
  732. </member>
  733. <member name="M:Tao.Platform.Windows.Kernel.GetWindowsDirectory(System.Text.StringBuilder,System.Int32)">
  734. <summary>
  735. <para>
  736. The <b>GetWindowsDirectory</b> function retrieves the path of the Windows
  737. directory. The Windows directory contains such files as applications,
  738. initialization files, and help files.
  739. </para>
  740. <para>
  741. This function is provided primarily for compatibility. Applications should
  742. store code in the Program Files folder and persistent data in the Application
  743. Data folder in the user's profile.
  744. </para>
  745. </summary>
  746. <param name="buffer">
  747. Pointer to the buffer to receive the null-terminated string containing the path.
  748. This path does not end with a backslash unless the Windows directory is the root
  749. directory. For example, if the Windows directory is named Windows on drive C, the
  750. path of the Windows directory retrieved by this function is C:\Windows. If the
  751. system was installed in the root directory of drive C, the path retrieved is C:\.
  752. </param>
  753. <param name="size">
  754. Maximum size of the buffer specified by the <i>buffer</i> parameter, in TCHARs.
  755. This value should be set to MAX_PATH.
  756. </param>
  757. <returns>
  758. <para>
  759. If the function succeeds, the return value is the length of the string copied
  760. to the buffer, in TCHARs, not including the terminating null character.
  761. </para>
  762. <para>
  763. If the length is greater than the size of the buffer, the return value is the
  764. size of the buffer required to hold the path.
  765. </para>
  766. <para>
  767. If the function fails, the return value is zero. To get extended error
  768. information, call <see cref="M:System.Runtime.InteropServices.Marshal.GetLastWin32Error"/>.
  769. </para>
  770. </returns>
  771. <remarks>
  772. <para>
  773. The Windows directory is the directory where an application should store
  774. initialization and help files. If the user is running a shared version of the
  775. system, the Windows directory is guaranteed to be private for each user.
  776. </para>
  777. <para>
  778. If an application creates other files that it wants to store on a per-user
  779. basis, it should place them in the directory specified by the HOMEPATH
  780. environment variable. This directory will be different for each user, if so
  781. specified by an administrator, through the User Manager administrative tool.
  782. HOMEPATH always specifies either the user's home directory, which is
  783. guaranteed to be private for each user, or a default directory (for example,
  784. C:\USERS\DEFAULT) where the user will have all access.
  785. </para>
  786. <para>
  787. <b>Terminal Services:</b> If the application is running in a Terminal
  788. Services environment, each user has a unique Windows directory. If an
  789. application that is not Terminal-Services-aware calls this function, it
  790. retrieves the path of the Windows directory on the client, not the Windows
  791. directory on the server.
  792. </para>
  793. </remarks>
  794. <seealso cref="M:Tao.Platform.Windows.Kernel.GetSystemDirectory(System.Text.StringBuilder,System.Int32)"/>
  795. <seealso cref="M:Tao.Platform.Windows.Kernel.GetSystemWindowsDirectory(System.Text.StringBuilder,System.Int32)"/>
  796. </member>
  797. <member name="M:Tao.Platform.Windows.Kernel.GlobalMemoryStatus(Tao.Platform.Windows.Kernel.MEMORYSTATUS@)">
  798. <summary>
  799. <para>
  800. The <b>GlobalMemoryStatus</b> function obtains information about the system's
  801. current usage of both physical and virtual memory.
  802. </para>
  803. <para>
  804. To obtain information about the extended portion of the virtual address space,
  805. or if your application may run on computers with more than 4 GB of main
  806. memory, use the <b>GlobalMemoryStatusEx</b> function.
  807. </para>
  808. </summary>
  809. <param name="buffer">
  810. Pointer to a <see cref="T:Tao.Platform.Windows.Kernel.MEMORYSTATUS"/> structure. The <b>GlobalMemoryStatus</b>
  811. function stores information about current memory availability into this structure.
  812. </param>
  813. <remarks>
  814. <para>
  815. You can use the <b>GlobalMemoryStatus</b> function to determine how much
  816. memory your application can allocate without severely impacting other
  817. applications.
  818. </para>
  819. <para>
  820. The information returned by the <b>GlobalMemoryStatus</b> function is
  821. volatile. There is no guarantee that two sequential calls to this function
  822. will return the same information.
  823. </para>
  824. <para>
  825. On computers with more than 4 GB of memory, the <b>GlobalMemoryStatus</b>
  826. function can return incorrect information. Windows 2000 and later report a
  827. value of -1 to indicate an overflow. Earlier versions of Windows NT report a
  828. value that is the real amount of memory, modulo 4 GB. For this reason, use
  829. the <b>GlobalMemoryStatusEx</b> function instead.
  830. </para>
  831. <para>
  832. On Intel x86 computers with more than 2 GB and less than 4 GB of memory, the
  833. <b>GlobalMemoryStatus</b> function will always return 2 GB in the
  834. <see cref="F:Tao.Platform.Windows.Kernel.MEMORYSTATUS.TotalPhys"/> member of the
  835. <see cref="T:Tao.Platform.Windows.Kernel.MEMORYSTATUS"/> structure. Similarly, if the total available
  836. memory is between 2 and 4 GB, the <see cref="F:Tao.Platform.Windows.Kernel.MEMORYSTATUS.AvailPhys"/> member
  837. of the <see cref="T:Tao.Platform.Windows.Kernel.MEMORYSTATUS"/> structure will be rounded down to 2 GB. If
  838. the executable is linked using the /LARGEADDRESSWARE linker option, then the
  839. <b>GlobalMemoryStatus</b> function will return the correct amount of physical
  840. memory in both members.
  841. </para>
  842. </remarks>
  843. <seealso cref="T:Tao.Platform.Windows.Kernel.MEMORYSTATUS"/>
  844. </member>
  845. <member name="M:Tao.Platform.Windows.Kernel.IsProcessorFeaturePresent(System.Int32)">
  846. <summary>
  847. The <b>IsProcessorFeaturePresent</b> function determines whether the specified
  848. processor feature is supported by the current computer.
  849. </summary>
  850. <param name="processorFeature">
  851. <para>
  852. Processor feature to be tested. This parameter can be one of the following
  853. values:
  854. </para>
  855. <para>
  856. <list type="table">
  857. <listheader>
  858. <term>Value</term>
  859. <description>Description</description>
  860. </listheader>
  861. <item>
  862. <term><see cref="F:Tao.Platform.Windows.WinNt.PF_3DNOW_INSTRUCTIONS_AVAILABLE"/></term>
  863. <description>
  864. The 3D-Now instruction set is available.
  865. </description>
  866. </item>
  867. <item>
  868. <term><see cref="F:Tao.Platform.Windows.WinNt.PF_COMPARE_EXCHANGE_DOUBLE"/></term>
  869. <description>
  870. The compare and exchange double operation is available (Pentium,
  871. MIPS, and Alpha).
  872. </description>
  873. </item>
  874. <item>
  875. <term><see cref="F:Tao.Platform.Windows.WinNt.PF_FLOATING_POINT_EMULATED"/></term>
  876. <description>
  877. <para>
  878. Floating-point operations are emulated using a software
  879. emulator.
  880. </para>
  881. <para>
  882. This function returns true if floating-point operations are
  883. emulated; otherwise, it returns false.
  884. </para>
  885. <para>
  886. <b>Windows NT 4.0:</b> This function returns false if
  887. floating-point operations are emulated; otherwise, it returns
  888. true. This behavior is a bug that is fixed in later versions.
  889. </para>
  890. </description>
  891. </item>
  892. <item>
  893. <term><see cref="F:Tao.Platform.Windows.WinNt.PF_FLOATING_POINT_PRECISION_ERRATA"/></term>
  894. <description>
  895. <b>Pentium:</b> In rare circumstances, a floating-point precision
  896. error can occur.
  897. </description>
  898. </item>
  899. <item>
  900. <term><see cref="F:Tao.Platform.Windows.WinNt.PF_MMX_INSTRUCTIONS_AVAILABLE"/></term>
  901. <description>
  902. The MMX instruction set is available.
  903. </description>
  904. </item>
  905. <item>
  906. <term><see cref="F:Tao.Platform.Windows.WinNt.PF_PAE_ENABLED"/></term>
  907. <description>
  908. The processor is PAE-enabled.
  909. </description>
  910. </item>
  911. <item>
  912. <term><see cref="F:Tao.Platform.Windows.WinNt.PF_RDTSC_INSTRUCTION_AVAILABLE"/></term>
  913. <description>
  914. The RDTSC instruction is available.
  915. </description>
  916. </item>
  917. <item>
  918. <term><see cref="F:Tao.Platform.Windows.WinNt.PF_XMMI_INSTRUCTIONS_AVAILABLE"/></term>
  919. <description>
  920. The SSE instruction set is available.
  921. </description>
  922. </item>
  923. <item>
  924. <term><see cref="F:Tao.Platform.Windows.WinNt.PF_XMMI64_INSTRUCTIONS_AVAILABLE"/></term>
  925. <description>
  926. The SSE2 instruction set is available.
  927. </description>
  928. </item>
  929. </list>
  930. </para>
  931. </param>
  932. <returns>
  933. <para>
  934. If the feature is supported, the return value is true.
  935. </para>
  936. <para>
  937. If the feature is not supported, the return value is false.
  938. </para>
  939. </returns>
  940. </member>
  941. <member name="M:Tao.Platform.Windows.Kernel.LoadLibrary(System.String)">
  942. <summary>
  943. The <b>LoadLibrary</b> function maps the specified executable module into the
  944. address space of the calling process.
  945. </summary>
  946. <param name="fileName">
  947. <para>
  948. Pointer to a null-terminated string that names the executable module (either
  949. a .dll or .exe file). The name specified is the file name of the module and
  950. is not related to the name stored in the library module itself, as specified
  951. by the LIBRARY keyword in the module-definition (.def) file.
  952. </para>
  953. <para>
  954. If the string specifies a path but the file does not exist in the specified
  955. directory, the function fails. When specifying a path, be sure to use
  956. backslashes (\), not forward slashes (/).
  957. </para>
  958. <para>
  959. If the string does not specify a path, the function uses a standard search
  960. strategy to find the file. See the Remarks for more information.
  961. </para>
  962. </param>
  963. <returns>
  964. <para>
  965. If the function succeeds, the return value is a handle to the module (IntPtr).
  966. </para>
  967. <para>
  968. If the function fails, the return value is NULL (IntPtr.Zero). To get
  969. extended error information, call <see cref="M:System.Runtime.InteropServices.Marshal.GetLastWin32Error"/>.
  970. </para>
  971. <para>
  972. <b>Windows Me/98/95:</b> If you are using <b>LoadLibrary</b> to load a module
  973. that contains a resource whose numeric identifier is greater than 0x7FFF,
  974. <b>LoadLibrary</b> fails. If you are attempting to load a 16-bit DLL directly
  975. from 32-bit code, <b>LoadLibrary</b> fails. If you are attempting to load a
  976. DLL whose subsystem version is greater than 4.0, <b>LoadLibrary</b> fails. If
  977. your <b>DllMain</b> function tries to call the Unicode version of a function,
  978. <b>LoadLibrary</b> fails.
  979. </para>
  980. </returns>
  981. <remarks>
  982. <para>
  983. <b>LoadLibrary</b> can be used to map a DLL module and return a handle that
  984. can be used in <see cref="M:Tao.Platform.Windows.Kernel.GetProcAddress(System.IntPtr,System.String)"/> to get the address of a DLL
  985. function. <b>LoadLibrary</b> can also be used to map other executable
  986. modules. For example, the function can specify an .exe file to get a
  987. handle that can be used in <b>FindResource</b> or <b>LoadResource</b>.
  988. However, do not use <b>LoadLibrary</b> to run an .exe file, use the
  989. <b>CreateProcess</b> function.
  990. </para>
  991. <para>
  992. If the module is a DLL not already mapped for the calling process, the system
  993. calls the DLL's <b>DllMain</b> function with the DLL_PROCESS_ATTACH value. If
  994. the DLL's entry-point function does not return TRUE, <b>LoadLibrary</b> fails
  995. and returns NULL. (The system immediately calls your entry-point function
  996. with DLL_PROCESS_DETACH and unloads the DLL.)
  997. </para>
  998. <para>
  999. It is not safe to call <b>LoadLibrary</b> from <b>DllMain</b>. For more
  1000. information, see the Remarks section in <b>DllMain</b>.
  1001. </para>
  1002. <para>
  1003. Module handles are not global or inheritable. A call to <b>LoadLibrary</b> by
  1004. one process does not produce a handle that another process can use — for
  1005. example, in calling <see cref="M:Tao.Platform.Windows.Kernel.GetProcAddress(System.IntPtr,System.String)"/>. The other process must
  1006. make its own call to <b>LoadLibrary</b> for the module before calling
  1007. <see cref="M:Tao.Platform.Windows.Kernel.GetProcAddress(System.IntPtr,System.String)"/>.
  1008. </para>
  1009. <para>
  1010. If no file name extension is specified in the <i>fileName</i> parameter, the
  1011. default library extension .dll is appended. However, the file name string
  1012. can include a trailing point character (.) to indicate that the module name
  1013. has no extension. When no path is specified, the function searches for loaded
  1014. modules whose base name matches the base name of the module to be loaded. If
  1015. the name matches, the load succeeds. Otherwise, the function searches for the
  1016. file in the following sequence:
  1017. </para>
  1018. <para>
  1019. <list type="number">
  1020. <item>
  1021. <description>
  1022. The directory from which the application loaded.
  1023. </description>
  1024. </item>
  1025. <item>
  1026. <description>
  1027. The current directory.
  1028. </description>
  1029. </item>
  1030. <item>
  1031. <description>
  1032. The system directory. Use the <see cref="M:Tao.Platform.Windows.Kernel.GetSystemDirectory(System.Text.StringBuilder,System.Int32)"/>
  1033. function to get the path of this directory.
  1034. </description>
  1035. </item>
  1036. <item>
  1037. <description>
  1038. <para>
  1039. The 16-bit system directory. There is no function that
  1040. obtains the path of this directory, but it is searched.
  1041. </para>
  1042. <para>
  1043. <b>Windows Me/98/95:</b> This directory does not exist.
  1044. </para>
  1045. </description>
  1046. </item>
  1047. <item>
  1048. <description>
  1049. The Windows directory. Use the <see cref="M:Tao.Platform.Windows.Kernel.GetWindowsDirectory(System.Text.StringBuilder,System.Int32)"/>
  1050. function to get the path of this directory.
  1051. </description>
  1052. </item>
  1053. <item>
  1054. <description>
  1055. The directories that are listed in the PATH environment variable.
  1056. </description>
  1057. </item>
  1058. </list>
  1059. </para>
  1060. <para>
  1061. <b>Windows Server 2003, Windows XP SP1:</b> The default value of
  1062. HKLM\System\CurrentControlSet\Control\Session Manager\SafeDllSearchMode is 1
  1063. (current directory is searched after the system and Windows directories).
  1064. </para>
  1065. <para>
  1066. <b>Windows XP:</b> If
  1067. HKLM\System\CurrentControlSet\Control\Session Manager\SafeDllSearchMode is 1,
  1068. the current directory is searched after the system and Windows directories,
  1069. but before the directories in the PATH environment variable. The default
  1070. value is 0 (current directory is searched before the system and Windows
  1071. directories).
  1072. </para>
  1073. <para>
  1074. The first directory searched is the one directory containing the image file
  1075. used to create the calling process (for more information, see the
  1076. <b>CreateProcess</b> function). Doing this allows private dynamic-link
  1077. library (DLL) files associated with a process to be found without adding the
  1078. process's installed directory to the PATH environment variable.
  1079. </para>
  1080. <para>
  1081. The search path can be altered using the <see cref="M:Tao.Platform.Windows.Kernel.SetDllDirectory(System.String)"/>
  1082. function. This solution is recommended instead of using
  1083. <b>SetCurrentDirectory</b> or hard-coding the full path to the DLL.
  1084. </para>
  1085. <para>
  1086. If a path is specified and there is a redirection file for the application,
  1087. the function searches for the module in the application's directory. If the
  1088. module exists in the application's directory, the <b>LoadLibrary</b> function
  1089. ignores the specified path and loads the module from the application's
  1090. directory. If the module does not exist in the application's directory,
  1091. <b>LoadLibrary</b> loads the module from the specified directory.
  1092. </para>
  1093. </remarks>
  1094. <seealso cref="M:Tao.Platform.Windows.Kernel.FreeLibrary(System.IntPtr)"/>
  1095. <seealso cref="M:Tao.Platform.Windows.Kernel.GetProcAddress(System.IntPtr,System.String)"/>
  1096. <seealso cref="M:Tao.Platform.Windows.Kernel.GetSystemDirectory(System.Text.StringBuilder,System.Int32)"/>
  1097. <seealso cref="M:Tao.Platform.Windows.Kernel.GetWindowsDirectory(System.Text.StringBuilder,System.Int32)"/>
  1098. <seealso cref="M:Tao.Platform.Windows.Kernel.SetDllDirectory(System.String)"/>
  1099. </member>
  1100. <member name="M:Tao.Platform.Windows.Kernel.QueryPerformanceCounter(System.Int64@)">
  1101. <summary>
  1102. The <b>QueryPerformanceCounter</b> function retrieves the current value of the
  1103. high-resolution performance counter.
  1104. </summary>
  1105. <param name="performanceCount">
  1106. Pointer to a variable that receives the current performance-counter value, in
  1107. counts.
  1108. </param>
  1109. <returns>
  1110. <para>
  1111. If the function succeeds, the return value is true.
  1112. </para>
  1113. <para>
  1114. If the function fails, the return value is false. To get extended error
  1115. information, call <see cref="M:System.Runtime.InteropServices.Marshal.GetLastWin32Error"/>.
  1116. </para>
  1117. </returns>
  1118. <remarks>
  1119. On a multiprocessor machine, it should not matter which processor is called.
  1120. However, you can get different results on different processors due to bugs in the
  1121. BIOS or the HAL. To specify processor affinity for a thread, use the
  1122. <b>SetThreadAffinityMask</b> function.
  1123. </remarks>
  1124. <seealso cref="M:Tao.Platform.Windows.Kernel.QueryPerformanceCounterFast(System.Int64@)"/>
  1125. <seealso cref="M:Tao.Platform.Windows.Kernel.QueryPerformanceFrequency(System.Int64@)"/>
  1126. </member>
  1127. <member name="M:Tao.Platform.Windows.Kernel.QueryPerformanceCounterFast(System.Int64@)">
  1128. <summary>
  1129. The <b>QueryPerformanceCounterFast</b> function retrieves the current value of the
  1130. high-resolution performance counter.
  1131. </summary>
  1132. <param name="performanceCount">
  1133. Pointer to a variable that receives the current performance-counter value, in
  1134. counts.
  1135. </param>
  1136. <returns>
  1137. <para>
  1138. If the function succeeds, the return value is true.
  1139. </para>
  1140. <para>
  1141. If the function fails, the return value is false.
  1142. </para>
  1143. </returns>
  1144. <remarks>
  1145. <para>
  1146. This version of <see cref="M:Tao.Platform.Windows.Kernel.QueryPerformanceCounter(System.Int64@)"/> is slightly faster. It
  1147. does not set the last Windows error. Use with care.
  1148. </para>
  1149. <para>
  1150. On a multiprocessor machine, it should not matter which processor is called.
  1151. However, you can get different results on different processors due to bugs in
  1152. the BIOS or the HAL. To specify processor affinity for a thread, use the
  1153. <b>SetThreadAffinityMask</b> function.
  1154. </para>
  1155. </remarks>
  1156. <seealso cref="M:Tao.Platform.Windows.Kernel.QueryPerformanceCounter(System.Int64@)"/>
  1157. <seealso cref="M:Tao.Platform.Windows.Kernel.QueryPerformanceFrequency(System.Int64@)"/>
  1158. </member>
  1159. <member name="M:Tao.Platform.Windows.Kernel.QueryPerformanceFrequency(System.Int64@)">
  1160. <summary>
  1161. The <b>QueryPerformanceFrequency</b> function retrieves the frequency of the
  1162. high-resolution performance counter, if one exists. The frequency cannot change
  1163. while the system is running.
  1164. </summary>
  1165. <param name="frequency">
  1166. Pointer to a variable that receives the current performance-counter frequency, in
  1167. counts per second. If the installed hardware does not support a high-resolution
  1168. performance counter, this parameter can be zero.
  1169. </param>
  1170. <returns>
  1171. <para>
  1172. If the installed hardware supports a high-resolution performance counter, the
  1173. return value is true.
  1174. </para>
  1175. <para>
  1176. If the function fails, the return value is false. To get extended error
  1177. information, call <see cref="M:System.Runtime.InteropServices.Marshal.GetLastWin32Error"/>. For example, if
  1178. the installed hardware does not support a high-resolution performance counter,
  1179. the function fails.
  1180. </para>
  1181. </returns>
  1182. <remarks>
  1183. <b>Note</b> The frequency of the high-resolution performance counter is not the
  1184. processor speed.
  1185. </remarks>
  1186. <seealso cref="M:Tao.Platform.Windows.Kernel.QueryPerformanceCounter(System.Int64@)"/>
  1187. </member>
  1188. <member name="M:Tao.Platform.Windows.Kernel.SetDllDirectory(System.String)">
  1189. <summary>
  1190. The <b>SetDllDirectory</b> function modifies the search path used to locate DLLs
  1191. for the application.
  1192. </summary>
  1193. <param name="pathName">
  1194. Pointer to a null-terminated string that specifies the directories to be added to
  1195. the search path, separated by semicolons. If this parameter is NULL, the default
  1196. search path is used.
  1197. </param>
  1198. <returns>
  1199. <para>
  1200. If the function succeeds, the return value is true.
  1201. </para>
  1202. <para>
  1203. If the function fails, the return value is false. To get extended error
  1204. information, call <see cref="M:System.Runtime.InteropServices.Marshal.GetLastWin32Error"/>.
  1205. </para>
  1206. </returns>
  1207. <remarks>
  1208. <para>
  1209. The <b>SetDllDirectory</b> function affects all subsequent calls to the
  1210. <see cref="M:Tao.Platform.Windows.Kernel.LoadLibrary(System.String)"/> and <b>LoadLibraryEx</b> functions. After calling
  1211. <b>SetDllDirectory</b>, the DLL search path is:
  1212. </para>
  1213. <para>
  1214. <list type="number">
  1215. <item>
  1216. <description>
  1217. The directory from which the application loaded.
  1218. </description>
  1219. </item>
  1220. <item>
  1221. <description>
  1222. The directory specified by the <i>pathName</i> parameter.
  1223. </description>
  1224. </item>
  1225. <item>
  1226. <description>
  1227. The system directory. Use the <see cref="M:Tao.Platform.Windows.Kernel.GetSystemDirectory(System.Text.StringBuilder,System.Int32)"/>
  1228. function to get the path of this directory. The name of this
  1229. directory is System32.
  1230. </description>
  1231. </item>
  1232. <item>
  1233. <description>
  1234. The 16-bit system directory. There is no function that obtains
  1235. the path of this directory, but it is searched. The name of this
  1236. directory is System.
  1237. </description>
  1238. </item>
  1239. <item>
  1240. <description>
  1241. The Windows directory. Use the <see cref="M:Tao.Platform.Windows.Kernel.GetWindowsDirectory(System.Text.StringBuilder,System.Int32)"/>
  1242. function to get the path of this directory.
  1243. </description>
  1244. </item>
  1245. <item>
  1246. <description>
  1247. The directories that are listed in the PATH environment variable.
  1248. </description>
  1249. </item>
  1250. </list>
  1251. </para>
  1252. <para>
  1253. To revert to the default search path used by <see cref="M:Tao.Platform.Windows.Kernel.LoadLibrary(System.String)"/> and
  1254. <b>LoadLibraryEx</b>, call <b>SetDllDirectory</b> with NULL.
  1255. </para>
  1256. </remarks>
  1257. <seealso cref="M:Tao.Platform.Windows.Kernel.GetDllDirectory(System.Int32,System.Text.StringBuilder)"/>
  1258. <seealso cref="M:Tao.Platform.Windows.Kernel.GetSystemDirectory(System.Text.StringBuilder,System.Int32)"/>
  1259. <seealso cref="M:Tao.Platform.Windows.Kernel.GetWindowsDirectory(System.Text.StringBuilder,System.Int32)"/>
  1260. <seealso cref="M:Tao.Platform.Windows.Kernel.LoadLibrary(System.String)"/>
  1261. </member>
  1262. <member name="M:Tao.Platform.Windows.Kernel.SetProcessWorkingSetSize(System.IntPtr,System.Int32,System.Int32)">
  1263. <summary>
  1264. The <b>SetProcessWorkingSetSize</b> function sets the minimum and maximum working
  1265. set sizes for the specified process.
  1266. </summary>
  1267. <param name="process">
  1268. <para>
  1269. Handle to the process whose working set sizes is to be set.
  1270. </para>
  1271. <para>
  1272. The handle must have the PROCESS_SET_QUOTA access right.
  1273. </para>
  1274. </param>
  1275. <param name="minimumWorkingSetSize">
  1276. <para>
  1277. Minimum working set size for the process, in bytes. The virtual memory
  1278. manager attempts to keep at least this much memory resident in the
  1279. process whenever the process is active.
  1280. </para>
  1281. <para>
  1282. If both <i>minimumWorkingSetSize</i> and <i>maximumWorkingSetSize</i> have the
  1283. value -1, the function temporarily trims the working set of the specified
  1284. process to zero. This essentially swaps the process out of physical RAM
  1285. memory.
  1286. </para>
  1287. </param>
  1288. <param name="maximumWorkingSetSize">
  1289. <para>
  1290. Maximum working set size for the process, in bytes. The virtual memory
  1291. manager attempts to keep no more than this much memory resident in the
  1292. process whenever the process is active and memory is in short supply.
  1293. </para>
  1294. <para>
  1295. If both <i>minimumWorkingSetSize</i> and <i>maximumWorkingSetSize</i> have the
  1296. value -1, the function temporarily trims the working set of the specified
  1297. process to zero. This essentially swaps the process out of physical RAM
  1298. memory.
  1299. </para>
  1300. </param>
  1301. <returns>
  1302. <para>
  1303. If the function succeeds, the return value is true.
  1304. </para>
  1305. <para>
  1306. If the function fails, the return value is false. To get extended error
  1307. information, call <see cref="M:System.Runtime.InteropServices.Marshal.GetLastWin32Error"/>.
  1308. </para>
  1309. </returns>
  1310. <remarks>
  1311. <para>
  1312. The working set of a process is the set of memory pages currently visible to
  1313. the process in physical RAM memory. These pages are resident and available
  1314. for an application to use without triggering a page fault. The minimum and
  1315. maximum working set sizes affect the virtual memory paging behavior of a
  1316. process.
  1317. </para>
  1318. <para>
  1319. The working set of the specified process can be emptied by specifying the
  1320. value -1 for both the minimum and maximum working set sizes.
  1321. </para>
  1322. <para>
  1323. If the values of either <i>minimumWorkingSetSize</i> or
  1324. <i>maximumWorkingSetSize</i> are greater than the process' current working
  1325. set sizes, the specified process must have the SE_INC_BASE_PRIORITY_NAME
  1326. privilege. Users in the Administrators and Power Users groups generally
  1327. have this privilege.
  1328. </para>
  1329. <para>
  1330. The operating system allocates working set sizes on a first-come,
  1331. first-served basis. For example, if an application successfully sets 40
  1332. megabytes as its minimum working set size on a 64-megabyte system, and a
  1333. second application requests a 40-megabyte working set size, the operating
  1334. system denies the second application's request.
  1335. </para>
  1336. <para>
  1337. Using the <b>SetProcessWorkingSetSize</b> function to set an application's
  1338. minimum and maximum working set sizes does not guarantee that the requested
  1339. memory will be reserved, or that it will remain resident at all times. When
  1340. the application is idle, or a low-memory situation causes a demand for memory,
  1341. the operating system can reduce the application's working set. An application
  1342. can use the <b>VirtualLock</b> function to lock ranges of the application's
  1343. virtual address space in memory; however, that can potentially degrade the
  1344. performance of the system.
  1345. </para>
  1346. <para>
  1347. When you increase the working set size of an application, you are taking away
  1348. physical memory from the rest of the system. This can degrade the performance
  1349. of other applications and the system as a whole. It can also lead to failures
  1350. of operations that require physical memory to be present; for example,
  1351. creating processes, threads, and kernel pool. Thus, you must use the
  1352. <b>SetProcessWorkingSetSize</b> function carefully. You must always consider
  1353. the performance of the whole system when you are designing an application.
  1354. </para>
  1355. </remarks>
  1356. <seealso cref="M:Tao.Platform.Windows.Kernel.GetProcessWorkingSetSize(System.IntPtr,System.Int32@,System.Int32@)"/>
  1357. </member>
  1358. <member name="T:Tao.Platform.Windows.Kernel.MEMORYSTATUS">
  1359. <summary>
  1360. <para>
  1361. The <b>MEMORYSTATUS</b> structure contains information about the current state
  1362. of both physical and virtual memory.
  1363. </para>
  1364. <para>
  1365. The <see cref="M:Tao.Platform.Windows.Kernel.GlobalMemoryStatus(Tao.Platform.Windows.Kernel.MEMORYSTATUS@)"/> function stores information in a
  1366. <b>MEMORYSTATUS</b> structure.
  1367. </para>
  1368. </summary>
  1369. <remarks>
  1370. <para>
  1371. <b>MEMORYSTATUS</b> reflects the state of memory at the time of the call. It
  1372. reflects the size of the paging file at that time. The operating system can
  1373. enlarge the paging file up to the maximum size set by the administrator.
  1374. </para>
  1375. <para>
  1376. On computers with more than 4 GB of memory, the <b>MEMORYSTATUS</b> structure
  1377. can return incorrect information. Windows reports a value of -1 to indicate
  1378. an overflow, while Windows NT reports a value that is the real amount of
  1379. memory, modulo 4 GB. If your application is at risk for this behavior, use
  1380. the <b>GlobalMemoryStatusEx</b> function instead of the
  1381. <see cref="M:Tao.Platform.Windows.Kernel.GlobalMemoryStatus(Tao.Platform.Windows.Kernel.MEMORYSTATUS@)"/> function.
  1382. </para>
  1383. </remarks>
  1384. <seealso cref="M:Tao.Platform.Windows.Kernel.GlobalMemoryStatus(Tao.Platform.Windows.Kernel.MEMORYSTATUS@)"/>
  1385. </member>
  1386. <member name="F:Tao.Platform.Windows.Kernel.MEMORYSTATUS.Length">
  1387. <summary>
  1388. Size of the <b>MEMORYSTATUS</b> data structure, in bytes. You do not need to
  1389. set this member before calling the <see cref="M:Tao.Platform.Windows.Kernel.GlobalMemoryStatus(Tao.Platform.Windows.Kernel.MEMORYSTATUS@)"/> function;
  1390. the function sets it.
  1391. </summary>
  1392. </member>
  1393. <member name="F:Tao.Platform.Windows.Kernel.MEMORYSTATUS.MemoryLoad">
  1394. <summary>
  1395. <para>
  1396. Approximate percentage of total physical memory that is in use.
  1397. </para>
  1398. <para>
  1399. <b>Windows NT:</b> Percentage of approximately the last 1000 pages of
  1400. physical memory that is in use.
  1401. </para>
  1402. </summary>
  1403. </member>
  1404. <member name="F:Tao.Platform.Windows.Kernel.MEMORYSTATUS.TotalPhys">
  1405. <summary>
  1406. Total size of physical memory, in bytes.
  1407. </summary>
  1408. </member>
  1409. <member name="F:Tao.Platform.Windows.Kernel.MEMORYSTATUS.AvailPhys">
  1410. <summary>
  1411. Size of physical memory available, in bytes.
  1412. </summary>
  1413. </member>
  1414. <member name="F:Tao.Platform.Windows.Kernel.MEMORYSTATUS.TotalPageFile">
  1415. <summary>
  1416. Size of the committed memory limit, in bytes.
  1417. </summary>
  1418. </member>
  1419. <member name="F:Tao.Platform.Windows.Kernel.MEMORYSTATUS.AvailPageFile">
  1420. <summary>
  1421. Size of available memory to commit, in bytes.
  1422. </summary>
  1423. </member>
  1424. <member name="F:Tao.Platform.Windows.Kernel.MEMORYSTATUS.TotalVirtual">
  1425. <summary>
  1426. Total size of the user mode portion of the virtual address space of the
  1427. calling process, in bytes.
  1428. </summary>
  1429. </member>
  1430. <member name="F:Tao.Platform.Windows.Kernel.MEMORYSTATUS.AvailVirtual">
  1431. <summary>
  1432. Size of unreserved and uncommitted memory in the user mode portion of the
  1433. virtual address space of the calling process, in bytes.
  1434. </summary>
  1435. </member>
  1436. <member name="T:Tao.Platform.Windows.Kernel.SYSTEM_INFO">
  1437. <summary>
  1438. The <b>SYSTEM_INFO</b> structure contains information about the current computer
  1439. system. This includes the architecture and type of the processor, the number of
  1440. processors in the system, the page size, and other such information.
  1441. </summary>
  1442. <seealso cref="M:Tao.Platform.Windows.Kernel.GetSystemInfo(Tao.Platform.Windows.Kernel.SYSTEM_INFO@)"/>
  1443. <seealso cref="T:Tao.Platform.Windows.Kernel.SYSTEM_INFO_UNION"/>
  1444. </member>
  1445. <member name="F:Tao.Platform.Windows.Kernel.SYSTEM_INFO.SystemInfoUnion">
  1446. <summary>
  1447. Union for the OemId, ProcessorArchitecture, and Reserved fields of the
  1448. SYSTEM_INFO structure. See <see cref="T:Tao.Platform.Windows.Kernel.SYSTEM_INFO_UNION"/>.
  1449. </summary>
  1450. </member>
  1451. <member name="F:Tao.Platform.Windows.Kernel.SYSTEM_INFO.PageSize">
  1452. <summary>
  1453. Page size and the granularity of page protection and commitment. This is the
  1454. page size used by the <b>VirtualAlloc</b> function.
  1455. </summary>
  1456. </member>
  1457. <member name="F:Tao.Platform.Windows.Kernel.SYSTEM_INFO.MinimumApplicationAddress">
  1458. <summary>
  1459. Pointer to the lowest memory address accessible to applications and
  1460. dynamic-link libraries (DLLs).
  1461. </summary>
  1462. </member>
  1463. <member name="F:Tao.Platform.Windows.Kernel.SYSTEM_INFO.MaximumApplicationAddress">
  1464. <summary>
  1465. Pointer to the highest memory address accessible to applications and DLLs.
  1466. </summary>
  1467. </member>
  1468. <member name="F:Tao.Platform.Windows.Kernel.SYSTEM_INFO.ActiveProcessorMask">
  1469. <summary>
  1470. Mask representing the set of processors configured into the system. Bit 0 is
  1471. processor 0; bit 31 is processor 31.
  1472. </summary>
  1473. </member>
  1474. <member name="F:Tao.Platform.Windows.Kernel.SYSTEM_INFO.NumberOfProcessors">
  1475. <summary>
  1476. Number of processors in the system.
  1477. </summary>
  1478. </member>
  1479. <member name="F:Tao.Platform.Windows.Kernel.SYSTEM_INFO.ProcessorType">
  1480. <summary>
  1481. <para>
  1482. An obsolete member that is retained for compatibility with Windows NT 3.5
  1483. and earlier. Use the <i>SystemInfoUnion.ProcessorArchitecture</i>,
  1484. <i>ProcessorLevel</i>, and <i>ProcessorRevision</i> members to determine
  1485. the type of processor.
  1486. </para>
  1487. <para>
  1488. <b>Windows Me/98/95:</b> Specifies the type of processor in the system.
  1489. This member is one of the following values:
  1490. </para>
  1491. <para>
  1492. <see cref="F:Tao.Platform.Windows.WinNt.PROCESSOR_INTEL_386"/>
  1493. </para>
  1494. <para>
  1495. <see cref="F:Tao.Platform.Windows.WinNt.PROCESSOR_INTEL_486"/>
  1496. </para>
  1497. <para>
  1498. <see cref="F:Tao.Platform.Windows.WinNt.PROCESSOR_INTEL_PENTIUM"/>
  1499. </para>
  1500. </summary>
  1501. </member>
  1502. <member name="F:Tao.Platform.Windows.Kernel.SYSTEM_INFO.AllocationGranularity">
  1503. <summary>
  1504. Granularity with which virtual memory is allocated. For example, a
  1505. <b>VirtualAlloc</b> request to allocate 1 byte will reserve an address space
  1506. of <i>AllocationGranularity</i> bytes. This value was hard coded as 64K in
  1507. the past, but other hardware architectures may require different values.
  1508. </summary>
  1509. </member>
  1510. <member name="F:Tao.Platform.Windows.Kernel.SYSTEM_INFO.ProcessorLevel">
  1511. <summary>
  1512. <para>
  1513. System's architecture-dependent processor level. It should be used only
  1514. for display purposes. To determine the feature set of a processor, use
  1515. the <see cref="M:Tao.Platform.Windows.Kernel.IsProcessorFeaturePresent(System.Int32)"/> function.
  1516. </para>
  1517. <para>
  1518. If <i>SystemInfoUnion.ProcessorArchitecture</i> is
  1519. <see cref="F:Tao.Platform.Windows.WinNt.PROCESSOR_ARCHITECTURE_INTEL"/>, <i>ProcessorLevel</i>
  1520. is defined by the CPU vendor.
  1521. </para>
  1522. <para>
  1523. If <i>SystemInfoUnion.ProcessorArchitecture</i> is
  1524. <see cref="F:Tao.Platform.Windows.WinNt.PROCESSOR_ARCHITECTURE_IA64"/>, <i>ProcessorLevel</i> is
  1525. set to 1.
  1526. </para>
  1527. <para>
  1528. If <i>SystemInfoUnion.ProcessorArchitecture</i> is
  1529. <see cref="F:Tao.Platform.Windows.WinNt.PROCESSOR_ARCHITECTURE_MIPS"/>, <i>ProcessorLevel</i> is
  1530. of the form 00xx, where xx is an 8-bit implementation number (bits 8-15 of
  1531. the PRId register). The member can be the following value:
  1532. </para>
  1533. <para>
  1534. <list type="table">
  1535. <listheader>
  1536. <term>Value</term>
  1537. <description>Description</description>
  1538. </listheader>
  1539. <item>
  1540. <term>0004</term>
  1541. <description>MIPS R4000</description>
  1542. </item>
  1543. </list>
  1544. </para>
  1545. <para>
  1546. If <i>SystemInfoUnion.ProcessorArchitecture</i> is
  1547. <see cref="F:Tao.Platform.Windows.WinNt.PROCESSOR_ARCHITECTURE_ALPHA"/>, <i>ProcessorLevel</i>
  1548. is of the form xxxx, where xxxx is a 16-bit processor version number (the
  1549. low-order 16 bits of a version number from the firmware). The member can
  1550. be one of the following values:
  1551. </para>
  1552. <para>
  1553. <list type="table">
  1554. <listheader>
  1555. <term>Value</term>
  1556. <description>Description</description>
  1557. </listheader>
  1558. <item>
  1559. <term>21064</term>
  1560. <description>Alpha 21064</description>
  1561. </item>
  1562. <item>
  1563. <term>21066</term>
  1564. <description>Alpha 21066</description>
  1565. </item>
  1566. <item>
  1567. <term>21164</term>
  1568. <description>Alpha 21164</description>
  1569. </item>
  1570. </list>
  1571. </para>
  1572. <para>
  1573. If <i>SystemInfoUnion.ProcessorArchitecture</i> is
  1574. <see cref="F:Tao.Platform.Windows.WinNt.PROCESSOR_ARCHITECTURE_PPC"/>, <i>ProcessorLevel</i> is
  1575. of the form xxxx, where xxxx is a 16-bit processor version number (the
  1576. high-order 16 bits of the Processor Version Register). The member can be
  1577. one of the following values:
  1578. </para>
  1579. <para>
  1580. <list type="table">
  1581. <listheader>
  1582. <term>Value</term>
  1583. <description>Description</description>
  1584. </listheader>
  1585. <item>
  1586. <term>1</term>
  1587. <description>PPC 601</description>
  1588. </item>
  1589. <item>
  1590. <term>3</term>
  1591. <description>PPC 603</description>
  1592. </item>
  1593. <item>
  1594. <term>4</term>
  1595. <description>PPC 604</description>
  1596. </item>
  1597. <item>
  1598. <term>6</term>
  1599. <description>PPC 603+</description>
  1600. </item>
  1601. <item>
  1602. <term>9</term>
  1603. <description>PPC 604+</description>
  1604. </item>
  1605. <item>
  1606. <term>20</term>
  1607. <description>PPC 620</description>
  1608. </item>
  1609. </list>
  1610. </para>
  1611. </summary>
  1612. </member>
  1613. <member name="F:Tao.Platform.Windows.Kernel.SYSTEM_INFO.ProcessorRevision">
  1614. <summary>
  1615. <para>
  1616. Architecture-dependent processor revision. The following table shows how
  1617. the revision value is assembled for each type of processor architecture:
  1618. </para>
  1619. <para>
  1620. <list type="table">
  1621. <listheader>
  1622. <term>Processor</term>
  1623. <description>Description</description>
  1624. </listheader>
  1625. <item>
  1626. <term>Intel 80386 or 80486</term>
  1627. <description>
  1628. <para>
  1629. A value of the form xxyz.
  1630. </para>
  1631. <para>
  1632. If xx is equal to 0xFF, y - 0xA is the model number, and
  1633. z is the stepping identifier. For example, an Intel
  1634. 80486-D0 system returns 0xFFD0.
  1635. </para>
  1636. <para>
  1637. If xx is not equal to 0xFF, xx + 'A' is the stepping
  1638. letter and yz is the minor stepping.
  1639. </para>
  1640. </description>
  1641. </item>
  1642. <item>
  1643. <term>Intel Pentium, Cyrix, or NextGen 586</term>
  1644. <description>
  1645. <para>
  1646. A value of the form xxyy, where xx is the model number and
  1647. yy is the stepping. Display this value of 0x0201 as
  1648. follows:
  1649. </para>
  1650. <para>
  1651. Model xx, Stepping yy.
  1652. </para>
  1653. </description>
  1654. </item>
  1655. <item>
  1656. <term>MIPS</term>
  1657. <description>
  1658. A value of the form 00xx, where xx is the 8-bit revision
  1659. number of the processor (the low-order 8 bits of the
  1660. PRId register).
  1661. </description>
  1662. </item>
  1663. <item>
  1664. <term>ALPHA</term>
  1665. <description>
  1666. <para>
  1667. A value of the form xxyy, where xxyy is the low-order 16
  1668. bits of the processor revision number from the firmware.
  1669. Display this value as follows:
  1670. </para>
  1671. <para>
  1672. Model A+xx, Pass yy.
  1673. </para>
  1674. </description>
  1675. </item>
  1676. <item>
  1677. <term>PPC</term>
  1678. <description>
  1679. <para>
  1680. A value of the form xxyy, where xxyy is the low-order 16
  1681. bits of the processor version register. Display this
  1682. value as follows:
  1683. </para>
  1684. <para>
  1685. xx.yy.
  1686. </para>
  1687. </description>
  1688. </item>
  1689. </list>
  1690. </para>
  1691. </summary>
  1692. </member>
  1693. <member name="T:Tao.Platform.Windows.Kernel.SYSTEM_INFO_UNION">
  1694. <summary>
  1695. Union for the OemId, ProcessorArchitecture, and Reserved fields of the
  1696. <see cref="T:Tao.Platform.Windows.Kernel.SYSTEM_INFO"/> structure.
  1697. </summary>
  1698. <seealso cref="T:Tao.Platform.Windows.Kernel.SYSTEM_INFO"/>
  1699. </member>
  1700. <member name="F:Tao.Platform.Windows.Kernel.SYSTEM_INFO_UNION.OemId">
  1701. <summary>
  1702. <para>
  1703. An obsolete member that is retained for compatibility with Windows NT 3.5
  1704. and earlier. New applications should use the <i>ProcessorArchitecture</i>
  1705. branch of the union.
  1706. </para>
  1707. <para>
  1708. <b>Windows Me/98/95:</b> The system always sets this member to zero, the
  1709. value defined for <see cref="F:Tao.Platform.Windows.WinNt.PROCESSOR_ARCHITECTURE_INTEL"/>.
  1710. </para>
  1711. </summary>
  1712. </member>
  1713. <member name="F:Tao.Platform.Windows.Kernel.SYSTEM_INFO_UNION.ProcessorArchitecture">
  1714. <summary>
  1715. <para>
  1716. System's processor architecture. This value can be one of the following
  1717. values:
  1718. </para>
  1719. <para>
  1720. <see cref="F:Tao.Platform.Windows.WinNt.PROCESSOR_ARCHITECTURE_UNKNOWN"/>
  1721. </para>
  1722. <para>
  1723. <see cref="F:Tao.Platform.Windows.WinNt.PROCESSOR_ARCHITECTURE_INTEL"/>
  1724. </para>
  1725. <para>
  1726. <b>Windows NT 3.51:</b> <see cref="F:Tao.Platform.Windows.WinNt.PROCESSOR_ARCHITECTURE_MIPS"/>
  1727. </para>
  1728. <para>
  1729. <b>Windows NT 4.0 and earlier:</b>
  1730. <see cref="F:Tao.Platform.Windows.WinNt.PROCESSOR_ARCHITECTURE_ALPHA"/>
  1731. </para>
  1732. <para>
  1733. <b>Windows NT 4.0 and earlier:</b>
  1734. <see cref="F:Tao.Platform.Windows.WinNt.PROCESSOR_ARCHITECTURE_PPC"/>
  1735. </para>
  1736. <para>
  1737. <b>64-bit Windows:</b> <see cref="F:Tao.Platform.Windows.WinNt.PROCESSOR_ARCHITECTURE_IA64"/>,
  1738. <see cref="F:Tao.Platform.Windows.WinNt.PROCESSOR_ARCHITECTURE_IA32_ON_WIN64"/>,
  1739. <see cref="F:Tao.Platform.Windows.WinNt.PROCESSOR_ARCHITECTURE_AMD64"/>
  1740. </para>
  1741. </summary>
  1742. </member>
  1743. <member name="F:Tao.Platform.Windows.Kernel.SYSTEM_INFO_UNION.Reserved">
  1744. <summary>
  1745. Reserved for future use.
  1746. </summary>
  1747. </member>
  1748. <member name="T:Tao.Platform.Windows.IlasmAttribute">
  1749. <summary>
  1750. Injects supplied MSIL into the method's body.
  1751. </summary>
  1752. <remarks>
  1753. This is a hack as the C# compiler does not allow inline MSIL. This is extracted and
  1754. the appropriate MSIL injected by the PostProcessTao utility.
  1755. </remarks>
  1756. </member>
  1757. <member name="M:Tao.Platform.Windows.IlasmAttribute.#ctor(System.String)">
  1758. <summary>
  1759. Injects the supplied MSIL into the tagged method's body.
  1760. </summary>
  1761. <param name="msil">
  1762. The MSIL to inject.
  1763. </param>
  1764. </member>
  1765. <member name="M:Tao.Platform.Windows.Wgl.GetDelegate(System.String,System.Type)">
  1766. <summary>
  1767. Creates a System.Delegate that can be used to call an OpenGL function, core or extension.
  1768. </summary>
  1769. <param name="name">The name of the OpenGL function (eg. "glNewList")</param>
  1770. <param name="signature">The signature of the OpenGL function.</param>
  1771. <returns>
  1772. A System.Delegate that can be used to call this OpenGL function, or null if the specified
  1773. function name did not correspond to an OpenGL function.
  1774. </returns>
  1775. </member>
  1776. <member name="M:Tao.Platform.Windows.Wgl.ReloadFunctions">
  1777. <summary>
  1778. Loads all OpenGL functions (core and extensions).
  1779. </summary>
  1780. <remarks>
  1781. <para>
  1782. This function will be automatically called the first time you use any opengl function. There is
  1783. </para>
  1784. <para>
  1785. Call this function manually whenever you need to update OpenGL entry points.
  1786. This need may arise if you change the pixelformat/visual, or in case you cannot
  1787. (or do not want) to use the automatic initialization of the GL class.
  1788. </para>
  1789. </remarks>
  1790. </member>
  1791. <member name="M:Tao.Platform.Windows.Wgl.Load(System.String)">
  1792. <summary>
  1793. Tries to reload the given OpenGL function (core or extension).
  1794. </summary>
  1795. <param name="function">The name of the OpenGL function (i.e. glShaderSource)</param>
  1796. <returns>True if the function was found and reloaded, false otherwise.</returns>
  1797. <remarks>
  1798. <para>
  1799. Use this function if you require greater granularity when loading OpenGL entry points.
  1800. </para>
  1801. <para>
  1802. While the automatic initialisation will load all OpenGL entry points, in some cases
  1803. the initialisation can take place before an OpenGL Context has been established.
  1804. In this case, use this function to load the entry points for the OpenGL functions
  1805. you will need, or use ReloadFunctions() to load all available entry points.
  1806. </para>
  1807. <para>
  1808. This function returns true if the given OpenGL function is supported, false otherwise.
  1809. </para>
  1810. <para>
  1811. To query for supported extensions use the IsExtensionSupported() function instead.
  1812. </para>
  1813. </remarks>
  1814. </member>
  1815. <member name="M:Tao.Platform.Windows.Wgl.GetExtensionDelegate(System.String,System.Type)">
  1816. <summary>
  1817. Creates a System.Delegate that can be used to call a dynamically exported OpenGL function.
  1818. </summary>
  1819. <param name="name">The name of the OpenGL function (eg. "glNewList")</param>
  1820. <param name="signature">The signature of the OpenGL function.</param>
  1821. <returns>
  1822. A System.Delegate that can be used to call this OpenGL function or null
  1823. if the function is not available in the current OpenGL context.
  1824. </returns>
  1825. </member>
  1826. <member name="M:Tao.Platform.Windows.Wgl.IsExtensionSupported(System.String)">
  1827. <summary>
  1828. Determines whether the specified OpenGL extension category is available in
  1829. the current OpenGL context. Equivalent to IsExtensionSupported(name, true)
  1830. </summary>
  1831. <param name="name">The string for the OpenGL extension category (eg. "GL_ARB_multitexture")</param>
  1832. <returns>True if the specified extension is available, false otherwise.</returns>
  1833. </member>
  1834. <member name="T:Tao.Platform.Windows.Wgl.Imports">
  1835. <summary>
  1836. Contains DllImports for the core OpenGL functions.
  1837. </summary>
  1838. </member>
  1839. <member name="F:Tao.Platform.Windows.Wgl.Imports.FunctionMap">
  1840. <summary>
  1841. Build a string->MethodInfo map to speed up extension loading.
  1842. </summary>
  1843. </member>
  1844. <member name="T:Tao.Platform.Windows.Winmm">
  1845. <summary>
  1846. Windows Multimedia binding for .NET, implementing Windows-specific multimedia
  1847. functionality.
  1848. </summary>
  1849. <remarks>
  1850. Binds functions and definitions in winmm.dll.
  1851. </remarks>
  1852. </member>
  1853. <member name="F:Tao.Platform.Windows.Winmm.WINMM_NATIVE_LIBRARY">
  1854. <summary>
  1855. Specifies Winmm's native library archive.
  1856. </summary>
  1857. <remarks>
  1858. Specifies winmm.dll for Windows.
  1859. </remarks>
  1860. </member>
  1861. <member name="F:Tao.Platform.Windows.Winmm.CALLING_CONVENTION">
  1862. <summary>
  1863. Specifies the calling convention.
  1864. </summary>
  1865. <remarks>
  1866. Specifies <see cref="F:System.Runtime.InteropServices.CallingConvention.StdCall"/>.
  1867. </remarks>
  1868. </member>
  1869. <member name="F:Tao.Platform.Windows.Winmm.SND_SYNC">
  1870. <summary>
  1871. Synchronous playback of a sound event. <b>PlaySound</b> returns after the sound
  1872. event completes.
  1873. </summary>
  1874. </member>
  1875. <member name="F:Tao.Platform.Windows.Winmm.SND_ASYNC">
  1876. <summary>
  1877. The sound is played asynchronously and <b>PlaySound</b> returns immediately after
  1878. beginning the sound. To terminate an asynchronously played waveform sound, call
  1879. <b>PlaySound</b> with <i>sound</i> set to NULL.
  1880. </summary>
  1881. </member>
  1882. <member name="F:Tao.Platform.Windows.Winmm.SND_NODEFAULT">
  1883. <summary>
  1884. No default sound event is used. If the sound cannot be found, <b>PlaySound</b>
  1885. returns silently without playing the default sound.
  1886. </summary>
  1887. </member>
  1888. <member name="F:Tao.Platform.Windows.Winmm.SND_MEMORY">
  1889. <summary>
  1890. A sound event's file is loaded in RAM. The parameter specified by <i>sound</i>
  1891. must point to an image of a sound in memory.
  1892. </summary>
  1893. </member>
  1894. <member name="F:Tao.Platform.Windows.Winmm.SND_LOOP">
  1895. <summary>
  1896. The sound plays repeatedly until <b>PlaySound</b> is called again with the
  1897. <i>sound</i> parameter set to NULL. You must also specify the
  1898. <see cref="F:Tao.Platform.Windows.Winmm.SND_ASYNC"/> flag to indicate an asynchronous sound event.
  1899. </summary>
  1900. </member>
  1901. <member name="F:Tao.Platform.Windows.Winmm.SND_NOSTOP">
  1902. <summary>
  1903. <para>
  1904. The specified sound event will yield to another sound event that is already
  1905. playing. If a sound cannot be played because the resource needed to
  1906. generate that sound is busy playing another sound, the function immediately
  1907. returns FALSE without playing the requested sound.
  1908. </para>
  1909. <para>
  1910. If this flag is not specified, <b>PlaySound</b> attempts to stop the currently
  1911. playing sound so that the device can be used to play the new sound.
  1912. </para>
  1913. </summary>
  1914. </member>
  1915. <member name="F:Tao.Platform.Windows.Winmm.SND_NOWAIT">
  1916. <summary>
  1917. If the driver is busy, return immediately without playing the sound.
  1918. </summary>
  1919. </member>
  1920. <member name="F:Tao.Platform.Windows.Winmm.SND_ALIAS">
  1921. <summary>
  1922. The <i>sound</i> parameter is a system-event alias in the registry or the WIN.INI
  1923. file. Do not use with either <see cref="F:Tao.Platform.Windows.Winmm.SND_FILENAME"/> or
  1924. <see cref="F:Tao.Platform.Windows.Winmm.SND_RESOURCE"/>.
  1925. </summary>
  1926. </member>
  1927. <member name="F:Tao.Platform.Windows.Winmm.SND_ALIAS_ID">
  1928. <summary>
  1929. The <i>sound</i> parameter is a predefined sound identifier.
  1930. </summary>
  1931. </member>
  1932. <member name="F:Tao.Platform.Windows.Winmm.SND_FILENAME">
  1933. <summary>
  1934. The <i>sound</i> parameter is a filename.
  1935. </summary>
  1936. </member>
  1937. <member name="F:Tao.Platform.Windows.Winmm.SND_RESOURCE">
  1938. <summary>
  1939. The <i>sound</i> parameter is a resource identifier; <i>mod</i> must identify the
  1940. instance that contains the resource.
  1941. </summary>
  1942. </member>
  1943. <member name="F:Tao.Platform.Windows.Winmm.SND_PURGE">
  1944. <summary>
  1945. <para>
  1946. Sounds are to be stopped for the calling task. If <i>sound</i> is not
  1947. NULL, all instances of the specified sound are stopped. If <i>sound</i> is
  1948. NULL, all sounds that are playing on behalf of the calling task are stopped.
  1949. </para>
  1950. <para>
  1951. You must also specify the instance handle to stop <see cref="F:Tao.Platform.Windows.Winmm.SND_RESOURCE"/>
  1952. events.
  1953. </para>
  1954. </summary>
  1955. </member>
  1956. <member name="F:Tao.Platform.Windows.Winmm.SND_APPLICATION">
  1957. <summary>
  1958. The sound is played using an application-specific association.
  1959. </summary>
  1960. </member>
  1961. <member name="F:Tao.Platform.Windows.Winmm.TIMERR_BASE">
  1962. <summary>
  1963. Timer base identifier.
  1964. </summary>
  1965. </member>
  1966. <member name="F:Tao.Platform.Windows.Winmm.TIMERR_NOERROR">
  1967. <summary>
  1968. Successful.
  1969. </summary>
  1970. </member>
  1971. <member name="F:Tao.Platform.Windows.Winmm.TIMERR_NOCANDO">
  1972. <summary>
  1973. Resolution specified is out of range.
  1974. </summary>
  1975. </member>
  1976. <member name="F:Tao.Platform.Windows.Winmm.JOY_BUTTON1">
  1977. <summary>
  1978. First joystick button is pressed.
  1979. </summary>
  1980. </member>
  1981. <member name="F:Tao.Platform.Windows.Winmm.JOY_BUTTON2">
  1982. <summary>
  1983. Second joystick button is pressed.
  1984. </summary>
  1985. </member>
  1986. <member name="F:Tao.Platform.Windows.Winmm.JOY_BUTTON3">
  1987. <summary>
  1988. Third joystick button is pressed.
  1989. </summary>
  1990. </member>
  1991. <member name="F:Tao.Platform.Windows.Winmm.JOY_BUTTON4">
  1992. <summary>
  1993. Four joystick button is pressed.
  1994. </summary>
  1995. </member>
  1996. <member name="F:Tao.Platform.Windows.Winmm.JOYCAPS_HASZ">
  1997. <summary>
  1998. Joystick has z-coordinate information.
  1999. </summary>
  2000. </member>
  2001. <member name="F:Tao.Platform.Windows.Winmm.JOYCAPS_HASR">
  2002. <summary>
  2003. Joystick has rudder (fourth axis) information.
  2004. </summary>
  2005. </member>
  2006. <member name="F:Tao.Platform.Windows.Winmm.JOYCAPS_HASU">
  2007. <summary>
  2008. Joystick has u-coordinate (fifth axis) information.
  2009. </summary>
  2010. </member>
  2011. <member name="F:Tao.Platform.Windows.Winmm.JOYCAPS_HASV">
  2012. <summary>
  2013. Joystick has v-coordinate (sixth axis) information.
  2014. </summary>
  2015. </member>
  2016. <member name="F:Tao.Platform.Windows.Winmm.JOYCAPS_HASPOV">
  2017. <summary>
  2018. Joystick has point-of-view information.
  2019. </summary>
  2020. </member>
  2021. <member name="F:Tao.Platform.Windows.Winmm.JOYCAPS_POV4DIR">
  2022. <summary>
  2023. Joystick point-of-view supports discrete values (centered, forward, backward, left, and right).
  2024. </summary>
  2025. </member>
  2026. <member name="F:Tao.Platform.Windows.Winmm.JOYCAPS_POVCTS">
  2027. <summary>
  2028. Joystick point-of-view supports continuous degree bearings.
  2029. </summary>
  2030. </member>
  2031. <member name="F:Tao.Platform.Windows.Winmm.JOY_RETURNX">
  2032. <summary></summary>
  2033. </member>
  2034. <member name="F:Tao.Platform.Windows.Winmm.JOY_RETURNY">
  2035. <summary></summary>
  2036. </member>
  2037. <member name="F:Tao.Platform.Windows.Winmm.JOY_RETURNZ">
  2038. <summary></summary>
  2039. </member>
  2040. <member name="F:Tao.Platform.Windows.Winmm.JOY_RETURNR">
  2041. <summary></summary>
  2042. </member>
  2043. <member name="F:Tao.Platform.Windows.Winmm.JOY_RETURNU">
  2044. <summary></summary>
  2045. </member>
  2046. <member name="F:Tao.Platform.Windows.Winmm.JOY_RETURNV">
  2047. <summary></summary>
  2048. </member>
  2049. <member name="F:Tao.Platform.Windows.Winmm.JOY_RETURNPOV">
  2050. <summary></summary>
  2051. </member>
  2052. <member name="F:Tao.Platform.Windows.Winmm.JOY_RETURNBUTTONS">
  2053. <summary></summary>
  2054. </member>
  2055. <member name="F:Tao.Platform.Windows.Winmm.JOY_RETURNRAWDATA">
  2056. <summary></summary>
  2057. </member>
  2058. <member name="F:Tao.Platform.Windows.Winmm.JOY_RETURNPOVCTS">
  2059. <summary></summary>
  2060. </member>
  2061. <member name="F:Tao.Platform.Windows.Winmm.JOY_RETURNCENTERED">
  2062. <summary></summary>
  2063. </member>
  2064. <member name="F:Tao.Platform.Windows.Winmm.JOY_USEDEADZONE">
  2065. <summary></summary>
  2066. </member>
  2067. <member name="F:Tao.Platform.Windows.Winmm.JOY_RETURNALL">
  2068. <summary></summary>
  2069. </member>
  2070. <member name="F:Tao.Platform.Windows.Winmm.JOY_CAL_READALWAYS">
  2071. <summary></summary>
  2072. </member>
  2073. <member name="F:Tao.Platform.Windows.Winmm.JOY_CAL_READXYONLY">
  2074. <summary></summary>
  2075. </member>
  2076. <member name="F:Tao.Platform.Windows.Winmm.JOY_CAL_READ3">
  2077. <summary></summary>
  2078. </member>
  2079. <member name="F:Tao.Platform.Windows.Winmm.JOY_CAL_READ4">
  2080. <summary></summary>
  2081. </member>
  2082. <member name="F:Tao.Platform.Windows.Winmm.JOY_CAL_READXONLY">
  2083. <summary></summary>
  2084. </member>
  2085. <member name="F:Tao.Platform.Windows.Winmm.JOY_CAL_READYONLY">
  2086. <summary></summary>
  2087. </member>
  2088. <member name="F:Tao.Platform.Windows.Winmm.JOY_CAL_READ5">
  2089. <summary></summary>
  2090. </member>
  2091. <member name="F:Tao.Platform.Windows.Winmm.JOY_CAL_READ6">
  2092. <summary></summary>
  2093. </member>
  2094. <member name="F:Tao.Platform.Windows.Winmm.JOY_CAL_READZONLY">
  2095. <summary></summary>
  2096. </member>
  2097. <member name="F:Tao.Platform.Windows.Winmm.JOY_CAL_READRONLY">
  2098. <summary></summary>
  2099. </member>
  2100. <member name="F:Tao.Platform.Windows.Winmm.JOY_CAL_READUONLY">
  2101. <summary></summary>
  2102. </member>
  2103. <member name="F:Tao.Platform.Windows.Winmm.JOY_CAL_READVONLY">
  2104. <summary></summary>
  2105. </member>
  2106. <member name="F:Tao.Platform.Windows.Winmm.JOY_POVCENTERED">
  2107. <summary></summary>
  2108. </member>
  2109. <member name="F:Tao.Platform.Windows.Winmm.JOY_POVFORWARD">
  2110. <summary></summary>
  2111. </member>
  2112. <member name="F:Tao.Platform.Windows.Winmm.JOY_POVRIGHT">
  2113. <summary></summary>
  2114. </member>
  2115. <member name="F:Tao.Platform.Windows.Winmm.JOY_POVBACKWARD">
  2116. <summary></summary>
  2117. </member>
  2118. <member name="F:Tao.Platform.Windows.Winmm.JOY_POVLEFT">
  2119. <summary></summary>
  2120. </member>
  2121. <member name="F:Tao.Platform.Windows.Winmm.MMSYSERR_BASE">
  2122. <summary></summary>
  2123. </member>
  2124. <member name="F:Tao.Platform.Windows.Winmm.MMSYSERR_NOERROR">
  2125. <summary></summary>
  2126. </member>
  2127. <member name="F:Tao.Platform.Windows.Winmm.MMSYSERR_ERROR">
  2128. <summary></summary>
  2129. </member>
  2130. <member name="F:Tao.Platform.Windows.Winmm.MMSYSERR_BADDEVICEID">
  2131. <summary></summary>
  2132. </member>
  2133. <member name="F:Tao.Platform.Windows.Winmm.MMSYSERR_NOTENABLED">
  2134. <summary></summary>
  2135. </member>
  2136. <member name="F:Tao.Platform.Windows.Winmm.MMSYSERR_ALLOCATED">
  2137. <summary></summary>
  2138. </member>
  2139. <member name="F:Tao.Platform.Windows.Winmm.MMSYSERR_INVALHANDLE">
  2140. <summary></summary>
  2141. </member>
  2142. <member name="F:Tao.Platform.Windows.Winmm.MMSYSERR_NODRIVER">
  2143. <summary></summary>
  2144. </member>
  2145. <member name="F:Tao.Platform.Windows.Winmm.MMSYSERR_NOMEM">
  2146. <summary></summary>
  2147. </member>
  2148. <member name="F:Tao.Platform.Windows.Winmm.MMSYSERR_NOTSUPPORTED">
  2149. <summary></summary>
  2150. </member>
  2151. <member name="F:Tao.Platform.Windows.Winmm.MMSYSERR_BADERRNUM">
  2152. <summary></summary>
  2153. </member>
  2154. <member name="F:Tao.Platform.Windows.Winmm.MMSYSERR_INVALFLAG">
  2155. <summary></summary>
  2156. </member>
  2157. <member name="F:Tao.Platform.Windows.Winmm.MMSYSERR_INVALPARAM">
  2158. <summary></summary>
  2159. </member>
  2160. <member name="F:Tao.Platform.Windows.Winmm.MMSYSERR_LASTERROR">
  2161. <summary></summary>
  2162. </member>
  2163. <member name="F:Tao.Platform.Windows.Winmm.JOYERR_NOERROR">
  2164. <summary></summary>
  2165. </member>
  2166. <member name="F:Tao.Platform.Windows.Winmm.JOYERR_PARMS">
  2167. <summary></summary>
  2168. </member>
  2169. <member name="F:Tao.Platform.Windows.Winmm.JOYERR_NOCANDO">
  2170. <summary></summary>
  2171. </member>
  2172. <member name="F:Tao.Platform.Windows.Winmm.JOYERR_UNPLUGGED">
  2173. <summary></summary>
  2174. </member>
  2175. <member name="F:Tao.Platform.Windows.Winmm.JOYSTICKID1">
  2176. <summary></summary>
  2177. </member>
  2178. <member name="F:Tao.Platform.Windows.Winmm.JOYSTICKID2">
  2179. <summary></summary>
  2180. </member>
  2181. <member name="F:Tao.Platform.Windows.Winmm.MM_JOY1MOVE">
  2182. <summary></summary>
  2183. </member>
  2184. <member name="F:Tao.Platform.Windows.Winmm.MM_JOY2MOVE">
  2185. <summary></summary>
  2186. </member>
  2187. <member name="F:Tao.Platform.Windows.Winmm.MM_JOY1ZMOVE">
  2188. <summary></summary>
  2189. </member>
  2190. <member name="F:Tao.Platform.Windows.Winmm.MM_JOY2ZMOVE">
  2191. <summary></summary>
  2192. </member>
  2193. <member name="M:Tao.Platform.Windows.Winmm.PlaySound(System.String,System.IntPtr,System.Int32)">
  2194. <summary>
  2195. The <b>PlaySound</b> function plays a sound specified by the given filename,
  2196. resource, or system event. (A system event may be associated with a sound in the
  2197. registry or in the WIN.INI file.)
  2198. </summary>
  2199. <param name="sound">
  2200. <para>
  2201. A string that specifies the sound to play. If this parameter is NULL, any
  2202. currently playing waveform sound is stopped. To stop a non-waveform sound,
  2203. specify <see cref="F:Tao.Platform.Windows.Winmm.SND_PURGE"/> in the <i>soundFlags</i> parameter.
  2204. </para>
  2205. <para>
  2206. Three flags in <i>soundFlags</i> (<see cref="F:Tao.Platform.Windows.Winmm.SND_ALIAS"/>,
  2207. <see cref="F:Tao.Platform.Windows.Winmm.SND_FILENAME"/>, and <see cref="F:Tao.Platform.Windows.Winmm.SND_RESOURCE"/>) determine
  2208. whether the name is interpreted as an alias for a system event, a filename, or
  2209. a resource identifier. If none of these flags are specified, <b>PlaySound</b>
  2210. searches the registry or the WIN.INI file for an association with the
  2211. specified sound name. If an association is found, the sound event is played.
  2212. If no association is found in the registry, the name is interpreted as a
  2213. filename.
  2214. </para>
  2215. </param>
  2216. <param name="mod">
  2217. Handle to the executable file that contains the resource to be loaded. This
  2218. parameter must be NULL unless <see cref="F:Tao.Platform.Windows.Winmm.SND_RESOURCE"/> is specified in
  2219. <i>soundFlags</i>.
  2220. </param>
  2221. <param name="soundFlags">
  2222. <para>
  2223. Flags for playing the sound. The following values are defined:
  2224. </para>
  2225. <para>
  2226. <list type="table">
  2227. <listheader>
  2228. <term>Value</term>
  2229. <description>Description</description>
  2230. </listheader>
  2231. <item>
  2232. <term><see cref="F:Tao.Platform.Windows.Winmm.SND_APPLICATION"/></term>
  2233. <description>
  2234. The sound is played using an application-specific association.
  2235. </description>
  2236. </item>
  2237. <item>
  2238. <term><see cref="F:Tao.Platform.Windows.Winmm.SND_ALIAS"/></term>
  2239. <description>
  2240. The <i>sound</i> parameter is a system-event alias in the registry
  2241. or the WIN.INI file. Do not use with either
  2242. <see cref="F:Tao.Platform.Windows.Winmm.SND_FILENAME"/> or <see cref="F:Tao.Platform.Windows.Winmm.SND_RESOURCE"/>.
  2243. </description>
  2244. </item>
  2245. <item>
  2246. <term><see cref="F:Tao.Platform.Windows.Winmm.SND_ALIAS_ID"/></term>
  2247. <description>
  2248. The <i>sound</i> parameter is a predefined sound identifier.
  2249. </description>
  2250. </item>
  2251. <item>
  2252. <term><see cref="F:Tao.Platform.Windows.Winmm.SND_ASYNC"/></term>
  2253. <description>
  2254. The sound is played asynchronously and <b>PlaySound</b> returns
  2255. immediately after beginning the sound. To terminate an
  2256. asynchronously played waveform sound, call <b>PlaySound</b> with
  2257. <i>sound</i> set to NULL.
  2258. </description>
  2259. </item>
  2260. <item>
  2261. <term><see cref="F:Tao.Platform.Windows.Winmm.SND_FILENAME"/></term>
  2262. <description>
  2263. The <i>sound</i> parameter is a filename.
  2264. </description>
  2265. </item>
  2266. <item>
  2267. <term><see cref="F:Tao.Platform.Windows.Winmm.SND_LOOP"/></term>
  2268. <description>
  2269. The sound plays repeatedly until <b>PlaySound</b> is called again
  2270. with the <i>sound</i> parameter set to NULL. You must also
  2271. specify the <see cref="F:Tao.Platform.Windows.Winmm.SND_ASYNC"/> flag to indicate an
  2272. asynchronous sound event.
  2273. </description>
  2274. </item>
  2275. <item>
  2276. <term><see cref="F:Tao.Platform.Windows.Winmm.SND_MEMORY"/></term>
  2277. <description>
  2278. A sound event's file is loaded in RAM. The parameter specified by
  2279. <i>sound</i> must point to an image of a sound in memory.
  2280. </description>
  2281. </item>
  2282. <item>
  2283. <term><see cref="F:Tao.Platform.Windows.Winmm.SND_NODEFAULT"/></term>
  2284. <description>
  2285. No default sound event is used. If the sound cannot be found,
  2286. <b>PlaySound</b> returns silently without playing the default
  2287. sound.
  2288. </description>
  2289. </item>
  2290. <item>
  2291. <term><see cref="F:Tao.Platform.Windows.Winmm.SND_NOSTOP"/></term>
  2292. <description>
  2293. <para>
  2294. The specified sound event will yield to another sound event
  2295. that is already playing. If a sound cannot be played because
  2296. the resource needed to generate that sound is busy playing
  2297. another sound, the function immediately returns FALSE without
  2298. playing the requested sound.
  2299. </para>
  2300. <para>
  2301. If this flag is not specified, <b>PlaySound</b> attempts to
  2302. stop the currently playing sound so that the device can be
  2303. used to play the new sound.
  2304. </para>
  2305. </description>
  2306. </item>
  2307. <item>
  2308. <term><see cref="F:Tao.Platform.Windows.Winmm.SND_NOWAIT"/></term>
  2309. <description>
  2310. If the driver is busy, return immediately without playing the
  2311. sound.
  2312. </description>
  2313. </item>
  2314. <item>
  2315. <term><see cref="F:Tao.Platform.Windows.Winmm.SND_PURGE"/></term>
  2316. <description>
  2317. <para>
  2318. Sounds are to be stopped for the calling task. If
  2319. <i>sound</i> is not NULL, all instances of the specified sound
  2320. are stopped. If <i>sound</i> is NULL, all sounds that are
  2321. playing on behalf of the calling task are stopped.
  2322. </para>
  2323. <para>
  2324. You must also specify the instance handle to stop
  2325. <see cref="F:Tao.Platform.Windows.Winmm.SND_RESOURCE"/> events.
  2326. </para>
  2327. </description>
  2328. </item>
  2329. <item>
  2330. <term><see cref="F:Tao.Platform.Windows.Winmm.SND_RESOURCE"/></term>
  2331. <description>
  2332. The <i>sound</i> parameter is a resource identifier; <i>mod</i>
  2333. must identify the instance that contains the resource.
  2334. </description>
  2335. </item>
  2336. <item>
  2337. <term><see cref="F:Tao.Platform.Windows.Winmm.SND_SYNC"/></term>
  2338. <description>
  2339. Synchronous playback of a sound event. <b>PlaySound</b> returns
  2340. after the sound event completes.
  2341. </description>
  2342. </item>
  2343. </list>
  2344. </para>
  2345. </param>
  2346. <returns>
  2347. Returns TRUE if successful or FALSE otherwise.
  2348. </returns>
  2349. <remarks>
  2350. <para>
  2351. The sound specified by <i>sound</i> must fit into available physical memory
  2352. and be playable by an installed waveform-audio device driver.
  2353. <b>PlaySound</b> searches the following directories for sound files: the
  2354. current directory; the Windows directory; the Windows system directory;
  2355. directories listed in the PATH environment variable; and the list of
  2356. directories mapped in a network. For more information about the directory
  2357. search order, see the documentation for the <b>OpenFile</b> function.
  2358. </para>
  2359. <para>
  2360. If it cannot find the specified sound, <b>PlaySound</b> uses the default
  2361. system event sound entry instead. If the function can find neither the
  2362. system default entry nor the default sound, it makes no sound and returns
  2363. FALSE.
  2364. </para>
  2365. </remarks>
  2366. </member>
  2367. <member name="M:Tao.Platform.Windows.Winmm.timeBeginPeriod(System.Int32)">
  2368. <summary>
  2369. The <b>timeBeginPeriod</b> function sets the minimum timer resolution for an
  2370. application or device driver.
  2371. </summary>
  2372. <param name="period">
  2373. Minimum timer resolution, in milliseconds, for the application or device driver.
  2374. </param>
  2375. <returns>
  2376. Returns <see cref="F:Tao.Platform.Windows.Winmm.TIMERR_NOERROR"/> if successful or
  2377. <see cref="F:Tao.Platform.Windows.Winmm.TIMERR_NOCANDO"/> if the resolution specified in <i>period</i> is out
  2378. of range.
  2379. </returns>
  2380. <remarks>
  2381. <para>
  2382. Call this function immediately before using timer services, and call the
  2383. <see cref="M:Tao.Platform.Windows.Winmm.timeEndPeriod(System.Int32)"/> function immediately after you are finished
  2384. using the timer services.
  2385. </para>
  2386. <para>
  2387. You must match each call to <b>timeBeginPeriod</b> with a call to
  2388. <see cref="M:Tao.Platform.Windows.Winmm.timeEndPeriod(System.Int32)"/>, specifying the same minimum resolution in both
  2389. calls. An application can make multiple <b>timeBeginPeriod</b> calls as long
  2390. as each call is matched with a call to <see cref="M:Tao.Platform.Windows.Winmm.timeEndPeriod(System.Int32)"/>.
  2391. </para>
  2392. </remarks>
  2393. <seealso cref="M:Tao.Platform.Windows.Winmm.timeEndPeriod(System.Int32)"/>
  2394. </member>
  2395. <member name="M:Tao.Platform.Windows.Winmm.timeEndPeriod(System.Int32)">
  2396. <summary>
  2397. The <b>timeEndPeriod</b> function clears a previously set minimum timer
  2398. resolution.
  2399. </summary>
  2400. <param name="period">
  2401. Minimum timer resolution specified in the previous call to the
  2402. <see cref="M:Tao.Platform.Windows.Winmm.timeBeginPeriod(System.Int32)"/> function.
  2403. </param>
  2404. <returns>
  2405. Returns <see cref="F:Tao.Platform.Windows.Winmm.TIMERR_NOERROR"/> if successful or
  2406. <see cref="F:Tao.Platform.Windows.Winmm.TIMERR_NOCANDO"/> if the resolution specified in <i>period</i> is out
  2407. of range
  2408. </returns>
  2409. <remarks>
  2410. <para>
  2411. Call this function immediately after you are finished using timer services.
  2412. </para>
  2413. <para>
  2414. You must match each call to <see cref="M:Tao.Platform.Windows.Winmm.timeBeginPeriod(System.Int32)"/> with a call to
  2415. <b>timeEndPeriod</b>, specifying the same minimum resolution in both calls.
  2416. An application can make multiple <see cref="M:Tao.Platform.Windows.Winmm.timeBeginPeriod(System.Int32)"/> calls as long
  2417. as each call is matched with a call to <b>timeEndPeriod</b>.
  2418. </para>
  2419. </remarks>
  2420. <seealso cref="M:Tao.Platform.Windows.Winmm.timeBeginPeriod(System.Int32)"/>
  2421. </member>
  2422. <member name="M:Tao.Platform.Windows.Winmm.timeGetTime">
  2423. <summary>
  2424. The <b>timeGetTime</b> function retrieves the system time, in milliseconds.
  2425. The system time is the time elapsed since Windows was started.
  2426. </summary>
  2427. <returns>
  2428. Returns the system time, in milliseconds.
  2429. </returns>
  2430. <remarks>
  2431. <para>
  2432. The only difference between this function and the <b>timeGetSystemTime</b>
  2433. function is that <b>timeGetSystemTime</b> uses the <b>MMTIME</b> structure to
  2434. return the system time. The <b>timeGetTime</b> function has less overhead
  2435. than <b>timeGetSystemTime</b>.
  2436. </para>
  2437. <para>
  2438. Note that the value returned by the <b>timeGetTime</b> function is a DWORD
  2439. value. The return value wraps around to 0 every 2^32 milliseconds, which is
  2440. about 49.71 days. This can cause problems in code that directly uses the
  2441. <b>timeGetTime</b> return value in computations, particularly where the value
  2442. is used to control code execution. You should always use the difference
  2443. between two <b>timeGetTime</b> return values in computations.
  2444. </para>
  2445. <para>
  2446. <b>Windows NT/2000:</b> The default precision of the <b>timeGetTime</b>
  2447. function can be five milliseconds or more, depending on the machine. You
  2448. can use the <see cref="M:Tao.Platform.Windows.Winmm.timeBeginPeriod(System.Int32)"/> and <see cref="M:Tao.Platform.Windows.Winmm.timeEndPeriod(System.Int32)"/>
  2449. functions to increase the precision of <b>timeGetTime</b>. If you do so, the
  2450. minimum difference between successive values returned by <b>timeGetTime</b>
  2451. can be as large as the minimum period value set using
  2452. <see cref="M:Tao.Platform.Windows.Winmm.timeBeginPeriod(System.Int32)"/> and <see cref="M:Tao.Platform.Windows.Winmm.timeEndPeriod(System.Int32)"/>. Use the
  2453. <see cref="M:Tao.Platform.Windows.Kernel.QueryPerformanceCounter(System.Int64@)"/> and
  2454. <see cref="M:Tao.Platform.Windows.Kernel.QueryPerformanceFrequency(System.Int64@)"/> functions to measure short
  2455. time intervals at a high resolution.
  2456. </para>
  2457. <para>
  2458. <b>Windows 95:</b> The default precision of the <b>timeGetTime</b> function is
  2459. 1 millisecond. In other words, the <b>timeGetTime</b> function can return
  2460. successive values that differ by just 1 millisecond. This is true no matter
  2461. what calls have been made to the <b>timeBeginPeriod</b> and
  2462. <b>timeEndPeriod</b> functions.
  2463. </para>
  2464. </remarks>
  2465. <seealso cref="M:Tao.Platform.Windows.Kernel.QueryPerformanceCounter(System.Int64@)"/>
  2466. <seealso cref="M:Tao.Platform.Windows.Kernel.QueryPerformanceFrequency(System.Int64@)"/>
  2467. <seealso cref="M:Tao.Platform.Windows.Winmm.timeBeginPeriod(System.Int32)"/>
  2468. <seealso cref="M:Tao.Platform.Windows.Winmm.timeEndPeriod(System.Int32)"/>
  2469. </member>
  2470. <member name="M:Tao.Platform.Windows.Winmm.joyConfigChanged(System.Int64)">
  2471. <summary>
  2472. The joyConfigChanged function informs the joystick driver that the configuration has changed and should be reloaded from the registry.
  2473. </summary>
  2474. <param name="dwFlags">
  2475. Reserved for future use. Must equal zero.
  2476. </param>
  2477. <returns>
  2478. Returns JOYERR_NOERROR if successful. Returns JOYERR_PARMS if the parameter is non-zero.
  2479. </returns>
  2480. <remarks>
  2481. <para>
  2482. This function causes a window message to be sent to all top-level windows. This message may be defined by applications that need to respond to changes in joystick calibration by using RegisterWindowMessage with the following message ID:
  2483. </para>
  2484. <code>
  2485. #define JOY_CONFIGCHANGED_MSGSTRING "MSJSTICK_VJOYD_MSGSTR"
  2486. </code>
  2487. </remarks>
  2488. </member>
  2489. <member name="M:Tao.Platform.Windows.Winmm.joyGetDevCaps(System.IntPtr,Tao.Platform.Windows.Winmm.JOYCAPS@,System.Int32)">
  2490. <summary>
  2491. The joyGetDevCaps function queries a joystick to determine its capabilities.
  2492. </summary>
  2493. <param name="uJoyID">
  2494. Identifier of the joystick to be queried. Valid values for uJoyID range from -1 to 15. A value of -1 enables retrieval of the szRegKey member of the JOYCAPS structure whether a device is present or not. For Windows NT 4.0, valid values are limited to zero (JOYSTICKID1) and JOYSTICKID2.
  2495. </param>
  2496. <param name="pjc">
  2497. Pointer to a <see cref="T:Tao.Platform.Windows.Winmm.JOYCAPS"/> structure to contain the capabilities of the joystick.
  2498. </param>
  2499. <param name="cbjc">
  2500. Size, in bytes, of the JOYCAPS structure.
  2501. </param>
  2502. <returns>
  2503. <para>
  2504. Returns JOYERR_NOERROR if successful or one of the following error values:
  2505. </para>
  2506. <para>
  2507. <see cref="F:Tao.Platform.Windows.Winmm.MMSYSERR_NODRIVER"/> - The joystick driver is not present. Windows NT/2000/XP: The specified joystick identifier is invalid.
  2508. <see cref="F:Tao.Platform.Windows.Winmm.MMSYSERR_INVALPARAM"/> - An invalid parameter was passed. Windows 95/98/Me: The specified joystick identifier is invalid.
  2509. </para>
  2510. </returns>
  2511. <remarks>
  2512. <para>
  2513. Use the <see cref="M:Tao.Platform.Windows.Winmm.joyGetNumDevs"/> function to determine the number of joystick devices supported by the driver.
  2514. </para>
  2515. <para>
  2516. Windows NT/2000/XP: This method fails when passed an invalid value for the cbjc parameter.
  2517. Windows 95/98/Me: This method succeeds when passed an invalid value for the cbjc parameter.
  2518. </para>
  2519. </remarks>
  2520. <seealso cref="T:Tao.Platform.Windows.Winmm.JOYCAPS"/>
  2521. <seealso cref="M:Tao.Platform.Windows.Winmm.joyGetNumDevs"/>
  2522. </member>
  2523. <member name="M:Tao.Platform.Windows.Winmm.joyGetNumDevs">
  2524. <summary>
  2525. The joyGetNumDevs function queries the joystick driver for the number of joysticks it supports.
  2526. </summary>
  2527. <returns>
  2528. The joyGetNumDevs function returns the number of joysticks supported by the current driver or zero if no driver is installed.
  2529. </returns>
  2530. <remarks>
  2531. <para>
  2532. Use the <see cref="M:Tao.Platform.Windows.Winmm.joyGetPos(System.Int32,Tao.Platform.Windows.Winmm.JOYINFO@)"/> function to determine whether a given joystick is physically attached to the system. If the specified joystick is not connected, joyGetPos returns a <see cref="F:Tao.Platform.Windows.Winmm.JOYERR_UNPLUGGED"/> error value.
  2533. </para>
  2534. </remarks>
  2535. </member>
  2536. <member name="M:Tao.Platform.Windows.Winmm.joyGetPos(System.Int32,Tao.Platform.Windows.Winmm.JOYINFO@)">
  2537. <summary>
  2538. The joyGetPos function queries a joystick for its position and button status.
  2539. </summary>
  2540. <param name="uJoyID">
  2541. Identifier of the joystick to be queried. Valid values for uJoyID range from zero (<see cref="F:Tao.Platform.Windows.Winmm.JOYSTICKID1"/>) to 15, except for Windows NT 4.0. For Windows NT 4.0, valid values are limited to <see cref="F:Tao.Platform.Windows.Winmm.JOYSTICKID1"/> and <see cref="F:Tao.Platform.Windows.Winmm.JOYSTICKID2"/>.
  2542. </param>
  2543. <param name="pji">
  2544. Pointer to a <see cref="T:Tao.Platform.Windows.Winmm.JOYINFO"/> structure that contains the position and button status of the joystick.
  2545. </param>
  2546. <returns>
  2547. Returns <see cref="F:Tao.Platform.Windows.Winmm.JOYERR_NOERROR"/> if successful or one of the following error values.
  2548. <para>
  2549. <see cref="F:Tao.Platform.Windows.Winmm.MMSYSERR_NODRIVER"/> - The joystick driver is not present.
  2550. <see cref="F:Tao.Platform.Windows.Winmm.MMSYSERR_INVALPARAM"/> - An invalid parameter was passed.
  2551. <see cref="F:Tao.Platform.Windows.Winmm.JOYERR_UNPLUGGED"/> - The specified joystick is not connected to the system.
  2552. </para>
  2553. </returns>
  2554. <remarks>
  2555. For devices that have four to six axes of movement, a point-of-view control, or more than four buttons, use the <see cref="M:Tao.Platform.Windows.Winmm.joyGetPosEx(System.Int32,Tao.Platform.Windows.Winmm.JOYINFOEX@)"/> function.
  2556. </remarks>
  2557. </member>
  2558. <member name="M:Tao.Platform.Windows.Winmm.joyGetPosEx(System.Int32,Tao.Platform.Windows.Winmm.JOYINFOEX@)">
  2559. <summary>
  2560. The joyGetPosEx function queries a joystick for its position and button status.
  2561. </summary>
  2562. <param name="uJoyID">
  2563. Identifier of the joystick to be queried. Valid values for uJoyID range from zero (<see cref="F:Tao.Platform.Windows.Winmm.JOYSTICKID1"/>) to 15, except for Windows NT 4.0. For Windows NT 4.0, valid values are limited to <see cref="F:Tao.Platform.Windows.Winmm.JOYSTICKID1"/> and <see cref="F:Tao.Platform.Windows.Winmm.JOYSTICKID2"/>.
  2564. </param>
  2565. <param name="pji">
  2566. Pointer to a <see cref="T:Tao.Platform.Windows.Winmm.JOYINFOEX"/> structure that contains extended position information and button status of the joystick. You must set the dwSize and dwFlags members or joyGetPosEx will fail. The information returned from joyGetPosEx depends on the flags you specify in dwFlags.
  2567. </param>
  2568. <returns>
  2569. Returns JOYERR_NOERROR if successful or one of the following error values.
  2570. <para>
  2571. Returns JOYERR_NOERROR if successful or one of the following error values.
  2572. </para>
  2573. <para>
  2574. <see cref="F:Tao.Platform.Windows.Winmm.MMSYSERR_NODRIVER"/> - The joystick driver is not present.
  2575. <see cref="F:Tao.Platform.Windows.Winmm.MMSYSERR_INVALPARAM"/> - An invalid parameter was passed. Windows 95/98/Me: The specified joystick identifier is invalid.
  2576. <see cref="F:Tao.Platform.Windows.Winmm.MMSYSERR_BADDEVICEID"/> - Windows 95/98/Me: The specified joystick identifier is invalid.
  2577. <see cref="F:Tao.Platform.Windows.Winmm.JOYERR_UNPLUGGED"/> - The specified joystick is not connected to the system.
  2578. <see cref="F:Tao.Platform.Windows.Winmm.JOYERR_PARMS"/> - Windows NT/2000/XP: The specified joystick identifier is invalid.
  2579. </para>
  2580. </returns>
  2581. <remarks>
  2582. This function provides access to extended devices such as rudder pedals, point-of-view hats, devices with a large number of buttons, and coordinate systems using up to six axes. For joystick devices that use three axes or fewer and have fewer than four buttons, use the joyGetPos function.
  2583. </remarks>
  2584. </member>
  2585. <member name="M:Tao.Platform.Windows.Winmm.joyGetThreshold(System.Int32,System.IntPtr)">
  2586. <summary>
  2587. The joyGetThreshold function queries a joystick for its current movement threshold.
  2588. </summary>
  2589. <param name="uJoyID">
  2590. Identifier of the joystick. Valid values for uJoyID range from zero (<see cref="F:Tao.Platform.Windows.Winmm.JOYSTICKID1"/>) to 15, except for Windows NT 4.0. For Windows NT 4.0, valid values are limited to <see cref="F:Tao.Platform.Windows.Winmm.JOYSTICKID1"/> and <see cref="F:Tao.Platform.Windows.Winmm.JOYSTICKID2"/>.
  2591. </param>
  2592. <param name="puThreshold">
  2593. Pointer to a variable that contains the movement threshold value.
  2594. </param>
  2595. <returns>
  2596. <para>
  2597. Returns JOYERR_NOERROR if successful or one of the following error values.
  2598. </para>
  2599. <para>
  2600. <see cref="F:Tao.Platform.Windows.Winmm.MMSYSERR_NODRIVER"/> - The joystick driver is not present.
  2601. <see cref="F:Tao.Platform.Windows.Winmm.MMSYSERR_INVALPARAM"/> - An invalid parameter was passed.
  2602. </para>
  2603. </returns>
  2604. <remarks>
  2605. The movement threshold is the distance the joystick must be moved before a joystick position-change message (<see cref="F:Tao.Platform.Windows.Winmm.MM_JOY1MOVE"/>, <see cref="F:Tao.Platform.Windows.Winmm.MM_JOY1ZMOVE"/>, <see cref="F:Tao.Platform.Windows.Winmm.MM_JOY2MOVE"/>, or <see cref="F:Tao.Platform.Windows.Winmm.MM_JOY2ZMOVE"/>) is sent to a window that has captured the device. The threshold is initially zero.
  2606. </remarks>
  2607. </member>
  2608. <member name="M:Tao.Platform.Windows.Winmm.joyReleaseCapture(System.Int32)">
  2609. <summary>
  2610. The joyReleaseCapture function releases the specified captured joystick.
  2611. </summary>
  2612. <param name="uJoyID">
  2613. Identifier of the joystick. Valid values for uJoyID range from zero (<see cref="F:Tao.Platform.Windows.Winmm.JOYSTICKID1"/>) to 15, except for Windows NT 4.0. For Windows NT 4.0, valid values are limited to <see cref="F:Tao.Platform.Windows.Winmm.JOYSTICKID1"/> and <see cref="F:Tao.Platform.Windows.Winmm.JOYSTICKID2"/>.
  2614. </param>
  2615. <returns>
  2616. <para>
  2617. Returns <see cref="F:Tao.Platform.Windows.Winmm.JOYERR_NOERROR"/> if successful or one of the following error values.
  2618. </para>
  2619. <para>
  2620. <see cref="F:Tao.Platform.Windows.Winmm.MMSYSERR_NODRIVER"/> - The joystick driver is not present.
  2621. <see cref="F:Tao.Platform.Windows.Winmm.MMSYSERR_INVALPARAM"/> - Windows 95/98/Me: The specified joystick device identifier uJoyID is invalid. Windows NT/2000/XP: The specified joystick identifier is valid, but the joystick has not been captured.
  2622. <see cref="F:Tao.Platform.Windows.Winmm.JOYERR_PARMS"/> - Windows NT/2000/XP: The specified joystick device identifier uJoyID is invalid.
  2623. </para>
  2624. </returns>
  2625. <remarks>
  2626. Windows 95/98/Me: This method returns JOYERR_NOERROR when passed a valid joystick identifier that has not been captured.
  2627. </remarks>
  2628. </member>
  2629. <member name="M:Tao.Platform.Windows.Winmm.joySetCapture(System.Int32,System.Int32,System.Int32,System.Boolean)">
  2630. <summary>
  2631. The joySetCature function captures a joystick by causing its messages to be sent to the specified window.
  2632. </summary>
  2633. <param name="hwnd">
  2634. Handle to the window to receive the joystick messages.
  2635. </param>
  2636. <param name="uJoyID">
  2637. Identifier of the joystick. Valid values for uJoyID range from zero (<see cref="F:Tao.Platform.Windows.Winmm.JOYSTICKID1"/>) to 15, except for Windows NT 4.0. For Windows NT 4.0, valid values are limited to <see cref="F:Tao.Platform.Windows.Winmm.JOYSTICKID1"/> and <see cref="F:Tao.Platform.Windows.Winmm.JOYSTICKID2"/>.
  2638. </param>
  2639. <param name="uPeriod">
  2640. Polling frequency, in milliseconds.
  2641. </param>
  2642. <param name="fChanged">
  2643. Change position flag. Specify TRUE for this parameter to send messages only when the position changes by a value greater than the joystick movement threshold. Otherwise, messages are sent at the polling frequency specified in uPeriod.
  2644. </param>
  2645. <returns>
  2646. <para>
  2647. Returns JOYERR_NOERROR if successful or one of the following error values.
  2648. </para>
  2649. <para>
  2650. <see cref="F:Tao.Platform.Windows.Winmm.MMSYSERR_NODRIVER"/> - The joystick driver is not present.
  2651. <see cref="F:Tao.Platform.Windows.Winmm.MMSYSERR_INVALPARAM"/> - Windows 95/98/Me: Invalid joystick ID or hwnd is NULL.
  2652. <see cref="F:Tao.Platform.Windows.Winmm.JOYERR_NOCANDO"/> - Cannot capture joystick input because a required service (such as a Windows timer) is unavailable.
  2653. <see cref="F:Tao.Platform.Windows.Winmm.JOYERR_UNPLUGGED"/> - The specified joystick is not connected to the system.
  2654. <see cref="F:Tao.Platform.Windows.Winmm.JOYERR_PARMS"/> - Windows NT/2000/XP: Invalid joystick ID or hwnd is NULL.
  2655. </para>
  2656. </returns>
  2657. <remarks>
  2658. This function fails if the specified joystick is currently captured. Call the joyReleaseCapture function to release the captured joystick, or destroy the window to release the joystick automatically.
  2659. </remarks>
  2660. </member>
  2661. <member name="M:Tao.Platform.Windows.Winmm.joySetThreshold(System.Int32,System.Int32)">
  2662. <summary>
  2663. The joySetThreshold function sets the movement threshold of a joystick.
  2664. </summary>
  2665. <param name="uJoyID">
  2666. Identifier of the joystick. Valid values for uJoyID range from zero (<see cref="F:Tao.Platform.Windows.Winmm.JOYSTICKID1"/>) to 15, except for Windows NT 4.0. For Windows NT 4.0, valid values are limited to <see cref="F:Tao.Platform.Windows.Winmm.JOYSTICKID1"/> and <see cref="F:Tao.Platform.Windows.Winmm.JOYSTICKID2"/>.
  2667. </param>
  2668. <param name="uThreshold">
  2669. New movement threshold.
  2670. </param>
  2671. <returns>
  2672. <para>
  2673. Returns JOYERR_NOERROR if successful or one of the following error values.
  2674. </para>
  2675. <para>
  2676. <see cref="F:Tao.Platform.Windows.Winmm.MMSYSERR_NODRIVER"/> - The joystick driver is not present.
  2677. <see cref="F:Tao.Platform.Windows.Winmm.JOYERR_PARMS"/> - The specified joystick device identifier uJoyID is invalid.
  2678. </para>
  2679. </returns>
  2680. <remarks>
  2681. The movement threshold is the distance the joystick must be moved before a joystick position-change message (<see cref="F:Tao.Platform.Windows.Winmm.MM_JOY1MOVE"/>, <see cref="F:Tao.Platform.Windows.Winmm.MM_JOY1ZMOVE"/>, <see cref="F:Tao.Platform.Windows.Winmm.MM_JOY2MOVE"/>, or <see cref="F:Tao.Platform.Windows.Winmm.MM_JOY2ZMOVE"/>) is sent to a window that has captured the device. The threshold is initially zero.
  2682. </remarks>
  2683. </member>
  2684. <member name="T:Tao.Platform.Windows.Winmm.JOYCAPS">
  2685. <summary>
  2686. The JOYCAPS structure contains information about the joystick capabilities.
  2687. </summary>
  2688. <remarks>
  2689. <para>
  2690. <b>Requirements</b>
  2691. </para>
  2692. <para>
  2693. Windows NT/2000/XP: Included in Windows NT 3.1 and later.
  2694. Windows 95/98/Me: Included in Windows 95 and later.
  2695. Header: Declared in Mmsystem.h; include Windows.h.
  2696. Unicode: Declared as Unicode and ANSI structures.
  2697. </para>
  2698. </remarks>
  2699. <seealso cref="T:Tao.Platform.Windows.Winmm.JOYINFO"/>
  2700. <seealso cref="T:Tao.Platform.Windows.Winmm.JOYINFOEX"/>
  2701. <seealso cref="M:Tao.Platform.Windows.Winmm.joySetCapture(System.Int32,System.Int32,System.Int32,System.Boolean)"/>
  2702. </member>
  2703. <member name="F:Tao.Platform.Windows.Winmm.JOYCAPS.wMid">
  2704. <summary>
  2705. Manufacturer identifier. Manufacturer identifiers are defined in Manufacturer and Product Identifiers.
  2706. </summary>
  2707. </member>
  2708. <member name="F:Tao.Platform.Windows.Winmm.JOYCAPS.wPid">
  2709. <summary>
  2710. Product identifier. Product identifiers are defined in Manufacturer and Product Identifiers.
  2711. </summary>
  2712. </member>
  2713. <member name="F:Tao.Platform.Windows.Winmm.JOYCAPS.szPname">
  2714. <summary>
  2715. Null-terminated string containing the joystick product name.
  2716. </summary>
  2717. </member>
  2718. <member name="F:Tao.Platform.Windows.Winmm.JOYCAPS.wXmin">
  2719. <summary>
  2720. Minimum X-coordinate.
  2721. </summary>
  2722. </member>
  2723. <member name="F:Tao.Platform.Windows.Winmm.JOYCAPS.wXmax">
  2724. <summary>
  2725. Maximum X-coordinate.
  2726. </summary>
  2727. </member>
  2728. <member name="F:Tao.Platform.Windows.Winmm.JOYCAPS.wYmin">
  2729. <summary>
  2730. Minimum Y-coordinate.
  2731. </summary>
  2732. </member>
  2733. <member name="F:Tao.Platform.Windows.Winmm.JOYCAPS.wYmax">
  2734. <summary>
  2735. Maximum Y-coordinate.
  2736. </summary>
  2737. </member>
  2738. <member name="F:Tao.Platform.Windows.Winmm.JOYCAPS.wZmin">
  2739. <summary>
  2740. Minimum Z-coordinate.
  2741. </summary>
  2742. </member>
  2743. <member name="F:Tao.Platform.Windows.Winmm.JOYCAPS.wZmax">
  2744. <summary>
  2745. Maximum Z-coordinate.
  2746. </summary>
  2747. </member>
  2748. <member name="F:Tao.Platform.Windows.Winmm.JOYCAPS.wNumButtons">
  2749. <summary>
  2750. Number of joystick buttons.
  2751. </summary>
  2752. </member>
  2753. <member name="F:Tao.Platform.Windows.Winmm.JOYCAPS.wPeriodMin">
  2754. <summary>
  2755. Smallest polling frequency supported when captured by the <see cref="M:Tao.Platform.Windows.Winmm.joySetCapture(System.Int32,System.Int32,System.Int32,System.Boolean)"/> function.
  2756. </summary>
  2757. </member>
  2758. <member name="F:Tao.Platform.Windows.Winmm.JOYCAPS.wPeriodMax">
  2759. <summary>
  2760. Largest polling frequency supported when captured by <see cref="M:Tao.Platform.Windows.Winmm.joySetCapture(System.Int32,System.Int32,System.Int32,System.Boolean)"/>.
  2761. </summary>
  2762. </member>
  2763. <member name="F:Tao.Platform.Windows.Winmm.JOYCAPS.wRmin">
  2764. <summary>
  2765. Minimum rudder value. The rudder is a fourth axis of movement.
  2766. </summary>
  2767. </member>
  2768. <member name="F:Tao.Platform.Windows.Winmm.JOYCAPS.wRmax">
  2769. <summary>
  2770. Maximum rudder value. The rudder is a fourth axis of movement.
  2771. </summary>
  2772. </member>
  2773. <member name="F:Tao.Platform.Windows.Winmm.JOYCAPS.wUmin">
  2774. <summary>
  2775. Minimum u-coordinate (fifth axis) values.
  2776. </summary>
  2777. </member>
  2778. <member name="F:Tao.Platform.Windows.Winmm.JOYCAPS.wUmax">
  2779. <summary>
  2780. Maximum u-coordinate (fifth axis) values.
  2781. </summary>
  2782. </member>
  2783. <member name="F:Tao.Platform.Windows.Winmm.JOYCAPS.wVmin">
  2784. <summary>
  2785. Minimum v-coordinate (sixth axis) values.
  2786. </summary>
  2787. </member>
  2788. <member name="F:Tao.Platform.Windows.Winmm.JOYCAPS.wVmax">
  2789. <summary>
  2790. Maximum v-coordinate (sixth axis) values.
  2791. </summary>
  2792. </member>
  2793. <member name="F:Tao.Platform.Windows.Winmm.JOYCAPS.wCaps">
  2794. <summary>
  2795. Joystick capabilities The following flags define individual capabilities that a joystick might have:
  2796. </summary>
  2797. <remarks>
  2798. <see cref="F:Tao.Platform.Windows.Winmm.JOYCAPS_HASZ"/> - Joystick has z-coordinate information.
  2799. <see cref="F:Tao.Platform.Windows.Winmm.JOYCAPS_HASR"/> - Joystick has rudder (fourth axis) information.
  2800. <see cref="F:Tao.Platform.Windows.Winmm.JOYCAPS_HASU"/> - Joystick has u-coordinate (fifth axis) information.
  2801. <see cref="F:Tao.Platform.Windows.Winmm.JOYCAPS_HASV"/> - Joystick has v-coordinate (sixth axis) information.
  2802. <see cref="F:Tao.Platform.Windows.Winmm.JOYCAPS_HASPOV"/> - Joystick has point-of-view information.
  2803. <see cref="F:Tao.Platform.Windows.Winmm.JOYCAPS_POV4DIR"/> - Joystick point-of-view supports discrete values (centered, forward, backward, left, and right).
  2804. <see cref="F:Tao.Platform.Windows.Winmm.JOYCAPS_POVCTS"/> - Joystick point-of-view supports continuous degree bearings.
  2805. </remarks>
  2806. </member>
  2807. <member name="F:Tao.Platform.Windows.Winmm.JOYCAPS.wMaxAxes">
  2808. <summary>
  2809. Maximum number of axes supported by the joystick.
  2810. </summary>
  2811. </member>
  2812. <member name="F:Tao.Platform.Windows.Winmm.JOYCAPS.wNumAxes">
  2813. <summary>
  2814. Number of axes currently in use by the joystick.
  2815. </summary>
  2816. </member>
  2817. <member name="F:Tao.Platform.Windows.Winmm.JOYCAPS.wMaxButtons">
  2818. <summary>
  2819. Maximum number of buttons supported by the joystick.
  2820. </summary>
  2821. </member>
  2822. <member name="F:Tao.Platform.Windows.Winmm.JOYCAPS.szRegKey">
  2823. <summary>
  2824. Null-terminated string containing the registry key for the joystick.
  2825. </summary>
  2826. </member>
  2827. <member name="F:Tao.Platform.Windows.Winmm.JOYCAPS.szOEMVxD">
  2828. <summary>
  2829. Null-terminated string identifying the joystick driver OEM.
  2830. </summary>
  2831. </member>
  2832. <member name="T:Tao.Platform.Windows.Winmm.JOYINFO">
  2833. <summary>
  2834. The JOYINFO structure contains information about the joystick position and button state.
  2835. </summary>
  2836. <remarks>
  2837. <para>
  2838. <b>Requirements</b>
  2839. </para>
  2840. <para>
  2841. Windows NT/2000/XP: Included in Windows NT 3.1 and later.
  2842. Windows 95/98/Me: Included in Windows 95 and later.
  2843. Header: Declared in Mmsystem.h; include Windows.h.
  2844. </para>
  2845. </remarks>
  2846. </member>
  2847. <member name="F:Tao.Platform.Windows.Winmm.JOYINFO.wXpos">
  2848. <summary>
  2849. Current X-coordinate.
  2850. </summary>
  2851. </member>
  2852. <member name="F:Tao.Platform.Windows.Winmm.JOYINFO.wYpos">
  2853. <summary>
  2854. Current Y-coordinate.
  2855. </summary>
  2856. </member>
  2857. <member name="F:Tao.Platform.Windows.Winmm.JOYINFO.wZpos">
  2858. <summary>
  2859. Current Z-coordinate.
  2860. </summary>
  2861. </member>
  2862. <member name="F:Tao.Platform.Windows.Winmm.JOYINFO.wButtons">
  2863. <summary>
  2864. Current state of joystick buttons.
  2865. </summary>
  2866. <remarks>
  2867. <para>According to one or more of the following values:</para>
  2868. <para>
  2869. <see cref="F:Tao.Platform.Windows.Winmm.JOY_BUTTON1"/> - First joystick button is pressed.
  2870. <see cref="F:Tao.Platform.Windows.Winmm.JOY_BUTTON2"/> - Second joystick button is pressed.
  2871. <see cref="F:Tao.Platform.Windows.Winmm.JOY_BUTTON3"/> - Third joystick button is pressed.
  2872. <see cref="F:Tao.Platform.Windows.Winmm.JOY_BUTTON4"/> - Fourth joystick button is pressed.
  2873. </para>
  2874. </remarks>
  2875. </member>
  2876. <member name="T:Tao.Platform.Windows.Winmm.JOYINFOEX">
  2877. <summary>
  2878. The JOYINFOEX structure contains extended information about the joystick position, point-of-view position, and button state.
  2879. </summary>
  2880. <remarks>
  2881. <para>
  2882. The value of the dwSize member is also used to identify the version number for the structure when it's passed to the <see cref="M:Tao.Platform.Windows.Winmm.joyGetPosEx(System.Int32,Tao.Platform.Windows.Winmm.JOYINFOEX@)"/> function.
  2883. </para>
  2884. <para>
  2885. Most devices with a point-of-view control have only five positions. When the JOY_RETURNPOV flag is set, these positions are reported by using the following constants:
  2886. </para>
  2887. <para>
  2888. <see cref="F:Tao.Platform.Windows.Winmm.JOY_POVBACKWARD"/> - Point-of-view hat is pressed backward. The value 18,000 represents an orientation of 180.00 degrees (to the rear).
  2889. <see cref="F:Tao.Platform.Windows.Winmm.JOY_POVCENTERED"/> - Point-of-view hat is in the neutral position. The value -1 means the point-of-view hat has no angle to report.
  2890. <see cref="F:Tao.Platform.Windows.Winmm.JOY_POVFORWARD"/> - Point-of-view hat is pressed forward. The value 0 represents an orientation of 0.00 degrees (straight ahead).
  2891. <see cref="F:Tao.Platform.Windows.Winmm.JOY_POVLEFT"/> - Point-of-view hat is being pressed to the left. The value 27,000 represents an orientation of 270.00 degrees (90.00 degrees to the left).
  2892. <see cref="F:Tao.Platform.Windows.Winmm.JOY_POVRIGHT"/> - Point-of-view hat is pressed to the right. The value 9,000 represents an orientation of 90.00 degrees (to the right).
  2893. </para>
  2894. <para>
  2895. The default joystick driver currently supports these five discrete directions. If an application can accept only the defined point-of-view values, it must use the JOY_RETURNPOV flag. If an application can accept other degree readings, it should use the JOY_RETURNPOVCTS flag to obtain continuous data if it is available. The JOY_RETURNPOVCTS flag also supports the JOY_POV constants used with the JOY_RETURNPOV flag.
  2896. </para>
  2897. </remarks>
  2898. <seealso cref="M:Tao.Platform.Windows.Winmm.joyGetPosEx(System.Int32,Tao.Platform.Windows.Winmm.JOYINFOEX@)"/>
  2899. </member>
  2900. <member name="F:Tao.Platform.Windows.Winmm.JOYINFOEX.dwSize">
  2901. <summary>
  2902. Size, in bytes, of this structure.
  2903. </summary>
  2904. </member>
  2905. <member name="F:Tao.Platform.Windows.Winmm.JOYINFOEX.dwFlags">
  2906. <summary>
  2907. Flags indicating the valid information returned in this structure. Members that do not contain valid information are set to zero.
  2908. </summary>
  2909. <remarks>
  2910. <para>
  2911. <see cref="F:Tao.Platform.Windows.Winmm.JOY_RETURNALL"/> - Equivalent to setting all of the JOY_RETURN bits except JOY_RETURNRAWDATA.
  2912. <see cref="F:Tao.Platform.Windows.Winmm.JOY_RETURNBUTTONS"/> - The dwButtons member contains valid information about the state of each joystick button.
  2913. <see cref="F:Tao.Platform.Windows.Winmm.JOY_RETURNCENTERED"/> - Centers the joystick neutral position to the middle value of each axis of movement.
  2914. <see cref="F:Tao.Platform.Windows.Winmm.JOY_RETURNPOV"/> - The dwPOV member contains valid information about the point-of-view control, expressed in discrete units.
  2915. <see cref="F:Tao.Platform.Windows.Winmm.JOY_RETURNPOVCTS"/> - The dwPOV member contains valid information about the point-of-view control expressed in continuous, one-hundredth degree units.
  2916. <see cref="F:Tao.Platform.Windows.Winmm.JOY_RETURNR"/> - The dwRpos member contains valid rudder pedal data. This information represents another (fourth) axis.
  2917. <see cref="F:Tao.Platform.Windows.Winmm.JOY_RETURNRAWDATA"/> - Data stored in this structure is uncalibrated joystick readings.
  2918. <see cref="F:Tao.Platform.Windows.Winmm.JOY_RETURNU"/> - The dwUpos member contains valid data for a fifth axis of the joystick, if such an axis is available, or returns zero otherwise.
  2919. <see cref="F:Tao.Platform.Windows.Winmm.JOY_RETURNV"/> - The dwVpos member contains valid data for a sixth axis of the joystick, if such an axis is available, or returns zero otherwise.
  2920. <see cref="F:Tao.Platform.Windows.Winmm.JOY_RETURNX"/> - The dwXpos member contains valid data for the x-coordinate of the joystick.
  2921. <see cref="F:Tao.Platform.Windows.Winmm.JOY_RETURNY"/> - The dwYpos member contains valid data for the y-coordinate of the joystick.
  2922. <see cref="F:Tao.Platform.Windows.Winmm.JOY_RETURNZ"/> - The dwZpos member contains valid data for the z-coordinate of the joystick.
  2923. <see cref="F:Tao.Platform.Windows.Winmm.JOY_USEDEADZONE"/> - Expands the range for the neutral position of the joystick and calls this range the dead zone. The joystick driver returns a constant value for all positions in the dead zone.
  2924. </para>
  2925. <para>
  2926. The following flags provide data to calibrate a joystick and are intended for custom calibration applications.
  2927. </para>
  2928. <para>
  2929. <see cref="F:Tao.Platform.Windows.Winmm.JOY_CAL_READ3"/> - Read the x-, y-, and z-coordinates and store the raw values in dwXpos, dwYpos, and dwZpos.
  2930. <see cref="F:Tao.Platform.Windows.Winmm.JOY_CAL_READ4"/> - Read the rudder information and the x-, y-, and z-coordinates and store the raw values in dwXpos, dwYpos, dwZpos, and dwRpos.
  2931. <see cref="F:Tao.Platform.Windows.Winmm.JOY_CAL_READ5"/> - Read the rudder information and the x-, y-, z-, and u-coordinates and store the raw values in dwXpos, dwYpos, dwZpos, dwRpos, and dwUpos.
  2932. <see cref="F:Tao.Platform.Windows.Winmm.JOY_CAL_READ6"/> - Read the raw v-axis data if a joystick mini driver is present that will provide the data. Returns zero otherwise.
  2933. <see cref="F:Tao.Platform.Windows.Winmm.JOY_CAL_READALWAYS"/> - Read the joystick port even if the driver does not detect a device.
  2934. <see cref="F:Tao.Platform.Windows.Winmm.JOY_CAL_READRONLY"/> - Read the rudder information if a joystick mini-driver is present that will provide the data and store the raw value in dwRpos. Return zero otherwise.
  2935. <see cref="F:Tao.Platform.Windows.Winmm.JOY_CAL_READXONLY"/> - Read the x-coordinate and store the raw (uncalibrated) value in dwXpos.
  2936. <see cref="F:Tao.Platform.Windows.Winmm.JOY_CAL_READXYONLY"/> - Reads the x- and y-coordinates and place the raw values in dwXpos and dwYpos.
  2937. <see cref="F:Tao.Platform.Windows.Winmm.JOY_CAL_READYONLY"/> - Reads the y-coordinate and store the raw value in dwYpos.
  2938. <see cref="F:Tao.Platform.Windows.Winmm.JOY_CAL_READZONLY"/> - Read the z-coordinate and store the raw value in dwZpos.
  2939. <see cref="F:Tao.Platform.Windows.Winmm.JOY_CAL_READUONLY"/> - Read the u-coordinate if a joystick mini-driver is present that will provide the data and store the raw value in dwUpos. Return zero otherwise.
  2940. <see cref="F:Tao.Platform.Windows.Winmm.JOY_CAL_READVONLY"/> - Read the v-coordinate if a joystick mini-driver is present that will provide the data and store the raw value in dwVpos. Return zero otherwise.
  2941. </para>
  2942. </remarks>
  2943. </member>
  2944. <member name="F:Tao.Platform.Windows.Winmm.JOYINFOEX.dwXpos">
  2945. <summary>
  2946. Current X-coordinate.
  2947. </summary>
  2948. </member>
  2949. <member name="F:Tao.Platform.Windows.Winmm.JOYINFOEX.dwYpos">
  2950. <summary>
  2951. Current Y-coordinate.
  2952. </summary>
  2953. </member>
  2954. <member name="F:Tao.Platform.Windows.Winmm.JOYINFOEX.dwZpos">
  2955. <summary>
  2956. Current Z-coordinate.
  2957. </summary>
  2958. </member>
  2959. <member name="F:Tao.Platform.Windows.Winmm.JOYINFOEX.dwRpos">
  2960. <summary>
  2961. Current position of the rudder or fourth joystick axis.
  2962. </summary>
  2963. </member>
  2964. <member name="F:Tao.Platform.Windows.Winmm.JOYINFOEX.dwUpos">
  2965. <summary>
  2966. Current fifth axis position.
  2967. </summary>
  2968. </member>
  2969. <member name="F:Tao.Platform.Windows.Winmm.JOYINFOEX.dwVpos">
  2970. <summary>
  2971. Current sixth axis position.
  2972. </summary>
  2973. </member>
  2974. <member name="F:Tao.Platform.Windows.Winmm.JOYINFOEX.dwButtons">
  2975. <summary>
  2976. Current state of the 32 joystick buttons. The value of this member can be set to any combination of JOY_BUTTONn flags, where n is a value in the range of 1 through 32 corresponding to the button that is pressed.
  2977. </summary>
  2978. </member>
  2979. <member name="F:Tao.Platform.Windows.Winmm.JOYINFOEX.dwButtonNumber">
  2980. <summary>
  2981. Current button number that is pressed.
  2982. </summary>
  2983. </member>
  2984. <member name="F:Tao.Platform.Windows.Winmm.JOYINFOEX.dwPOV">
  2985. <summary>
  2986. Current position of the point-of-view control. Values for this member are in the range 0 through 35,900. These values represent the angle, in degrees, of each view multiplied by 100.
  2987. </summary>
  2988. </member>
  2989. <member name="F:Tao.Platform.Windows.Winmm.JOYINFOEX.dwReserved1">
  2990. <summary>
  2991. Reserved; do not use.
  2992. </summary>
  2993. </member>
  2994. <member name="F:Tao.Platform.Windows.Winmm.JOYINFOEX.dwReserved2">
  2995. <summary>
  2996. Reserved; do not use.
  2997. </summary>
  2998. </member>
  2999. <member name="T:Tao.Platform.Windows.User">
  3000. <summary>
  3001. User binding for .NET, implementing Windows-specific user functionality.
  3002. </summary>
  3003. <remarks>
  3004. Binds functions and definitions in user32.dll.
  3005. </remarks>
  3006. </member>
  3007. <member name="F:Tao.Platform.Windows.User.USER_NATIVE_LIBRARY">
  3008. <summary>
  3009. Specifies User32's native library archive.
  3010. </summary>
  3011. <remarks>
  3012. Specifies user32.dll for Windows.
  3013. </remarks>
  3014. </member>
  3015. <member name="F:Tao.Platform.Windows.User.CALLING_CONVENTION">
  3016. <summary>
  3017. Specifies the calling convention.
  3018. </summary>
  3019. <remarks>
  3020. Specifies <see cref="F:System.Runtime.InteropServices.CallingConvention.StdCall"/>.
  3021. </remarks>
  3022. </member>
  3023. <member name="F:Tao.Platform.Windows.User.CS_VREDRAW">
  3024. <summary>
  3025. </summary>
  3026. </member>
  3027. <member name="F:Tao.Platform.Windows.User.CS_HREDRAW">
  3028. <summary>
  3029. </summary>
  3030. </member>
  3031. <member name="F:Tao.Platform.Windows.User.CS_DBLCLKS">
  3032. <summary>
  3033. </summary>
  3034. </member>
  3035. <member name="F:Tao.Platform.Windows.User.CS_OWNDC">
  3036. <summary>
  3037. </summary>
  3038. </member>
  3039. <member name="F:Tao.Platform.Windows.User.CS_CLASSDC">
  3040. <summary>
  3041. </summary>
  3042. </member>
  3043. <member name="F:Tao.Platform.Windows.User.CS_PARENTDC">
  3044. <summary>
  3045. </summary>
  3046. </member>
  3047. <member name="F:Tao.Platform.Windows.User.CS_NOCLOSE">
  3048. <summary>
  3049. </summary>
  3050. </member>
  3051. <member name="F:Tao.Platform.Windows.User.CS_SAVEBITS">
  3052. <summary>
  3053. </summary>
  3054. </member>
  3055. <member name="F:Tao.Platform.Windows.User.CS_BYTEALIGNCLIENT">
  3056. <summary>
  3057. </summary>
  3058. </member>
  3059. <member name="F:Tao.Platform.Windows.User.CS_BYTEALIGNWINDOW">
  3060. <summary>
  3061. </summary>
  3062. </member>
  3063. <member name="F:Tao.Platform.Windows.User.CS_GLOBALCLASS">
  3064. <summary>
  3065. </summary>
  3066. </member>
  3067. <member name="F:Tao.Platform.Windows.User.CS_IME">
  3068. <summary>
  3069. </summary>
  3070. </member>
  3071. <member name="F:Tao.Platform.Windows.User.CS_DROPSHADOW">
  3072. <summary>
  3073. </summary>
  3074. </member>
  3075. <member name="F:Tao.Platform.Windows.User.CDS_UPDATEREGISTRY">
  3076. <summary>
  3077. </summary>
  3078. </member>
  3079. <member name="F:Tao.Platform.Windows.User.CDS_TEST">
  3080. <summary>
  3081. </summary>
  3082. </member>
  3083. <member name="F:Tao.Platform.Windows.User.CDS_FULLSCREEN">
  3084. <summary>
  3085. </summary>
  3086. </member>
  3087. <member name="F:Tao.Platform.Windows.User.DISP_CHANGE_SUCCESSFUL">
  3088. <summary>
  3089. </summary>
  3090. </member>
  3091. <member name="F:Tao.Platform.Windows.User.DISP_CHANGE_RESTART">
  3092. <summary>
  3093. </summary>
  3094. </member>
  3095. <member name="F:Tao.Platform.Windows.User.DISP_CHANGE_FAILED">
  3096. <summary>
  3097. </summary>
  3098. </member>
  3099. <member name="F:Tao.Platform.Windows.User.ENUM_CURRENT_SETTINGS">
  3100. <summary>
  3101. </summary>
  3102. </member>
  3103. <member name="M:Tao.Platform.Windows.User.ChangeDisplaySettings(Tao.Platform.Windows.Gdi.DEVMODE@,System.Int32)">
  3104. <summary>
  3105. <para>
  3106. The <b>ChangeDisplaySettings</b> function changes the settings of the default
  3107. display device to the specified graphics mode.
  3108. </para>
  3109. <para>
  3110. To change the settings of a specified display device, use the
  3111. <b>ChangeDisplaySettingsEx</b> function.
  3112. </para>
  3113. </summary>
  3114. <param name="devMode">
  3115. <para>
  3116. Pointer to a <see cref="T:Tao.Platform.Windows.Gdi.DEVMODE"/> structure that describes the new
  3117. graphics mode. If <i>devMode</i> is NULL, all the values currently in the
  3118. registry will be used for the display setting. Passing NULL for the
  3119. <i>devMode</i> parameter and 0 for the <i>flags</i> parameter is the easiest
  3120. way to return to the default mode after a dynamic mode change.
  3121. </para>
  3122. <para>
  3123. The <see cref="F:Tao.Platform.Windows.Gdi.DEVMODE.dmSize"/> member of <see cref="T:Tao.Platform.Windows.Gdi.DEVMODE"/>
  3124. must be initialized to the size, in bytes, of the <see cref="T:Tao.Platform.Windows.Gdi.DEVMODE"/>
  3125. structure. The <see cref="F:Tao.Platform.Windows.Gdi.DEVMODE.dmDriverExtra"/> member of
  3126. <see cref="T:Tao.Platform.Windows.Gdi.DEVMODE"/> must be initialized to indicate the number of bytes
  3127. of private driver data following the <see cref="T:Tao.Platform.Windows.Gdi.DEVMODE"/> structure. In
  3128. addition, you can use any or all of the following members of the
  3129. <see cref="T:Tao.Platform.Windows.Gdi.DEVMODE"/> structure:
  3130. </para>
  3131. <para>
  3132. <list type="table">
  3133. <listheader>
  3134. <term>Value</term>
  3135. <description>Description</description>
  3136. </listheader>
  3137. <item>
  3138. <term><see cref="F:Tao.Platform.Windows.Gdi.DEVMODE.dmBitsPerPel"/></term>
  3139. <description>Bits per pixel.</description>
  3140. </item>
  3141. <item>
  3142. <term><see cref="F:Tao.Platform.Windows.Gdi.DEVMODE.dmPelsWidth"/></term>
  3143. <description>Pixel width.</description>
  3144. </item>
  3145. <item>
  3146. <term><see cref="F:Tao.Platform.Windows.Gdi.DEVMODE.dmPelsHeight"/></term>
  3147. <description>Pixel height.</description>
  3148. </item>
  3149. <item>
  3150. <term><see cref="F:Tao.Platform.Windows.Gdi.DEVMODE.dmDisplayFlags"/></term>
  3151. <description>Mode flags.</description>
  3152. </item>
  3153. <item>
  3154. <term><see cref="F:Tao.Platform.Windows.Gdi.DEVMODE.dmDisplayFrequency"/></term>
  3155. <description>Mode frequency.</description>
  3156. </item>
  3157. <item>
  3158. <term>dmPosition</term>
  3159. <description>
  3160. <b>Windows 98/Me, Windows 2000/XP:</b> Position of the device in
  3161. a multimonitor configuration.
  3162. </description>
  3163. </item>
  3164. </list>
  3165. </para>
  3166. <para>
  3167. In addition to using one or more of the preceding <see cref="T:Tao.Platform.Windows.Gdi.DEVMODE"/>
  3168. members, you must also set one or more of the following values in the
  3169. <see cref="F:Tao.Platform.Windows.Gdi.DEVMODE.dmFields"/> member to change the display setting:
  3170. </para>
  3171. <para>
  3172. <list type="table">
  3173. <listheader>
  3174. <term>Value</term>
  3175. <description>Description</description>
  3176. </listheader>
  3177. <item>
  3178. <term><see cref="F:Tao.Platform.Windows.Gdi.DM_BITSPERPEL"/></term>
  3179. <description>
  3180. Use the <see cref="F:Tao.Platform.Windows.Gdi.DEVMODE.dmBitsPerPel"/> value.
  3181. </description>
  3182. </item>
  3183. <item>
  3184. <term><see cref="F:Tao.Platform.Windows.Gdi.DM_PELSWIDTH"/></term>
  3185. <description>
  3186. Use the <see cref="F:Tao.Platform.Windows.Gdi.DEVMODE.dmPelsWidth"/> value.
  3187. </description>
  3188. </item>
  3189. <item>
  3190. <term><see cref="F:Tao.Platform.Windows.Gdi.DM_PELSHEIGHT"/></term>
  3191. <description>
  3192. Use the <see cref="F:Tao.Platform.Windows.Gdi.DEVMODE.dmPelsHeight"/> value.
  3193. </description>
  3194. </item>
  3195. <item>
  3196. <term><see cref="F:Tao.Platform.Windows.Gdi.DM_DISPLAYFLAGS"/></term>
  3197. <description>
  3198. Use the <see cref="F:Tao.Platform.Windows.Gdi.DEVMODE.dmDisplayFlags"/> value.
  3199. </description>
  3200. </item>
  3201. <item>
  3202. <term><see cref="F:Tao.Platform.Windows.Gdi.DM_DISPLAYFREQUENCY"/></term>
  3203. <description>
  3204. Use the <see cref="F:Tao.Platform.Windows.Gdi.DEVMODE.dmDisplayFrequency"/> value.
  3205. </description>
  3206. </item>
  3207. <item>
  3208. <term>see cref="Gdi.DM_POSITION" </term>
  3209. <description>
  3210. <b>Windows 98/Me, Windows 2000/XP:</b> Use the dmPosition value.
  3211. </description>
  3212. </item>
  3213. </list>
  3214. </para>
  3215. </param>
  3216. <param name="flags">
  3217. <para>
  3218. Indicates how the graphics mode should be changed. This parameter can be one
  3219. of the following values:
  3220. </para>
  3221. <para>
  3222. <list type="table">
  3223. <listheader>
  3224. <term>Value</term>
  3225. <description>Description</description>
  3226. </listheader>
  3227. <item>
  3228. <term>0</term>
  3229. <description>
  3230. The graphics mode for the current screen will be changed
  3231. dynamically.
  3232. </description>
  3233. </item>
  3234. <item>
  3235. <term>see cref="Gdi.CDS_FULLSCREEN" </term>
  3236. <description>
  3237. <para>
  3238. The mode is temporary in nature.
  3239. </para>
  3240. <para>
  3241. <b>Windows NT/2000/XP:</b> If you change to and from another
  3242. desktop, this mode will not be reset.
  3243. </para>
  3244. </description>
  3245. </item>
  3246. <item>
  3247. <term>see cref="Gdi.CDS_GLOBAL" </term>
  3248. <description>
  3249. The settings will be saved in the global settings area so that
  3250. they will affect all users on the machine. Otherwise, only the
  3251. settings for the user are modified. This flag is only valid when
  3252. specified with the see cref="Gdi.CDS_UPDATEREGISTRY" flag.
  3253. </description>
  3254. </item>
  3255. <item>
  3256. <term>see cref="Gdi.CDS_NORESET" </term>
  3257. <description>
  3258. The settings will be saved in the registry, but will not take
  3259. affect. This flag is only valid when specified with the
  3260. see cref="Gdi.CDS_UPDATEREGISTRY" flag.
  3261. </description>
  3262. </item>
  3263. <item>
  3264. <term>see cref="Gdi.CDS_RESET" </term>
  3265. <description>
  3266. The settings should be changed, even if the requested settings are
  3267. the same as the current settings.
  3268. </description>
  3269. </item>
  3270. <item>
  3271. <term>see cref="Gdi.CDS_SET_PRIMARY" </term>
  3272. <description>
  3273. This device will become the primary device.
  3274. </description>
  3275. </item>
  3276. <item>
  3277. <term>see cref="Gdi.CDS_TEST" </term>
  3278. <description>
  3279. The system tests if the requested graphics mode could be set.
  3280. </description>
  3281. </item>
  3282. <item>
  3283. <term>see cref="Gdi.CDS_UPDATEREGISTRY" </term>
  3284. <description>
  3285. The graphics mode for the current screen will be changed
  3286. dynamically and the graphics mode will be updated in the registry.
  3287. The mode information is stored in the USER profile.
  3288. </description>
  3289. </item>
  3290. </list>
  3291. </para>
  3292. <para>
  3293. Specifying see cref="Gdi.CDS_TEST" allows an application to determine
  3294. which graphics modes are actually valid, without causing the system to
  3295. change to that graphics mode.
  3296. </para>
  3297. <para>
  3298. If see cref="Gdi.CDS_UPDATEREGISTRY" is specified and it is possible to
  3299. change the graphics mode dynamically, the information is stored in the
  3300. registry and see cref="Gdi.DISP_CHANGE_SUCCESSFUL" is returned. If it is
  3301. not possible to change the graphics mode dynamically, the information is
  3302. stored in the registry and see cref="Gdi.DISP_CHANGE_RESTART" is returned.
  3303. </para>
  3304. <para>
  3305. <b>Windows NT/2000/XP:</b> If see cref="Gdi.CDS_UPDATEREGISTRY" is
  3306. specified and the information could not be stored in the registry, the
  3307. graphics mode is not changed and see cref="Gdi.DISP_CHANGE_NOTUPDATED" is
  3308. returned.
  3309. </para>
  3310. </param>
  3311. <returns>
  3312. <para>
  3313. The <b>ChangeDisplaySettings</b> function returns one of the following values:
  3314. </para>
  3315. <para>
  3316. <list type="table">
  3317. <listheader>
  3318. <term>Value</term>
  3319. <description>Description</description>
  3320. </listheader>
  3321. <item>
  3322. <term>see cref="Gdi.DISP_CHANGE_SUCCESSFUL" </term>
  3323. <description>
  3324. The settings change was successful.
  3325. </description>
  3326. </item>
  3327. <item>
  3328. <term>see cref="Gdi.DISP_CHANGE_BADDUALVIEW" </term>
  3329. <description>
  3330. <b>Windows XP:</b> The settings change was unsuccessful because
  3331. system is DualView capable.
  3332. </description>
  3333. </item>
  3334. <item>
  3335. <term>see cref="Gdi.DISP_CHANGE_BADFLAGS" </term>
  3336. <description>
  3337. An invalid set of flags was passed in.
  3338. </description>
  3339. </item>
  3340. <item>
  3341. <term>see cref="Gdi.DISP_CHANGE_BADMODE" </term>
  3342. <description>
  3343. The graphics mode is not supported.
  3344. </description>
  3345. </item>
  3346. <item>
  3347. <term>see cref="Gdi.DISP_CHANGE_BADPARAM" </term>
  3348. <description>
  3349. An invalid parameter was passed in. This can include an invalid
  3350. flag or combination of flags.
  3351. </description>
  3352. </item>
  3353. <item>
  3354. <term>see cref="Gdi.DISP_CHANGE_FAILED" </term>
  3355. <description>
  3356. The display driver failed the specified graphics mode.
  3357. </description>
  3358. </item>
  3359. <item>
  3360. <term>see cref="Gdi.DISP_CHANGE_NOTUPDATED" </term>
  3361. <description>
  3362. <b>Windows NT/2000/XP:</b> Unable to write settings to the
  3363. registry.
  3364. </description>
  3365. </item>
  3366. <item>
  3367. <term>see cref="Gdi.DISP_CHANGE_RESTART" </term>
  3368. <description>
  3369. The computer must be restarted in order for the graphics mode to
  3370. work.
  3371. </description>
  3372. </item>
  3373. </list>
  3374. </para>
  3375. </returns>
  3376. <remarks>
  3377. <para>
  3378. To ensure that the <see cref="T:Tao.Platform.Windows.Gdi.DEVMODE"/> structure passed to
  3379. <b>ChangeDisplaySettings</b> is valid and contains only values supported by
  3380. the display driver, use the <see cref="T:Tao.Platform.Windows.Gdi.DEVMODE"/> returned by the
  3381. <see cref="M:Tao.Platform.Windows.User.EnumDisplaySettings(System.String,System.Int32,Tao.Platform.Windows.Gdi.DEVMODE@)"/> function.
  3382. </para>
  3383. <para>
  3384. When the display mode is changed dynamically, the <b>WM_DISPLAYCHANGE</b>
  3385. message is sent to all running applications with the following message
  3386. parameters:
  3387. </para>
  3388. <para>
  3389. <list type="table">
  3390. <listheader>
  3391. <term>Value</term>
  3392. <description>Description</description>
  3393. </listheader>
  3394. <item>
  3395. <term>wParam</term>
  3396. <description>New bits per pixel.</description>
  3397. </item>
  3398. <item>
  3399. <term>LOWORD(lParam)</term>
  3400. <description>New pixel width.</description>
  3401. </item>
  3402. <item>
  3403. <term>HIWORD(lParam)</term>
  3404. <description>New pixel height.</description>
  3405. </item>
  3406. </list>
  3407. </para>
  3408. <para>
  3409. <b>Windows 95/98/Me:</b> If the calling thread has any windows,
  3410. <b>ChangeDisplaySettings</b> sends them the <b>WM_DISPLAYCHANGE</b> message
  3411. immediately (for windows in all other threads, the message is sent when the
  3412. thread can receive nonqueued messages). This may cause the shell to get its
  3413. message too soon and could squash icons. To avoid this problem, have
  3414. <b>ChangeDisplaySettings</b> do resolution switching by calling on a thread
  3415. with no windows, for example, a new thread.
  3416. </para>
  3417. </remarks>
  3418. seealso cref="CreateDC"
  3419. <seealso cref="T:Tao.Platform.Windows.Gdi.DEVMODE"/>
  3420. <seealso cref="M:Tao.Platform.Windows.User.EnumDisplaySettings(System.String,System.Int32,Tao.Platform.Windows.Gdi.DEVMODE@)"/>
  3421. </member>
  3422. <member name="M:Tao.Platform.Windows.User.ChangeDisplaySettings(System.IntPtr,System.Int32)">
  3423. <summary>
  3424. <para>
  3425. The <b>ChangeDisplaySettings</b> function changes the settings of the default
  3426. display device to the specified graphics mode.
  3427. </para>
  3428. <para>
  3429. To change the settings of a specified display device, use the
  3430. <b>ChangeDisplaySettingsEx</b> function.
  3431. </para>
  3432. </summary>
  3433. <param name="devMode">
  3434. <para>
  3435. Pointer to a <see cref="T:Tao.Platform.Windows.Gdi.DEVMODE"/> structure that describes the new
  3436. graphics mode. If <i>devMode</i> is NULL, all the values currently in the
  3437. registry will be used for the display setting. Passing NULL for the
  3438. <i>devMode</i> parameter and 0 for the <i>flags</i> parameter is the easiest
  3439. way to return to the default mode after a dynamic mode change.
  3440. </para>
  3441. <para>
  3442. The <see cref="F:Tao.Platform.Windows.Gdi.DEVMODE.dmSize"/> member of <see cref="T:Tao.Platform.Windows.Gdi.DEVMODE"/>
  3443. must be initialized to the size, in bytes, of the <see cref="T:Tao.Platform.Windows.Gdi.DEVMODE"/>
  3444. structure. The <see cref="F:Tao.Platform.Windows.Gdi.DEVMODE.dmDriverExtra"/> member of
  3445. <see cref="T:Tao.Platform.Windows.Gdi.DEVMODE"/> must be initialized to indicate the number of bytes
  3446. of private driver data following the <see cref="T:Tao.Platform.Windows.Gdi.DEVMODE"/> structure. In
  3447. addition, you can use any or all of the following members of the
  3448. <see cref="T:Tao.Platform.Windows.Gdi.DEVMODE"/> structure:
  3449. </para>
  3450. <para>
  3451. <list type="table">
  3452. <listheader>
  3453. <term>Value</term>
  3454. <description>Description</description>
  3455. </listheader>
  3456. <item>
  3457. <term><see cref="F:Tao.Platform.Windows.Gdi.DEVMODE.dmBitsPerPel"/></term>
  3458. <description>Bits per pixel.</description>
  3459. </item>
  3460. <item>
  3461. <term><see cref="F:Tao.Platform.Windows.Gdi.DEVMODE.dmPelsWidth"/></term>
  3462. <description>Pixel width.</description>
  3463. </item>
  3464. <item>
  3465. <term><see cref="F:Tao.Platform.Windows.Gdi.DEVMODE.dmPelsHeight"/></term>
  3466. <description>Pixel height.</description>
  3467. </item>
  3468. <item>
  3469. <term><see cref="F:Tao.Platform.Windows.Gdi.DEVMODE.dmDisplayFlags"/></term>
  3470. <description>Mode flags.</description>
  3471. </item>
  3472. <item>
  3473. <term><see cref="F:Tao.Platform.Windows.Gdi.DEVMODE.dmDisplayFrequency"/></term>
  3474. <description>Mode frequency.</description>
  3475. </item>
  3476. <item>
  3477. <term>dmPosition</term>
  3478. <description>
  3479. <b>Windows 98/Me, Windows 2000/XP:</b> Position of the device in
  3480. a multimonitor configuration.
  3481. </description>
  3482. </item>
  3483. </list>
  3484. </para>
  3485. <para>
  3486. In addition to using one or more of the preceding <see cref="T:Tao.Platform.Windows.Gdi.DEVMODE"/>
  3487. members, you must also set one or more of the following values in the
  3488. <see cref="F:Tao.Platform.Windows.Gdi.DEVMODE.dmFields"/> member to change the display setting:
  3489. </para>
  3490. <para>
  3491. <list type="table">
  3492. <listheader>
  3493. <term>Value</term>
  3494. <description>Description</description>
  3495. </listheader>
  3496. <item>
  3497. <term><see cref="F:Tao.Platform.Windows.Gdi.DM_BITSPERPEL"/></term>
  3498. <description>
  3499. Use the <see cref="F:Tao.Platform.Windows.Gdi.DEVMODE.dmBitsPerPel"/> value.
  3500. </description>
  3501. </item>
  3502. <item>
  3503. <term><see cref="F:Tao.Platform.Windows.Gdi.DM_PELSWIDTH"/></term>
  3504. <description>
  3505. Use the <see cref="F:Tao.Platform.Windows.Gdi.DEVMODE.dmPelsWidth"/> value.
  3506. </description>
  3507. </item>
  3508. <item>
  3509. <term><see cref="F:Tao.Platform.Windows.Gdi.DM_PELSHEIGHT"/></term>
  3510. <description>
  3511. Use the <see cref="F:Tao.Platform.Windows.Gdi.DEVMODE.dmPelsHeight"/> value.
  3512. </description>
  3513. </item>
  3514. <item>
  3515. <term><see cref="F:Tao.Platform.Windows.Gdi.DM_DISPLAYFLAGS"/></term>
  3516. <description>
  3517. Use the <see cref="F:Tao.Platform.Windows.Gdi.DEVMODE.dmDisplayFlags"/> value.
  3518. </description>
  3519. </item>
  3520. <item>
  3521. <term><see cref="F:Tao.Platform.Windows.Gdi.DM_DISPLAYFREQUENCY"/></term>
  3522. <description>
  3523. Use the <see cref="F:Tao.Platform.Windows.Gdi.DEVMODE.dmDisplayFrequency"/> value.
  3524. </description>
  3525. </item>
  3526. <item>
  3527. <term>see cref="Gdi.DM_POSITION" /&gt;</term>
  3528. <description>
  3529. <b>Windows 98/Me, Windows 2000/XP:</b> Use the dmPosition value.
  3530. </description>
  3531. </item>
  3532. </list>
  3533. </para>
  3534. </param>
  3535. <param name="flags">
  3536. <para>
  3537. Indicates how the graphics mode should be changed. This parameter can be one
  3538. of the following values:
  3539. </para>
  3540. <para>
  3541. <list type="table">
  3542. <listheader>
  3543. <term>Value</term>
  3544. <description>Description</description>
  3545. </listheader>
  3546. <item>
  3547. <term>0</term>
  3548. <description>
  3549. The graphics mode for the current screen will be changed
  3550. dynamically.
  3551. </description>
  3552. </item>
  3553. <item>
  3554. <term>see cref="Gdi.CDS_FULLSCREEN" </term>
  3555. <description>
  3556. <para>
  3557. The mode is temporary in nature.
  3558. </para>
  3559. <para>
  3560. <b>Windows NT/2000/XP:</b> If you change to and from another
  3561. desktop, this mode will not be reset.
  3562. </para>
  3563. </description>
  3564. </item>
  3565. <item>
  3566. <term>see cref="Gdi.CDS_GLOBAL" </term>
  3567. <description>
  3568. The settings will be saved in the global settings area so that
  3569. they will affect all users on the machine. Otherwise, only the
  3570. settings for the user are modified. This flag is only valid when
  3571. specified with the see cref="Gdi.CDS_UPDATEREGISTRY" flag.
  3572. </description>
  3573. </item>
  3574. <item>
  3575. <term>see cref="Gdi.CDS_NORESET" </term>
  3576. <description>
  3577. The settings will be saved in the registry, but will not take
  3578. affect. This flag is only valid when specified with the
  3579. see cref="Gdi.CDS_UPDATEREGISTRY" flag.
  3580. </description>
  3581. </item>
  3582. <item>
  3583. <term>see cref="Gdi.CDS_RESET" </term>
  3584. <description>
  3585. The settings should be changed, even if the requested settings are
  3586. the same as the current settings.
  3587. </description>
  3588. </item>
  3589. <item>
  3590. <term>see cref="Gdi.CDS_SET_PRIMARY" </term>
  3591. <description>
  3592. This device will become the primary device.
  3593. </description>
  3594. </item>
  3595. <item>
  3596. <term>see cref="Gdi.CDS_TEST" /&gt;</term>
  3597. <description>
  3598. The system tests if the requested graphics mode could be set.
  3599. </description>
  3600. </item>
  3601. <item>
  3602. <term>see cref="Gdi.CDS_UPDATEREGISTRY" /&gt;</term>
  3603. <description>
  3604. The graphics mode for the current screen will be changed
  3605. dynamically and the graphics mode will be updated in the registry.
  3606. The mode information is stored in the USER profile.
  3607. </description>
  3608. </item>
  3609. </list>
  3610. </para>
  3611. <para>
  3612. Specifying see cref="Gdi.CDS_TEST" /&gt; allows an application to determine
  3613. which graphics modes are actually valid, without causing the system to
  3614. change to that graphics mode.
  3615. </para>
  3616. <para>
  3617. If see cref="Gdi.CDS_UPDATEREGISTRY" /&gt; is specified and it is possible to
  3618. change the graphics mode dynamically, the information is stored in the
  3619. registry and see cref="Gdi.DISP_CHANGE_SUCCESSFUL" /&gt; is returned. If it is
  3620. not possible to change the graphics mode dynamically, the information is
  3621. stored in the registry and see cref="Gdi.DISP_CHANGE_RESTART" /&gt; is returned.
  3622. </para>
  3623. <para>
  3624. <b>Windows NT/2000/XP:</b> If see cref="Gdi.CDS_UPDATEREGISTRY" /&gt; is
  3625. specified and the information could not be stored in the registry, the
  3626. graphics mode is not changed and see cref="Gdi.DISP_CHANGE_NOTUPDATED" /&gt; is
  3627. returned.
  3628. </para>
  3629. </param>
  3630. <returns>
  3631. <para>
  3632. The <b>ChangeDisplaySettings</b> function returns one of the following values:
  3633. </para>
  3634. <para>
  3635. <list type="table">
  3636. <listheader>
  3637. <term>Value</term>
  3638. <description>Description</description>
  3639. </listheader>
  3640. <item>
  3641. <term>see cref="Gdi.DISP_CHANGE_SUCCESSFUL" /&gt;</term>
  3642. <description>
  3643. The settings change was successful.
  3644. </description>
  3645. </item>
  3646. <item>
  3647. <term>see cref="Gdi.DISP_CHANGE_BADDUALVIEW" /&gt;</term>
  3648. <description>
  3649. <b>Windows XP:</b> The settings change was unsuccessful because
  3650. system is DualView capable.
  3651. </description>
  3652. </item>
  3653. <item>
  3654. <term>see cref="Gdi.DISP_CHANGE_BADFLAGS" /&gt;</term>
  3655. <description>
  3656. An invalid set of flags was passed in.
  3657. </description>
  3658. </item>
  3659. <item>
  3660. <term>see cref="Gdi.DISP_CHANGE_BADMODE" </term>
  3661. <description>
  3662. The graphics mode is not supported.
  3663. </description>
  3664. </item>
  3665. <item>
  3666. <term>see cref="Gdi.DISP_CHANGE_BADPARAM" </term>
  3667. <description>
  3668. An invalid parameter was passed in. This can include an invalid
  3669. flag or combination of flags.
  3670. </description>
  3671. </item>
  3672. <item>
  3673. <term>see cref="Gdi.DISP_CHANGE_FAILED" /&gt;</term>
  3674. <description>
  3675. The display driver failed the specified graphics mode.
  3676. </description>
  3677. </item>
  3678. <item>
  3679. <term>see cref="Gdi.DISP_CHANGE_NOTUPDATED" /&gt;</term>
  3680. <description>
  3681. <b>Windows NT/2000/XP:</b> Unable to write settings to the
  3682. registry.
  3683. </description>
  3684. </item>
  3685. <item>
  3686. <term>see cref="Gdi.DISP_CHANGE_RESTART" /&gt;</term>
  3687. <description>
  3688. The computer must be restarted in order for the graphics mode to
  3689. work.
  3690. </description>
  3691. </item>
  3692. </list>
  3693. </para>
  3694. </returns>
  3695. <remarks>
  3696. <para>
  3697. To ensure that the <see cref="T:Tao.Platform.Windows.Gdi.DEVMODE"/> structure passed to
  3698. <b>ChangeDisplaySettings</b> is valid and contains only values supported by
  3699. the display driver, use the <see cref="T:Tao.Platform.Windows.Gdi.DEVMODE"/> returned by the
  3700. <see cref="M:Tao.Platform.Windows.User.EnumDisplaySettings(System.String,System.Int32,Tao.Platform.Windows.Gdi.DEVMODE@)"/> function.
  3701. </para>
  3702. <para>
  3703. When the display mode is changed dynamically, the <b>WM_DISPLAYCHANGE</b>
  3704. message is sent to all running applications with the following message
  3705. parameters:
  3706. </para>
  3707. <para>
  3708. <list type="table">
  3709. <listheader>
  3710. <term>Value</term>
  3711. <description>Description</description>
  3712. </listheader>
  3713. <item>
  3714. <term>wParam</term>
  3715. <description>New bits per pixel.</description>
  3716. </item>
  3717. <item>
  3718. <term>LOWORD(lParam)</term>
  3719. <description>New pixel width.</description>
  3720. </item>
  3721. <item>
  3722. <term>HIWORD(lParam)</term>
  3723. <description>New pixel height.</description>
  3724. </item>
  3725. </list>
  3726. </para>
  3727. <para>
  3728. <b>Windows 95/98/Me:</b> If the calling thread has any windows,
  3729. <b>ChangeDisplaySettings</b> sends them the <b>WM_DISPLAYCHANGE</b> message
  3730. immediately (for windows in all other threads, the message is sent when the
  3731. thread can receive nonqueued messages). This may cause the shell to get its
  3732. message too soon and could squash icons. To avoid this problem, have
  3733. <b>ChangeDisplaySettings</b> do resolution switching by calling on a thread
  3734. with no windows, for example, a new thread.
  3735. </para>
  3736. </remarks>
  3737. seealso cref="CreateDC" /&gt;
  3738. <seealso cref="T:Tao.Platform.Windows.Gdi.DEVMODE"/>
  3739. <seealso cref="M:Tao.Platform.Windows.User.EnumDisplaySettings(System.String,System.Int32,Tao.Platform.Windows.Gdi.DEVMODE@)"/>
  3740. </member>
  3741. <member name="M:Tao.Platform.Windows.User.EnumDisplaySettings(System.String,System.Int32,Tao.Platform.Windows.Gdi.DEVMODE@)">
  3742. <summary>
  3743. </summary>
  3744. <param name="deviceName"></param>
  3745. <param name="modeNumber"></param>
  3746. <param name="devMode"></param>
  3747. <returns></returns>
  3748. </member>
  3749. <member name="M:Tao.Platform.Windows.User.GetDC(System.IntPtr)">
  3750. <summary>
  3751. <para>
  3752. The <b>GetDC</b> function retrieves a handle to a display device context (DC)
  3753. for the client area of a specified window or for the entire screen. You can
  3754. use the returned handle in subsequent GDI functions to draw in the DC.
  3755. </para>
  3756. <para>
  3757. The see cref="GetDCEx" /&gt; function is an extension to <b>GetDC</b>, which
  3758. gives an application more control over how and whether clipping occurs in the
  3759. client area.
  3760. </para>
  3761. </summary>
  3762. <param name="windowHandle">
  3763. <para>
  3764. Handle to the window whose DC is to be retrieved. If this value is null,
  3765. <b>GetDC</b> retrieves the DC for the entire screen.
  3766. </para>
  3767. <para>
  3768. <b>Windows 98/Me, Windows 2000/XP:</b> To get the DC for a specific display
  3769. monitor, use the see cref="EnumDisplayMonitors" /&gt; and
  3770. see cref="Gdi.CreateDC" /&gt; functions.
  3771. </para>
  3772. </param>
  3773. <returns>
  3774. <para>
  3775. If the function succeeds, the return value is a handle to the DC for the
  3776. specified window's client area.
  3777. </para>
  3778. <para>
  3779. If the function fails, the return value is null.
  3780. </para>
  3781. <para>
  3782. <b>Windows NT/2000/XP:</b> To get extended error information, call
  3783. <see cref="M:System.Runtime.InteropServices.Marshal.GetLastWin32Error"/>.
  3784. </para>
  3785. </returns>
  3786. <remarks>
  3787. <para>
  3788. The <b>GetDC</b> function retrieves a common, class, or private DC depending
  3789. on the class style of the specified window. For class and private DCs,
  3790. <b>GetDC</b> leaves the previously assigned attributes unchanged. However,
  3791. for common DCs, <b>GetDC</b> assigns default attributes to the DC each time
  3792. it is retrieved. For example, the default font is System, which is a bitmap
  3793. font. Because of this, the handle for a common DC returned by <b>GetDC</b>
  3794. does not tell you what font, color, or brush was used when the window was
  3795. drawn. To determine the font, call see cref="GetTextFace" /&gt;.
  3796. </para>
  3797. <para>
  3798. Note that the handle to the DC can only be used by a single thread at any one
  3799. time.
  3800. </para>
  3801. <para>
  3802. After painting with a common DC, the <see cref="M:Tao.Platform.Windows.User.ReleaseDC(System.IntPtr,System.IntPtr)"/> function must
  3803. be called to release the DC. Class and private DCs do not have to be
  3804. released. <see cref="M:Tao.Platform.Windows.User.ReleaseDC(System.IntPtr,System.IntPtr)"/> must be called from the same thread that
  3805. called <b>GetDC</b>. The number of DCs is limited only by available memory.
  3806. </para>
  3807. <para>
  3808. <b>Windows 95/98/Me:</b> There are only 5 common DCs available per thread,
  3809. thus failure to release a DC can prevent other applications from accessing
  3810. one.
  3811. </para>
  3812. </remarks>
  3813. seealso cref="GetDCEx" /&gt;
  3814. <seealso cref="M:Tao.Platform.Windows.User.ReleaseDC(System.IntPtr,System.IntPtr)"/>
  3815. seealso cref="GetTextFace" /&gt;
  3816. seealso cref="GetWindowDC" /&gt;
  3817. </member>
  3818. <member name="M:Tao.Platform.Windows.User.ReleaseDC(System.IntPtr,System.IntPtr)">
  3819. <summary>
  3820. <para>
  3821. The <b>ReleaseDC</b> function releases a device context (DC), freeing it for
  3822. use by other applications. The effect of the <b>ReleaseDC</b> function
  3823. depends on the type of DC. It frees only common and window DCs. It has no
  3824. effect on class or private DCs.
  3825. </para>
  3826. </summary>
  3827. <param name="windowHandle">
  3828. <para>
  3829. Handle to the window whose DC is to be released.
  3830. </para>
  3831. </param>
  3832. <param name="deviceContext">
  3833. <para>
  3834. Handle to the DC to be released.
  3835. </para>
  3836. </param>
  3837. <returns>
  3838. <para>
  3839. The return value indicates whether the DC was released. If the DC was
  3840. released, the return value is true.
  3841. </para>
  3842. <para>
  3843. If the DC was not released, the return value is false.
  3844. </para>
  3845. </returns>
  3846. <remarks>
  3847. <para>
  3848. The application must call the <b>ReleaseDC</b> function for each call to the
  3849. see cref="GetWindowDC" /&gt; function and for each call to the
  3850. <see cref="M:Tao.Platform.Windows.User.GetDC(System.IntPtr)"/> function that retrieves a common DC.
  3851. </para>
  3852. <para>
  3853. An application cannot use the <b>ReleaseDC</b> function to release a DC that
  3854. was created by calling the see cref="Gdi.CreateDC" /&gt; function; instead, it
  3855. must use the see cref="Gdi.DeleteDC" /&gt; function. <b>ReleaseDC</b> must be
  3856. called from the same thread that called <b>GetDC</b>.
  3857. </para>
  3858. </remarks>
  3859. seealso cref="Gdi.CreateDC" /&gt;
  3860. seealso cref="Gdi.DeleteDC" /&gt;
  3861. <seealso cref="M:Tao.Platform.Windows.User.GetDC(System.IntPtr)"/>
  3862. seealso cref="GetWindowDC" /&gt;
  3863. </member>
  3864. <member name="M:Tao.Platform.Windows.User.SetParent(System.IntPtr,System.IntPtr)">
  3865. <summary>
  3866. </summary>
  3867. <param name="hWndChild"></param>
  3868. <param name="hWndNewParent"></param>
  3869. <returns></returns>
  3870. </member>
  3871. <member name="M:Tao.Platform.Windows.User.FindWindow(System.String,System.String)">
  3872. <summary>
  3873. </summary>
  3874. <param name="lpClassName"></param>
  3875. <param name="lpWindowName"></param>
  3876. <returns></returns>
  3877. </member>
  3878. <member name="M:Tao.Platform.Windows.User.ShowWindow(System.IntPtr,System.Int32)">
  3879. <summary>
  3880. </summary>
  3881. <param name="hWnd"></param>
  3882. <param name="nCmdShow"></param>
  3883. <returns></returns>
  3884. </member>
  3885. <member name="M:Tao.Platform.Windows.User.SetWindowPos(System.IntPtr,System.IntPtr,System.Int32,System.Int32,System.Int32,System.Int32,System.UInt32)">
  3886. <summary>
  3887. </summary>
  3888. <param name="hWnd"></param>
  3889. <param name="hWndInsertAfter"></param>
  3890. <param name="X"></param>
  3891. <param name="Y"></param>
  3892. <param name="cx"></param>
  3893. <param name="cy"></param>
  3894. <param name="uFlags"></param>
  3895. <returns></returns>
  3896. </member>
  3897. <member name="T:Tao.Platform.Windows.User.SHOWWINDOW">
  3898. <summary>
  3899. </summary>
  3900. </member>
  3901. <member name="F:Tao.Platform.Windows.User.SHOWWINDOW.SW_HIDE">
  3902. <summary>
  3903. </summary>
  3904. </member>
  3905. <member name="F:Tao.Platform.Windows.User.SHOWWINDOW.SW_SHOWNORMAL">
  3906. <summary>
  3907. </summary>
  3908. </member>
  3909. <member name="F:Tao.Platform.Windows.User.SHOWWINDOW.SW_NORMAL">
  3910. <summary>
  3911. </summary>
  3912. </member>
  3913. <member name="F:Tao.Platform.Windows.User.SHOWWINDOW.SW_SHOWMINIMIZED">
  3914. <summary>
  3915. </summary>
  3916. </member>
  3917. <member name="F:Tao.Platform.Windows.User.SHOWWINDOW.SW_SHOWMAXIMIZED">
  3918. <summary>
  3919. </summary>
  3920. </member>
  3921. <member name="F:Tao.Platform.Windows.User.SHOWWINDOW.SW_MAXIMIZE">
  3922. <summary>
  3923. </summary>
  3924. </member>
  3925. <member name="F:Tao.Platform.Windows.User.SHOWWINDOW.SW_SHOWNOACTIVATE">
  3926. <summary>
  3927. </summary>
  3928. </member>
  3929. <member name="F:Tao.Platform.Windows.User.SHOWWINDOW.SW_SHOW">
  3930. <summary>
  3931. </summary>
  3932. </member>
  3933. <member name="F:Tao.Platform.Windows.User.SHOWWINDOW.SW_MINIMIZE">
  3934. <summary>
  3935. </summary>
  3936. </member>
  3937. <member name="F:Tao.Platform.Windows.User.SHOWWINDOW.SW_SHOWMINNOACTIVE">
  3938. <summary>
  3939. </summary>
  3940. </member>
  3941. <member name="F:Tao.Platform.Windows.User.SHOWWINDOW.SW_SHOWNA">
  3942. <summary>
  3943. </summary>
  3944. </member>
  3945. <member name="F:Tao.Platform.Windows.User.SHOWWINDOW.SW_RESTORE">
  3946. <summary>
  3947. </summary>
  3948. </member>
  3949. <member name="F:Tao.Platform.Windows.User.SHOWWINDOW.SW_SHOWDEFAULT">
  3950. <summary>
  3951. </summary>
  3952. </member>
  3953. <member name="F:Tao.Platform.Windows.User.SHOWWINDOW.SW_FORCEMINIMIZE">
  3954. <summary>
  3955. </summary>
  3956. </member>
  3957. <member name="F:Tao.Platform.Windows.User.SHOWWINDOW.SW_MAX">
  3958. <summary>
  3959. </summary>
  3960. </member>
  3961. <member name="T:Tao.Platform.Windows.SimpleOpenGlControl">
  3962. <summary>
  3963. Provides a simple OpenGL control allowing quick development of Windows Forms-based
  3964. OpenGL applications.
  3965. </summary>
  3966. </member>
  3967. <member name="M:Tao.Platform.Windows.SimpleOpenGlControl.#ctor">
  3968. <summary>
  3969. Constructor. Creates contexts and sets properties.
  3970. </summary>
  3971. </member>
  3972. <member name="M:Tao.Platform.Windows.SimpleOpenGlControl.Dispose(System.Boolean)">
  3973. <summary>
  3974. Disposes the control.
  3975. </summary>
  3976. <param name="disposing">Was the disposed manually called?</param>
  3977. </member>
  3978. <member name="M:Tao.Platform.Windows.SimpleOpenGlControl.InitializeBackground">
  3979. <summary>
  3980. Loads the bitmap from the assembly's manifest resource.
  3981. </summary>
  3982. </member>
  3983. <member name="M:Tao.Platform.Windows.SimpleOpenGlControl.InitializeComponent">
  3984. <summary>
  3985. Required for designer support.
  3986. </summary>
  3987. </member>
  3988. <member name="M:Tao.Platform.Windows.SimpleOpenGlControl.InitializeStyles">
  3989. <summary>
  3990. Initializes the control's styles.
  3991. </summary>
  3992. </member>
  3993. <member name="M:Tao.Platform.Windows.SimpleOpenGlControl.DestroyContexts">
  3994. <summary>
  3995. </summary>
  3996. </member>
  3997. <member name="M:Tao.Platform.Windows.SimpleOpenGlControl.Draw">
  3998. <summary>
  3999. Sends an see cref="UserControl.Invalidate" command to this control, thus
  4000. forcing a redraw to occur.
  4001. </summary>
  4002. </member>
  4003. <member name="M:Tao.Platform.Windows.SimpleOpenGlControl.InitializeContexts">
  4004. <summary>
  4005. Creates the OpenGL contexts.
  4006. </summary>
  4007. </member>
  4008. <member name="M:Tao.Platform.Windows.SimpleOpenGlControl.MakeCurrent">
  4009. <summary>
  4010. </summary>
  4011. </member>
  4012. <member name="M:Tao.Platform.Windows.SimpleOpenGlControl.SwapBuffers">
  4013. <summary>
  4014. </summary>
  4015. </member>
  4016. <member name="M:Tao.Platform.Windows.SimpleOpenGlControl.OnPaint(System.Windows.Forms.PaintEventArgs)">
  4017. <summary>
  4018. Paints the control.
  4019. </summary>
  4020. <param name="e">The paint event arguments.</param>
  4021. </member>
  4022. <member name="M:Tao.Platform.Windows.SimpleOpenGlControl.OnPaintBackground(System.Windows.Forms.PaintEventArgs)">
  4023. <summary>
  4024. Paints the background.
  4025. </summary>
  4026. <param name="e"></param>
  4027. </member>
  4028. <member name="P:Tao.Platform.Windows.SimpleOpenGlControl.LogScaleX">
  4029. <summary>
  4030. Gets the number of logical pixels or dots per inch (dpi) in X-direction
  4031. </summary>
  4032. </member>
  4033. <member name="P:Tao.Platform.Windows.SimpleOpenGlControl.LogScaleY">
  4034. <summary>
  4035. Gets the number of logical pixels or dots per inch (dpi) in Y-direction
  4036. </summary>
  4037. </member>
  4038. <member name="P:Tao.Platform.Windows.SimpleOpenGlControl.AccumBits">
  4039. <summary>
  4040. Gets and sets the OpenGL control's accumulation buffer depth.
  4041. </summary>
  4042. </member>
  4043. <member name="P:Tao.Platform.Windows.SimpleOpenGlControl.ColorBits">
  4044. <summary>
  4045. Gets and sets the OpenGL control's color buffer depth.
  4046. </summary>
  4047. </member>
  4048. <member name="P:Tao.Platform.Windows.SimpleOpenGlControl.DepthBits">
  4049. <summary>
  4050. Gets and sets the OpenGL control's depth buffer (Z-buffer) depth.
  4051. </summary>
  4052. </member>
  4053. <member name="P:Tao.Platform.Windows.SimpleOpenGlControl.StencilBits">
  4054. <summary>
  4055. Gets and sets the OpenGL control's stencil buffer depth.
  4056. </summary>
  4057. </member>
  4058. <member name="P:Tao.Platform.Windows.SimpleOpenGlControl.AutoCheckErrors">
  4059. <summary>
  4060. Gets and sets the OpenGL control's automatic sending of a glGetError command
  4061. after drawing.
  4062. </summary>
  4063. </member>
  4064. <member name="P:Tao.Platform.Windows.SimpleOpenGlControl.AutoFinish">
  4065. <summary>
  4066. Gets and sets the OpenGL control's automatic sending of a glFinish command
  4067. after drawing.
  4068. </summary>
  4069. </member>
  4070. <member name="P:Tao.Platform.Windows.SimpleOpenGlControl.AutoMakeCurrent">
  4071. <summary>
  4072. Gets and sets the OpenGL control's automatic forcing of the rendering context to
  4073. be current before drawing.
  4074. </summary>
  4075. </member>
  4076. <member name="P:Tao.Platform.Windows.SimpleOpenGlControl.AutoSwapBuffers">
  4077. <summary>
  4078. Gets and sets the OpenGL control's automatic sending of a SwapBuffers command
  4079. after drawing.
  4080. </summary>
  4081. </member>
  4082. <member name="P:Tao.Platform.Windows.SimpleOpenGlControl.CreateParams">
  4083. <summary>
  4084. Overrides the control's class style parameters.
  4085. </summary>
  4086. </member>
  4087. <member name="T:Tao.Platform.Windows.Gdi">
  4088. <summary>
  4089. GDI binding for .NET, implementing Windows-specific GDI functionality.
  4090. </summary>
  4091. <remarks>
  4092. Binds functions and definitions in gdi32.dll.
  4093. </remarks>
  4094. </member>
  4095. <member name="F:Tao.Platform.Windows.Gdi.GDI_NATIVE_LIBRARY">
  4096. <summary>
  4097. Specifies GDI's native library archive.
  4098. </summary>
  4099. <remarks>
  4100. Specifies gdi32.dll for Windows.
  4101. </remarks>
  4102. </member>
  4103. <member name="F:Tao.Platform.Windows.Gdi.CALLING_CONVENTION">
  4104. <summary>
  4105. Specifies the calling convention.
  4106. </summary>
  4107. <remarks>
  4108. Specifies <see cref="F:System.Runtime.InteropServices.CallingConvention.StdCall"/>.
  4109. </remarks>
  4110. </member>
  4111. <member name="F:Tao.Platform.Windows.Gdi.LPD_TYPE_RGBA">
  4112. <summary>
  4113. RGBA pixels. Each pixel has four components: red, green, blue, and alpha.
  4114. </summary>
  4115. </member>
  4116. <member name="F:Tao.Platform.Windows.Gdi.LPD_TYPE_COLORINDEX">
  4117. <summary>
  4118. Color-index pixels. Each pixel uses a color-index value.
  4119. </summary>
  4120. </member>
  4121. <member name="F:Tao.Platform.Windows.Gdi.LPD_DOUBLEBUFFER">
  4122. <summary>
  4123. The layer plane is double-buffered. A layer plane can be double-buffered
  4124. even when the main plane is single-buffered and vice versa.
  4125. </summary>
  4126. </member>
  4127. <member name="F:Tao.Platform.Windows.Gdi.LPD_STEREO">
  4128. <summary>
  4129. The layer plane is stereoscopic. A layer plane can be stereoscopic even
  4130. when the main plane is monoscopic and vice versa.
  4131. </summary>
  4132. </member>
  4133. <member name="F:Tao.Platform.Windows.Gdi.LPD_SUPPORT_GDI">
  4134. <summary>
  4135. The layer plane supports GDI drawing. The current implementation of OpenGL
  4136. doesn't support this flag.
  4137. </summary>
  4138. </member>
  4139. <member name="F:Tao.Platform.Windows.Gdi.LPD_SUPPORT_OPENGL">
  4140. <summary>
  4141. The layer plane supports OpenGL drawing.
  4142. </summary>
  4143. </member>
  4144. <member name="F:Tao.Platform.Windows.Gdi.LPD_SHARE_DEPTH">
  4145. <summary>
  4146. The layer plane shares the depth buffer with the main plane.
  4147. </summary>
  4148. </member>
  4149. <member name="F:Tao.Platform.Windows.Gdi.LPD_SHARE_STENCIL">
  4150. <summary>
  4151. The layer plane shares the stencil buffer with the main plane.
  4152. </summary>
  4153. </member>
  4154. <member name="F:Tao.Platform.Windows.Gdi.LPD_SHARE_ACCUM">
  4155. <summary>
  4156. The layer plane shares the accumulation buffer with the main plane.
  4157. </summary>
  4158. </member>
  4159. <member name="F:Tao.Platform.Windows.Gdi.LPD_SWAP_EXCHANGE">
  4160. <summary>
  4161. In a double-buffered layer plane, swapping the color buffer exchanges the
  4162. front buffer and back buffer contents. The back buffer then contains the
  4163. contents of the front buffer before the swap. This flag is a hint only and
  4164. might not be provided by a driver.
  4165. </summary>
  4166. </member>
  4167. <member name="F:Tao.Platform.Windows.Gdi.LPD_SWAP_COPY">
  4168. <summary>
  4169. In a double-buffered layer plane, swapping the color buffer copies the back
  4170. buffer contents to the front buffer. The swap does not affect the back
  4171. buffer contents. This flag is a hint only and might not be provided by a driver.
  4172. </summary>
  4173. </member>
  4174. <member name="F:Tao.Platform.Windows.Gdi.LPD_TRANSPARENT">
  4175. <summary>
  4176. Contains a transparent color or index value that enables underlying layers
  4177. to show through this layer. All layer planes, except the lowest-numbered
  4178. underlay layer, have a transparent color or index.
  4179. </summary>
  4180. </member>
  4181. <member name="F:Tao.Platform.Windows.Gdi.PFD_TYPE_RGBA">
  4182. <summary>
  4183. RGBA pixels. Each pixel has four components in this order: red, green, blue,
  4184. and alpha.
  4185. </summary>
  4186. </member>
  4187. <member name="F:Tao.Platform.Windows.Gdi.PFD_TYPE_COLORINDEX">
  4188. <summary>
  4189. Color-index pixels. Each pixel uses a color-index value.
  4190. </summary>
  4191. </member>
  4192. <member name="F:Tao.Platform.Windows.Gdi.PFD_MAIN_PLANE">
  4193. <summary>
  4194. The layer is the main plane.
  4195. </summary>
  4196. </member>
  4197. <member name="F:Tao.Platform.Windows.Gdi.PFD_OVERLAY_PLANE">
  4198. <summary>
  4199. The layer is the overlay plane.
  4200. </summary>
  4201. </member>
  4202. <member name="F:Tao.Platform.Windows.Gdi.PFD_UNDERLAY_PLANE">
  4203. <summary>
  4204. The layer is the underlay plane.
  4205. </summary>
  4206. </member>
  4207. <member name="F:Tao.Platform.Windows.Gdi.PFD_DOUBLEBUFFER">
  4208. <summary>
  4209. <para>
  4210. The buffer is double-buffered. This flag and <see cref="F:Tao.Platform.Windows.Gdi.PFD_SUPPORT_GDI"/>
  4211. are mutually exclusive in the current generic implementation.
  4212. </para>
  4213. </summary>
  4214. </member>
  4215. <member name="F:Tao.Platform.Windows.Gdi.PFD_STEREO">
  4216. <summary>
  4217. <para>
  4218. The buffer is stereoscopic. This flag is not supported in the current
  4219. generic implementation.
  4220. </para>
  4221. </summary>
  4222. </member>
  4223. <member name="F:Tao.Platform.Windows.Gdi.PFD_DRAW_TO_WINDOW">
  4224. <summary>
  4225. <para>
  4226. The buffer can draw to a window or device surface.
  4227. </para>
  4228. </summary>
  4229. </member>
  4230. <member name="F:Tao.Platform.Windows.Gdi.PFD_DRAW_TO_BITMAP">
  4231. <summary>
  4232. <para>
  4233. The buffer can draw to a memory bitmap.
  4234. </para>
  4235. </summary>
  4236. </member>
  4237. <member name="F:Tao.Platform.Windows.Gdi.PFD_SUPPORT_GDI">
  4238. <summary>
  4239. <para>
  4240. The buffer supports GDI drawing. This flag and
  4241. <see cref="F:Tao.Platform.Windows.Gdi.PFD_DOUBLEBUFFER"/> are mutually exclusive in the current generic
  4242. implementation.
  4243. </para>
  4244. </summary>
  4245. </member>
  4246. <member name="F:Tao.Platform.Windows.Gdi.PFD_SUPPORT_OPENGL">
  4247. <summary>
  4248. <para>
  4249. The buffer supports OpenGL drawing.
  4250. </para>
  4251. </summary>
  4252. </member>
  4253. <member name="F:Tao.Platform.Windows.Gdi.PFD_GENERIC_FORMAT">
  4254. <summary>
  4255. <para>
  4256. The pixel format is supported by the GDI software implementation, which is
  4257. also known as the generic implementation. If this bit is clear, the pixel
  4258. format is supported by a device driver or hardware.
  4259. </para>
  4260. </summary>
  4261. </member>
  4262. <member name="F:Tao.Platform.Windows.Gdi.PFD_NEED_PALETTE">
  4263. <summary>
  4264. <para>
  4265. The buffer uses RGBA pixels on a palette-managed device. A logical palette
  4266. is required to achieve the best results for this pixel type. Colors in the
  4267. palette should be specified according to the values of the <b>cRedBits</b>,
  4268. <b>cRedShift</b>, <b>cGreenBits</b>, <b>cGreenShift</b>, <b>cBluebits</b>,
  4269. and <b>cBlueShift</b> members. The palette should be created and realized in
  4270. the device context before calling <see cref="M:Tao.Platform.Windows.Wgl.wglMakeCurrent(System.IntPtr,System.IntPtr)"/>.
  4271. </para>
  4272. </summary>
  4273. </member>
  4274. <member name="F:Tao.Platform.Windows.Gdi.PFD_NEED_SYSTEM_PALETTE">
  4275. <summary>
  4276. <para>
  4277. Defined in the pixel format descriptors of hardware that supports one
  4278. hardware palette in 256-color mode only. For such systems to use
  4279. hardware acceleration, the hardware palette must be in a fixed order
  4280. (for example, 3-3-2) when in RGBA mode or must match the logical palette
  4281. when in color-index mode.
  4282. </para>
  4283. <para>
  4284. When this flag is set, you must call see cref="SetSystemPaletteUse" /> in
  4285. your program to force a one-to-one mapping of the logical palette and the
  4286. system palette. If your OpenGL hardware supports multiple hardware palettes
  4287. and the device driver can allocate spare hardware palettes for OpenGL, this
  4288. flag is typically clear.
  4289. </para>
  4290. <para>
  4291. This flag is not set in the generic pixel formats.
  4292. </para>
  4293. </summary>
  4294. </member>
  4295. <member name="F:Tao.Platform.Windows.Gdi.PFD_SWAP_EXCHANGE">
  4296. <summary>
  4297. <para>
  4298. Specifies the content of the back buffer in the double-buffered main color
  4299. plane following a buffer swap. Swapping the color buffers causes the
  4300. exchange of the back buffer's content with the front buffer's content.
  4301. Following the swap, the back buffer's content contains the front buffer's
  4302. content before the swap. <b>PFD_SWAP_EXCHANGE</b> is a hint only and might
  4303. not be provided by a driver.
  4304. </para>
  4305. </summary>
  4306. </member>
  4307. <member name="F:Tao.Platform.Windows.Gdi.PFD_SWAP_COPY">
  4308. <summary>
  4309. <para>
  4310. Specifies the content of the back buffer in the double-buffered main color
  4311. plane following a buffer swap. Swapping the color buffers causes the content
  4312. of the back buffer to be copied to the front buffer. The content of the back
  4313. buffer is not affected by the swap. <b>PFD_SWAP_COPY</b> is a hint only and
  4314. might not be provided by a driver.
  4315. </para>
  4316. </summary>
  4317. </member>
  4318. <member name="F:Tao.Platform.Windows.Gdi.PFD_SWAP_LAYER_BUFFERS">
  4319. <summary>
  4320. <para>
  4321. Indicates whether a device can swap individual layer planes with pixel
  4322. formats that include double-buffered overlay or underlay planes.
  4323. Otherwise all layer planes are swapped together as a group. When this
  4324. flag is set, <see cref="M:Tao.Platform.Windows.Wgl.wglSwapLayerBuffers(System.IntPtr,System.Int32)"/> is supported.
  4325. </para>
  4326. </summary>
  4327. </member>
  4328. <member name="F:Tao.Platform.Windows.Gdi.PFD_GENERIC_ACCELERATED">
  4329. <summary>
  4330. <para>
  4331. The pixel format is supported by a device driver that accelerates the generic
  4332. implementation. If this flag is clear and the
  4333. <see cref="F:Tao.Platform.Windows.Gdi.PFD_GENERIC_FORMAT"/> flag is set, the pixel format is supported
  4334. by the generic implementation only.
  4335. </para>
  4336. </summary>
  4337. </member>
  4338. <member name="F:Tao.Platform.Windows.Gdi.PFD_SUPPORT_DIRECTDRAW">
  4339. <summary>
  4340. <para>
  4341. The buffer supports DirectDraw drawing.
  4342. </para>
  4343. </summary>
  4344. </member>
  4345. <member name="F:Tao.Platform.Windows.Gdi.PFD_DEPTH_DONTCARE">
  4346. <summary>
  4347. <para>
  4348. The requested pixel format can either have or not have a depth buffer. To
  4349. select a pixel format without a depth buffer, you must specify this flag.
  4350. The requested pixel format can be with or without a depth buffer. Otherwise,
  4351. only pixel formats with a depth buffer are considered.
  4352. </para>
  4353. </summary>
  4354. </member>
  4355. <member name="F:Tao.Platform.Windows.Gdi.PFD_DOUBLEBUFFER_DONTCARE">
  4356. <summary>
  4357. <para>
  4358. The requested pixel format can be either single- or double-buffered.
  4359. </para>
  4360. </summary>
  4361. </member>
  4362. <member name="F:Tao.Platform.Windows.Gdi.PFD_STEREO_DONTCARE">
  4363. <summary>
  4364. <para>
  4365. The requested pixel format can be either monoscopic or stereoscopic.
  4366. </para>
  4367. </summary>
  4368. </member>
  4369. <member name="F:Tao.Platform.Windows.Gdi.DM_BITSPERPEL">
  4370. <summary>
  4371. </summary>
  4372. </member>
  4373. <member name="F:Tao.Platform.Windows.Gdi.DM_PELSWIDTH">
  4374. <summary>
  4375. </summary>
  4376. </member>
  4377. <member name="F:Tao.Platform.Windows.Gdi.DM_PELSHEIGHT">
  4378. <summary>
  4379. </summary>
  4380. </member>
  4381. <member name="F:Tao.Platform.Windows.Gdi.DM_DISPLAYFLAGS">
  4382. <summary>
  4383. </summary>
  4384. </member>
  4385. <member name="F:Tao.Platform.Windows.Gdi.DM_DISPLAYFREQUENCY">
  4386. <summary>
  4387. </summary>
  4388. </member>
  4389. <member name="F:Tao.Platform.Windows.Gdi.OUT_TT_PRECIS">
  4390. <summary>
  4391. </summary>
  4392. </member>
  4393. <member name="F:Tao.Platform.Windows.Gdi.CLIP_DEFAULT_PRECIS">
  4394. <summary>
  4395. </summary>
  4396. </member>
  4397. <member name="F:Tao.Platform.Windows.Gdi.DEFAULT_QUALITY">
  4398. <summary>
  4399. </summary>
  4400. </member>
  4401. <member name="F:Tao.Platform.Windows.Gdi.DRAFT_QUALITY">
  4402. <summary>
  4403. </summary>
  4404. </member>
  4405. <member name="F:Tao.Platform.Windows.Gdi.PROOF_QUALITY">
  4406. <summary>
  4407. </summary>
  4408. </member>
  4409. <member name="F:Tao.Platform.Windows.Gdi.NONANTIALIASED_QUALITY">
  4410. <summary>
  4411. </summary>
  4412. </member>
  4413. <member name="F:Tao.Platform.Windows.Gdi.ANTIALIASED_QUALITY">
  4414. <summary>
  4415. </summary>
  4416. </member>
  4417. <member name="F:Tao.Platform.Windows.Gdi.CLEARTYPE_QUALITY">
  4418. <summary>
  4419. </summary>
  4420. </member>
  4421. <member name="F:Tao.Platform.Windows.Gdi.CLEARTYPE_NATURAL_QUALITY">
  4422. <summary>
  4423. </summary>
  4424. </member>
  4425. <member name="F:Tao.Platform.Windows.Gdi.DEFAULT_PITCH">
  4426. <summary>
  4427. </summary>
  4428. </member>
  4429. <member name="F:Tao.Platform.Windows.Gdi.FIXED_PITCH">
  4430. <summary>
  4431. </summary>
  4432. </member>
  4433. <member name="F:Tao.Platform.Windows.Gdi.VARIABLE_PITCH">
  4434. <summary>
  4435. </summary>
  4436. </member>
  4437. <member name="F:Tao.Platform.Windows.Gdi.MONO_FONT">
  4438. <summary>
  4439. </summary>
  4440. </member>
  4441. <member name="F:Tao.Platform.Windows.Gdi.ANSI_CHARSET">
  4442. <summary>
  4443. </summary>
  4444. </member>
  4445. <member name="F:Tao.Platform.Windows.Gdi.DEFAULT_CHARSET">
  4446. <summary>
  4447. </summary>
  4448. </member>
  4449. <member name="F:Tao.Platform.Windows.Gdi.SYMBOL_CHARSET">
  4450. <summary>
  4451. </summary>
  4452. </member>
  4453. <member name="F:Tao.Platform.Windows.Gdi.SHIFTJIS_CHARSET">
  4454. <summary>
  4455. </summary>
  4456. </member>
  4457. <member name="F:Tao.Platform.Windows.Gdi.FF_DONTCARE">
  4458. <summary>
  4459. </summary>
  4460. </member>
  4461. <member name="F:Tao.Platform.Windows.Gdi.FW_BOLD">
  4462. <summary>
  4463. </summary>
  4464. </member>
  4465. <member name="M:Tao.Platform.Windows.Gdi._SetPixelFormat(System.IntPtr,System.Int32,Tao.Platform.Windows.Gdi.PIXELFORMATDESCRIPTOR@)">
  4466. <summary>
  4467. </summary>
  4468. </member>
  4469. <member name="M:Tao.Platform.Windows.Gdi.ChoosePixelFormat(System.IntPtr,Tao.Platform.Windows.Gdi.PIXELFORMATDESCRIPTOR@)">
  4470. <summary>
  4471. The <b>ChoosePixelFormat</b> function attempts to match an appropriate pixel format supported by a device context
  4472. to a given pixel format specification.
  4473. </summary>
  4474. <param name="deviceContext">
  4475. Specifies the device context that the function examines to determine the best match for the pixel format
  4476. descriptor pointed to by <i>ppfd</i>.
  4477. </param>
  4478. <param name="pixelFormatDescriptor">
  4479. <para>
  4480. Pointer to a <see cref="T:Tao.Platform.Windows.Gdi.PIXELFORMATDESCRIPTOR"/> structure that specifies the requested pixel format.
  4481. In this context, the members of the <b>PIXELFORMATDESCRIPTOR</b> structure that <i>ppfd</i>
  4482. points to are used as follows:
  4483. </para>
  4484. <para>
  4485. <b>nSize</b><br/>
  4486. Specifies the size of the <b>PIXELFORMATDESCRIPTOR</b> data structure. Set this member to
  4487. <c>sizeof(PIXELFORMATDESCRIPTOR)</c>.
  4488. </para>
  4489. <para>
  4490. <b>nVersion</b><br/>
  4491. Specifies the version number of the <b>PIXELFORMATDESCRIPTOR</b> data structure. Set this member to 1.
  4492. </para>
  4493. <para>
  4494. <b>dwFlags</b><br/>
  4495. A set of bit flags that specify properties of the pixel buffer. You can combine the following bit
  4496. flag constants by using bitwise-OR.<br/><br/>
  4497. If any of the following flags are set, the <b>ChoosePixelFormat</b> function attempts to match pixel
  4498. formats that also have that flag or flags set. Otherwise, <b>ChoosePixelFormat</b> ignores that flag
  4499. in the pixel formats:<br/><br/>
  4500. PFD_DRAW_TO_WINDOW<br/>
  4501. PFD_DRAW_TO_BITMAP<br/>
  4502. PFD_SUPPORT_GDI<br/>
  4503. PFD_SUPPORT_OPENGL<br/><br/>
  4504. If any of the following flags are set, <b>ChoosePixelFormat</b> attempts to match pixel formats that
  4505. also have that flag or flags set. Otherwise, it attempts to match pixel formats without that flag set:<br/><br/>
  4506. PFD_DOUBLEBUFFER<br/>
  4507. PFD_STEREO<br/><br/>
  4508. If the following flag is set, the function ignores the PFD_DOUBLEBUFFER flag in the pixel formats:<br/><br/>
  4509. PFD_DOUBLEBUFFER_DONTCARE<br/><br/>
  4510. If the following flag is set, the function ignores the PFD_STEREO flag in the pixel formats:<br/><br/>
  4511. PFD_STEREO_DONTCARE<br/>
  4512. </para>
  4513. <para>
  4514. <b>iPixelType</b><br/>
  4515. Specifies the type of pixel format for the function to consider:<br/><br/>
  4516. PFD_TYPE_RGBA<br/>
  4517. PFD_TYPE_COLORINDEX<br/>
  4518. </para>
  4519. <para>
  4520. <b>cColorBits</b><br/>
  4521. Zero or greater.
  4522. </para>
  4523. <para>
  4524. <b>cRedBits</b><br/>
  4525. Not used.
  4526. </para>
  4527. <para>
  4528. <b>cRedShift</b><br/>
  4529. Not used.
  4530. </para>
  4531. <para>
  4532. <b>cGreenBits</b><br/>
  4533. Not used.
  4534. </para>
  4535. <para>
  4536. <b>cGreenShift</b><br/>
  4537. Not used.
  4538. </para>
  4539. <para>
  4540. <b>cBlueBits</b><br/>
  4541. Not used.
  4542. </para>
  4543. <para>
  4544. <b>cBlueShift</b><br/>
  4545. Not used.
  4546. </para>
  4547. <para>
  4548. <b>cAlphaBits</b><br/>
  4549. Zero or greater.
  4550. </para>
  4551. <para>
  4552. <b>cAlphaShift</b><br/>
  4553. Not used.
  4554. </para>
  4555. <para>
  4556. <b>cAccumBits</b><br/>
  4557. Zero or greater.
  4558. </para>
  4559. <para>
  4560. <b>cAccumRedBits</b><br/>
  4561. Not used.
  4562. </para>
  4563. <para>
  4564. <b>cAccumGreenBits</b><br/>
  4565. Not used.
  4566. </para>
  4567. <para>
  4568. <b>cAccumBlueBits</b><br/>
  4569. Not used.
  4570. </para>
  4571. <para>
  4572. <b>cAccumAlphaBits</b><br/>
  4573. Not used.
  4574. </para>
  4575. <para>
  4576. <b>cDepthBits</b><br/>
  4577. Zero or greater.
  4578. </para>
  4579. <para>
  4580. <b>cStencilBits</b><br/>
  4581. Zero or greater.
  4582. </para>
  4583. <para>
  4584. <b>cAuxBuffers</b><br/>
  4585. Zero or greater.
  4586. </para>
  4587. <para>
  4588. <b>iLayerType</b><br/>
  4589. Specifies one of the following layer type values:<br/><br/>
  4590. PFD_MAIN_PLANE<br/>
  4591. PFD_OVERLAY_PLANE<br/>
  4592. PFD_UNDERLAY_PLANE<br/>
  4593. </para>
  4594. <para>
  4595. <b>bReserved</b><br/>
  4596. Not used.
  4597. </para>
  4598. <para>
  4599. <b>dwLayerMask</b><br/>
  4600. Not used.
  4601. </para>
  4602. <para>
  4603. <b>dwVisibleMask</b><br/>
  4604. Not used.
  4605. </para>
  4606. <para>
  4607. <b>dwDamageMask</b><br/>
  4608. Not used.
  4609. </para>
  4610. </param>
  4611. <returns>
  4612. If the function succeeds, the return value is a pixel format index (one-based) that is the closest match
  4613. to the given pixel format descriptor.<br/><br/>
  4614. If the function fails, the return value is zero. To get extended error information,
  4615. call see cref="Kernel.GetLastError" /&gt;.
  4616. </returns>
  4617. <remarks>
  4618. You must ensure that the pixel format matched by the <b>ChoosePixelFormat</b> function satisfies your
  4619. requirements. For example, if you request a pixel format with a 24-bit RGB color buffer but the device
  4620. context offers only 8-bit RGB color buffers, the function returns a pixel format with an 8-bit RGB color
  4621. buffer.<br/><br/>
  4622. The following code sample shows how to use <b>ChoosePixelFormat</b> to match a specified pixel
  4623. format:<br/><br/>
  4624. <code>
  4625. HDC hdc;
  4626. int pixelFormat;
  4627. Gdi.PIXELFORMATDESCRIPTOR pfd;
  4628. // size of this pfd
  4629. pfd.nSize = (ushort) sizeof(Gdi.PIXELFORMATDESCRIPTOR);
  4630. // version number
  4631. pfd.nVersion = 1;
  4632. // support window, support OpenGL, double buffered
  4633. pfd.dwFlags = Gdi.PFD_DRAW_TO_WINDOW | Gdi.PFD_SUPPORT_OPENGL | Gdi.PFD_DOUBLEBUFFER;
  4634. // RGBA type
  4635. pfd.iPixelType = Gdi.PFD_TYPE_RGBA;
  4636. // 24-bit color depth
  4637. pfd.cColorBits = 24;
  4638. // color bits and shift bits ignored
  4639. pfd.cRedBits = 0;
  4640. pfd.cRedShift = 0;
  4641. pfd.cGreenBits = 0;
  4642. pfd.cGreenShift = 0;
  4643. pfd.cBlueBits = 0;
  4644. pfd.cBlueShift = 0;
  4645. pfd.cAlphaBits = 0;
  4646. pfd.cAlphaShift = 0;
  4647. // no accumulation buffer, accum bits ignored
  4648. pfd.cAccumBits = 0;
  4649. pfd.cAccumRedBits = 0;
  4650. pfd.cAccumGreenBits = 0;
  4651. pfd.cAccumBlueBits = 0;
  4652. pfd.cAccumAlphaBits = 0;
  4653. // no stencil buffer
  4654. pfd.cStencilBits = 0;
  4655. // no auxiliary buffer
  4656. pfd.cAuxBuffers = 0;
  4657. // main layer
  4658. pfd.iLayerType = Gdi.PFD_MAIN_PLANE;
  4659. // reserved
  4660. pfd.bReserved = 0;
  4661. // layer masks ignored
  4662. pfd.dwLayerMask = 0;
  4663. pfd.dwVisibleMask = 0;
  4664. pfd.dwDamageMask = 0;
  4665. pixelFormat = Gdi.ChoosePixelFormat(hdc, &amp;pfd);
  4666. </code>
  4667. </remarks>
  4668. seealso cref="DescribePixelFormat" /&gt;
  4669. seealso cref="GetPixelFormat" /&gt;
  4670. <seealso cref="M:Tao.Platform.Windows.Gdi.SetPixelFormat(System.IntPtr,System.Int32,Tao.Platform.Windows.Gdi.PIXELFORMATDESCRIPTOR@)"/>
  4671. </member>
  4672. <member name="M:Tao.Platform.Windows.Gdi.SetPixelFormat(System.IntPtr,System.Int32,Tao.Platform.Windows.Gdi.PIXELFORMATDESCRIPTOR@)">
  4673. <summary>
  4674. The <b>SetPixelFormat</b> function sets the pixel format of the specified device context to the format
  4675. specified by the <i>iPixelFormat</i> index.
  4676. </summary>
  4677. <param name="deviceContext">
  4678. Specifies the device context whose pixel format the function attempts to set.
  4679. </param>
  4680. <param name="pixelFormat">
  4681. Index that identifies the pixel format to set. The various pixel formats supported by a device
  4682. context are identified by one-based indexes.
  4683. </param>
  4684. <param name="pixelFormatDescriptor">
  4685. Pointer to a <see cref="T:Tao.Platform.Windows.Gdi.PIXELFORMATDESCRIPTOR"/> structure that contains the logical pixel
  4686. format specification. The system's metafile component uses this structure to record the logical
  4687. pixel format specification. The structure has no other effect upon the behavior of the
  4688. <b>SetPixelFormat</b> function.
  4689. </param>
  4690. <returns>
  4691. If the function succeeds, the return value is true.<br/><br/>
  4692. If the function fails, the return value is false. To get extended error information, call
  4693. see cref="Kernel.GetLastError" /&gt;.
  4694. </returns>
  4695. <remarks>
  4696. If <i>hdc</i> references a window, calling the <b>SetPixelFormat</b> function also changes the pixel format
  4697. of the window. Setting the pixel format of a window more than once can lead to significant complications
  4698. for the Window Manager and for multithread applications, so it is not allowed. An application can only set
  4699. the pixel format of a window one time. Once a window's pixel format is set, it cannot be changed.<br/><br/>
  4700. You should select a pixel format in the device context before calling the <see cref="M:Tao.Platform.Windows.Wgl.wglCreateContext(System.IntPtr)"/>
  4701. function. The <b>wglCreateContext</b> function creates a rendering context for drawing on the device in the
  4702. selected pixel format of the device context.<br/><br/>
  4703. An OpenGL window has its own pixel format. Because of this, only device contexts retrieved for the client
  4704. area of an OpenGL window are allowed to draw into the window. As a result, an OpenGL window should be created
  4705. with the WS_CLIPCHILDREN and WS_CLIPSIBLINGS styles. Additionally, the window class attribute should not
  4706. include the CS_PARENTDC style.<br/><br/>
  4707. The following code example shows <b>SetPixelFormat</b> usage:<br/><br/>
  4708. <code>
  4709. HDC hdc;
  4710. int pixelFormat;
  4711. Gdi.PIXELFORMATDESCRIPTOR pfd;
  4712. // size of this pfd
  4713. pfd.nSize = (ushort) sizeof(Gdi.PIXELFORMATDESCRIPTOR);
  4714. // version number
  4715. pfd.nVersion = 1;
  4716. // support window, support OpenGL, double buffered
  4717. pfd.dwFlags = Gdi.PFD_DRAW_TO_WINDOW | Gdi.PFD_SUPPORT_OPENGL | Gdi.PFD_DOUBLEBUFFER;
  4718. // RGBA type
  4719. pfd.iPixelType = Gdi.PFD_TYPE_RGBA;
  4720. // 24-bit color depth
  4721. pfd.cColorBits = 24;
  4722. // color bits and shift bits ignored
  4723. pfd.cRedBits = 0;
  4724. pfd.cRedShift = 0;
  4725. pfd.cGreenBits = 0;
  4726. pfd.cGreenShift = 0;
  4727. pfd.cBlueBits = 0;
  4728. pfd.cBlueShift = 0;
  4729. pfd.cAlphaBits = 0;
  4730. pfd.cAlphaShift = 0;
  4731. // no accumulation buffer, accum bits ignored
  4732. pfd.cAccumBits = 0;
  4733. pfd.cAccumRedBits = 0;
  4734. pfd.cAccumGreenBits = 0;
  4735. pfd.cAccumBlueBits = 0;
  4736. pfd.cAccumAlphaBits = 0;
  4737. // no stencil buffer
  4738. pfd.cStencilBits = 0;
  4739. // no auxiliary buffer
  4740. pfd.cAuxBuffers = 0;
  4741. // main layer
  4742. pfd.iLayerType = Gdi.PFD_MAIN_PLANE;
  4743. // reserved
  4744. pfd.bReserved = 0;
  4745. // layer masks ignored
  4746. pfd.dwLayerMask = 0;
  4747. pfd.dwVisibleMask = 0;
  4748. pfd.dwDamageMask = 0;
  4749. pixelFormat = Gdi.ChoosePixelFormat(hdc, &amp;pfd);
  4750. // make that the pixel format of the device context
  4751. Gdi.SetPixelFormat(hdc, pixelFormat, &amp;pfd);
  4752. </code>
  4753. </remarks>
  4754. <seealso cref="M:Tao.Platform.Windows.Gdi.ChoosePixelFormat(System.IntPtr,Tao.Platform.Windows.Gdi.PIXELFORMATDESCRIPTOR@)"/>
  4755. seealso cref="DescribePixelFormat" /&gt;
  4756. seealso cref="GetPixelFormat" /&gt;
  4757. </member>
  4758. <member name="M:Tao.Platform.Windows.Gdi.SwapBuffers(System.IntPtr)">
  4759. <summary>
  4760. </summary>
  4761. <param name="deviceContext"></param>
  4762. <returns></returns>
  4763. </member>
  4764. <member name="M:Tao.Platform.Windows.Gdi.SwapBuffersFast(System.IntPtr)">
  4765. <summary>
  4766. </summary>
  4767. <param name="deviceContext"></param>
  4768. <returns></returns>
  4769. </member>
  4770. <member name="M:Tao.Platform.Windows.Gdi.CreateFont(System.Int32,System.Int32,System.Int32,System.Int32,System.Int32,System.Boolean,System.Boolean,System.Boolean,System.Int32,System.Int32,System.Int32,System.Int32,System.Int32,System.String)">
  4771. <summary>
  4772. </summary>
  4773. <param name="height"></param>
  4774. <param name="width"></param>
  4775. <param name="escapement"></param>
  4776. <param name="orientation"></param>
  4777. <param name="weight"></param>
  4778. <param name="italic"></param>
  4779. <param name="underline"></param>
  4780. <param name="strikeOut"></param>
  4781. <param name="charSet"></param>
  4782. <param name="outputPrecision"></param>
  4783. <param name="clipPrecision"></param>
  4784. <param name="quality"></param>
  4785. <param name="pitchAndFamily"></param>
  4786. <param name="typeFace"></param>
  4787. <returns></returns>
  4788. </member>
  4789. <member name="M:Tao.Platform.Windows.Gdi.DeleteObject(System.IntPtr)">
  4790. <summary>
  4791. </summary>
  4792. <param name="objectHandle"></param>
  4793. <returns></returns>
  4794. </member>
  4795. <member name="M:Tao.Platform.Windows.Gdi.SelectObject(System.IntPtr,System.IntPtr)">
  4796. <summary>
  4797. </summary>
  4798. <param name="deviceContext"></param>
  4799. <param name="objectHandle"></param>
  4800. <returns></returns>
  4801. </member>
  4802. <member name="M:Tao.Platform.Windows.Gdi.GetDeviceCaps(System.IntPtr,System.Int32)">
  4803. <summary>
  4804. Retrieves device-specific information for the specified device.
  4805. </summary>
  4806. <param name="deviceContext">Handle to the DC</param>
  4807. <param name="nIndex">Specifies the item to return</param>
  4808. <returns></returns>
  4809. </member>
  4810. <member name="T:Tao.Platform.Windows.Gdi.DEVMODE">
  4811. <summary>
  4812. <para>
  4813. The <b>DEVMODE</b> data structure contains information about the
  4814. initialization and environment of a printer or a display device.
  4815. </para>
  4816. </summary>
  4817. <remarks>
  4818. <para>
  4819. A device driver's private data follows the public portion of the
  4820. <b>DEVMODE</b> structure. The size of the public data can vary for different
  4821. versions of the structure. The <i>dmSize</i> member specifies the number of
  4822. bytes of public data, and the <i>dmDriverExtra</i> member specifies the
  4823. number of bytes of private data.
  4824. </para>
  4825. </remarks>
  4826. <seealso cref="M:Tao.Platform.Windows.User.ChangeDisplaySettings(Tao.Platform.Windows.Gdi.DEVMODE@,System.Int32)"/>
  4827. <seealso cref="M:Tao.Platform.Windows.User.EnumDisplaySettings(System.String,System.Int32,Tao.Platform.Windows.Gdi.DEVMODE@)"/>
  4828. </member>
  4829. <member name="F:Tao.Platform.Windows.Gdi.DEVMODE.dmDeviceName">
  4830. <summary>
  4831. </summary>
  4832. </member>
  4833. <member name="F:Tao.Platform.Windows.Gdi.DEVMODE.dmSpecVersion">
  4834. <summary>
  4835. </summary>
  4836. </member>
  4837. <member name="F:Tao.Platform.Windows.Gdi.DEVMODE.dmDriverVersion">
  4838. <summary>
  4839. </summary>
  4840. </member>
  4841. <member name="F:Tao.Platform.Windows.Gdi.DEVMODE.dmSize">
  4842. <summary>
  4843. </summary>
  4844. </member>
  4845. <member name="F:Tao.Platform.Windows.Gdi.DEVMODE.dmDriverExtra">
  4846. <summary>
  4847. </summary>
  4848. </member>
  4849. <member name="F:Tao.Platform.Windows.Gdi.DEVMODE.dmFields">
  4850. <summary>
  4851. </summary>
  4852. </member>
  4853. <member name="F:Tao.Platform.Windows.Gdi.DEVMODE.dmOrientation">
  4854. <summary>
  4855. </summary>
  4856. </member>
  4857. <member name="F:Tao.Platform.Windows.Gdi.DEVMODE.dmPaperSize">
  4858. <summary>
  4859. </summary>
  4860. </member>
  4861. <member name="F:Tao.Platform.Windows.Gdi.DEVMODE.dmPaperLength">
  4862. <summary>
  4863. </summary>
  4864. </member>
  4865. <member name="F:Tao.Platform.Windows.Gdi.DEVMODE.dmPaperWidth">
  4866. <summary>
  4867. </summary>
  4868. </member>
  4869. <member name="F:Tao.Platform.Windows.Gdi.DEVMODE.dmScale">
  4870. <summary>
  4871. </summary>
  4872. </member>
  4873. <member name="F:Tao.Platform.Windows.Gdi.DEVMODE.dmCopies">
  4874. <summary>
  4875. </summary>
  4876. </member>
  4877. <member name="F:Tao.Platform.Windows.Gdi.DEVMODE.dmDefaultSource">
  4878. <summary>
  4879. </summary>
  4880. </member>
  4881. <member name="F:Tao.Platform.Windows.Gdi.DEVMODE.dmPrintQuality">
  4882. <summary>
  4883. </summary>
  4884. </member>
  4885. <member name="F:Tao.Platform.Windows.Gdi.DEVMODE.dmColor">
  4886. <summary>
  4887. </summary>
  4888. </member>
  4889. <member name="F:Tao.Platform.Windows.Gdi.DEVMODE.dmDuplex">
  4890. <summary>
  4891. </summary>
  4892. </member>
  4893. <member name="F:Tao.Platform.Windows.Gdi.DEVMODE.dmYResolution">
  4894. <summary>
  4895. </summary>
  4896. </member>
  4897. <member name="F:Tao.Platform.Windows.Gdi.DEVMODE.dmTTOption">
  4898. <summary>
  4899. </summary>
  4900. </member>
  4901. <member name="F:Tao.Platform.Windows.Gdi.DEVMODE.dmCollate">
  4902. <summary>
  4903. </summary>
  4904. </member>
  4905. <member name="F:Tao.Platform.Windows.Gdi.DEVMODE.dmFormName">
  4906. <summary>
  4907. </summary>
  4908. </member>
  4909. <member name="F:Tao.Platform.Windows.Gdi.DEVMODE.dmLogPixels">
  4910. <summary>
  4911. </summary>
  4912. </member>
  4913. <member name="F:Tao.Platform.Windows.Gdi.DEVMODE.dmBitsPerPel">
  4914. <summary>
  4915. </summary>
  4916. </member>
  4917. <member name="F:Tao.Platform.Windows.Gdi.DEVMODE.dmPelsWidth">
  4918. <summary>
  4919. </summary>
  4920. </member>
  4921. <member name="F:Tao.Platform.Windows.Gdi.DEVMODE.dmPelsHeight">
  4922. <summary>
  4923. </summary>
  4924. </member>
  4925. <member name="F:Tao.Platform.Windows.Gdi.DEVMODE.dmDisplayFlags">
  4926. <summary>
  4927. </summary>
  4928. </member>
  4929. <member name="F:Tao.Platform.Windows.Gdi.DEVMODE.dmDisplayFrequency">
  4930. <summary>
  4931. </summary>
  4932. </member>
  4933. <member name="F:Tao.Platform.Windows.Gdi.DEVMODE.dmICMMethod">
  4934. <summary>
  4935. </summary>
  4936. </member>
  4937. <member name="F:Tao.Platform.Windows.Gdi.DEVMODE.dmICMIntent">
  4938. <summary>
  4939. </summary>
  4940. </member>
  4941. <member name="F:Tao.Platform.Windows.Gdi.DEVMODE.dmMediaType">
  4942. <summary>
  4943. </summary>
  4944. </member>
  4945. <member name="F:Tao.Platform.Windows.Gdi.DEVMODE.dmDitherType">
  4946. <summary>
  4947. </summary>
  4948. </member>
  4949. <member name="F:Tao.Platform.Windows.Gdi.DEVMODE.dmReserved1">
  4950. <summary>
  4951. </summary>
  4952. </member>
  4953. <member name="F:Tao.Platform.Windows.Gdi.DEVMODE.dmReserved2">
  4954. <summary>
  4955. </summary>
  4956. </member>
  4957. <member name="F:Tao.Platform.Windows.Gdi.DEVMODE.dmPanningWidth">
  4958. <summary>
  4959. </summary>
  4960. </member>
  4961. <member name="F:Tao.Platform.Windows.Gdi.DEVMODE.dmPanningHeight">
  4962. <summary>
  4963. </summary>
  4964. </member>
  4965. <member name="T:Tao.Platform.Windows.Gdi.GLYPHMETRICSFLOAT">
  4966. <summary>
  4967. The <b>GLYPHMETRICSFLOAT</b> structure contains information about the placement and orientation of a glyph in a
  4968. character cell.
  4969. </summary>
  4970. <remarks>The values of <b>GLYPHMETRICSFLOAT</b> are specified as notional units.</remarks>
  4971. <seealso cref="T:Tao.Platform.Windows.Gdi.POINTFLOAT"/>
  4972. <seealso cref="M:Tao.Platform.Windows.Wgl.wglUseFontOutlinesA(System.IntPtr,System.Int32,System.Int32,System.Int32,System.Single,System.Single,System.Int32,Tao.Platform.Windows.Gdi.GLYPHMETRICSFLOAT[])"/>
  4973. </member>
  4974. <member name="F:Tao.Platform.Windows.Gdi.GLYPHMETRICSFLOAT.gmfBlackBoxX">
  4975. <summary>
  4976. Specifies the width of the smallest rectangle (the glyph's black box) that completely encloses the glyph.
  4977. </summary>
  4978. </member>
  4979. <member name="F:Tao.Platform.Windows.Gdi.GLYPHMETRICSFLOAT.gmfBlackBoxY">
  4980. <summary>
  4981. Specifies the height of the smallest rectangle (the glyph's black box) that completely encloses the glyph.
  4982. </summary>
  4983. </member>
  4984. <member name="F:Tao.Platform.Windows.Gdi.GLYPHMETRICSFLOAT.gmfptGlyphOrigin">
  4985. <summary>
  4986. Specifies the x and y coordinates of the upper-left corner of the smallest rectangle that completely encloses the glyph.
  4987. </summary>
  4988. </member>
  4989. <member name="F:Tao.Platform.Windows.Gdi.GLYPHMETRICSFLOAT.gmfCellIncX">
  4990. <summary>
  4991. Specifies the horizontal distance from the origin of the current character cell to the origin of the next character cell.
  4992. </summary>
  4993. </member>
  4994. <member name="F:Tao.Platform.Windows.Gdi.GLYPHMETRICSFLOAT.gmfCellIncY">
  4995. <summary>
  4996. Specifies the vertical distance from the origin of the current character cell to the origin of the next character cell.
  4997. </summary>
  4998. </member>
  4999. <member name="T:Tao.Platform.Windows.Gdi.PIXELFORMATDESCRIPTOR">
  5000. <summary>
  5001. The <b>PIXELFORMATDESCRIPTOR</b> structure describes the pixel format of a drawing surface.
  5002. </summary>
  5003. <remarks>
  5004. Please notice carefully, as documented in the members, that certain pixel format properties are not supported
  5005. in the current generic implementation. The generic implementation is the Microsoft GDI software
  5006. implementation of OpenGL. Hardware manufacturers may enhance parts of OpenGL, and may support some
  5007. pixel format properties not supported by the generic implementation.
  5008. </remarks>
  5009. <seealso cref="M:Tao.Platform.Windows.Gdi.ChoosePixelFormat(System.IntPtr,Tao.Platform.Windows.Gdi.PIXELFORMATDESCRIPTOR@)"/>
  5010. seealso cref="DescribePixelFormat" /&gt;
  5011. seealso cref="GetPixelFormat" /&gt;
  5012. <seealso cref="M:Tao.Platform.Windows.Gdi.SetPixelFormat(System.IntPtr,System.Int32,Tao.Platform.Windows.Gdi.PIXELFORMATDESCRIPTOR@)"/>
  5013. </member>
  5014. <member name="F:Tao.Platform.Windows.Gdi.PIXELFORMATDESCRIPTOR.nSize">
  5015. <summary>
  5016. Specifies the size of this data structure. This value should be set to <c>sizeof(PIXELFORMATDESCRIPTOR)</c>.
  5017. </summary>
  5018. </member>
  5019. <member name="F:Tao.Platform.Windows.Gdi.PIXELFORMATDESCRIPTOR.nVersion">
  5020. <summary>
  5021. Specifies the version of this data structure. This value should be set to 1.
  5022. </summary>
  5023. </member>
  5024. <member name="F:Tao.Platform.Windows.Gdi.PIXELFORMATDESCRIPTOR.dwFlags">
  5025. <summary>
  5026. A set of bit flags that specify properties of the pixel buffer. The properties are generally not mutually exclusive;
  5027. you can set any combination of bit flags, with the exceptions noted.
  5028. </summary>
  5029. <remarks>
  5030. <para>The following bit flag constants are defined:</para>
  5031. <list type="table">
  5032. <listheader>
  5033. <term>Value</term>
  5034. <description>Meaning</description>
  5035. </listheader>
  5036. <item>
  5037. <term>PFD_DRAW_TO_WINDOW</term>
  5038. <description>The buffer can draw to a window or device surface.</description>
  5039. </item>
  5040. <item>
  5041. <term>PFD_DRAW_TO_BITMAP</term>
  5042. <description>The buffer can draw to a memory bitmap.</description>
  5043. </item>
  5044. <item>
  5045. <term>PFD_SUPPORT_GDI</term>
  5046. <description>
  5047. The buffer supports GDI drawing. This flag and PFD_DOUBLEBUFFER are mutually exclusive
  5048. in the current generic implementation.
  5049. </description>
  5050. </item>
  5051. <item>
  5052. <term>PFD_SUPPORT_OPENGL</term>
  5053. <description>The buffer supports OpenGL drawing.</description>
  5054. </item>
  5055. <item>
  5056. <term>PFD_GENERIC_ACCELERATED</term>
  5057. <description>
  5058. The pixel format is supported by a device driver that accelerates the generic implementation.
  5059. If this flag is clear and the PFD_GENERIC_FORMAT flag is set, the pixel format is supported by
  5060. the generic implementation only.
  5061. </description>
  5062. </item>
  5063. <item>
  5064. <term>PFD_GENERIC_FORMAT</term>
  5065. <description>
  5066. The pixel format is supported by the GDI software implementation, which is also known as the
  5067. generic implementation. If this bit is clear, the pixel format is supported by a device
  5068. driver or hardware.
  5069. </description>
  5070. </item>
  5071. <item>
  5072. <term>PFD_NEED_PALETTE</term>
  5073. <description>
  5074. The buffer uses RGBA pixels on a palette-managed device. A logical palette is required to achieve
  5075. the best results for this pixel type. Colors in the palette should be specified according to the
  5076. values of the <b>cRedBits</b>, <b>cRedShift</b>, <b>cGreenBits</b>, <b>cGreenShift</b>,
  5077. <b>cBluebits</b>, and <b>cBlueShift</b> members. The palette should be created and realized in
  5078. the device context before calling <see cref="M:Tao.Platform.Windows.Wgl.wglMakeCurrent(System.IntPtr,System.IntPtr)"/>.
  5079. </description>
  5080. </item>
  5081. <item>
  5082. <term>PFD_NEED_SYSTEM_PALETTE</term>
  5083. <description>
  5084. Defined in the pixel format descriptors of hardware that supports one hardware palette in
  5085. 256-color mode only. For such systems to use hardware acceleration, the hardware palette must be in
  5086. a fixed order (for example, 3-3-2) when in RGBA mode or must match the logical palette when in
  5087. color-index mode.
  5088. When this flag is set, you must call SetSystemPaletteUse in your program to force a one-to-one
  5089. mapping of the logical palette and the system palette. If your OpenGL hardware supports multiple
  5090. hardware palettes and the device driver can allocate spare hardware palettes for OpenGL, this
  5091. flag is typically clear.
  5092. This flag is not set in the generic pixel formats.
  5093. </description>
  5094. </item>
  5095. <item>
  5096. <term>PFD_DOUBLEBUFFER</term>
  5097. <description>
  5098. The buffer is double-buffered. This flag and PFD_SUPPORT_GDI are mutually exclusive in the
  5099. current generic implementation.
  5100. </description>
  5101. </item>
  5102. <item>
  5103. <term>PFD_STEREO</term>
  5104. <description>
  5105. The buffer is stereoscopic. This flag is not supported in the current generic implementation.
  5106. </description>
  5107. </item>
  5108. <item>
  5109. <term>PFD_SWAP_LAYER_BUFFERS</term>
  5110. <description>
  5111. Indicates whether a device can swap individual layer planes with pixel formats that include
  5112. double-buffered overlay or underlay planes. Otherwise all layer planes are swapped together
  5113. as a group. When this flag is set, <b>wglSwapLayerBuffers</b> is supported.
  5114. </description>
  5115. </item>
  5116. </list>
  5117. <para>You can specify the following bit flags when calling <see cref="M:Tao.Platform.Windows.Gdi.ChoosePixelFormat(System.IntPtr,Tao.Platform.Windows.Gdi.PIXELFORMATDESCRIPTOR@)"/>.</para>
  5118. <list type="table">
  5119. <listheader>
  5120. <term>Value</term>
  5121. <description>Meaning</description>
  5122. </listheader>
  5123. <item>
  5124. <term>PFD_DEPTH_DONTCARE</term>
  5125. <description>
  5126. The requested pixel format can either have or not have a depth buffer. To select
  5127. a pixel format without a depth buffer, you must specify this flag. The requested pixel format
  5128. can be with or without a depth buffer. Otherwise, only pixel formats with a depth buffer
  5129. are considered.
  5130. </description>
  5131. </item>
  5132. <item>
  5133. <term>PFD_DOUBLEBUFFER_DONTCARE</term>
  5134. <description>The requested pixel format can be either single- or double-buffered.</description>
  5135. </item>
  5136. <item>
  5137. <term>PFD_STEREO_DONTCARE</term>
  5138. <description>The requested pixel format can be either monoscopic or stereoscopic.</description>
  5139. </item>
  5140. </list>
  5141. <para>
  5142. With the <b>glAddSwapHintRectWIN</b> extension function, two new flags are included for the
  5143. <b>PIXELFORMATDESCRIPTOR</b> pixel format structure.
  5144. </para>
  5145. <list type="table">
  5146. <listheader>
  5147. <term>Value</term>
  5148. <description>Meaning</description>
  5149. </listheader>
  5150. <item>
  5151. <term>PFD_SWAP_COPY</term>
  5152. <description>
  5153. Specifies the content of the back buffer in the double-buffered main color plane following
  5154. a buffer swap. Swapping the color buffers causes the content of the back buffer to be copied
  5155. to the front buffer. The content of the back buffer is not affected by the swap. PFD_SWAP_COPY
  5156. is a hint only and might not be provided by a driver.
  5157. </description>
  5158. </item>
  5159. <item>
  5160. <term>PFD_SWAP_EXCHANGE</term>
  5161. <description>
  5162. Specifies the content of the back buffer in the double-buffered main color plane following a
  5163. buffer swap. Swapping the color buffers causes the exchange of the back buffer's content
  5164. with the front buffer's content. Following the swap, the back buffer's content contains the
  5165. front buffer's content before the swap. PFD_SWAP_EXCHANGE is a hint only and might not be
  5166. provided by a driver.
  5167. </description>
  5168. </item>
  5169. </list>
  5170. </remarks>
  5171. </member>
  5172. <member name="F:Tao.Platform.Windows.Gdi.PIXELFORMATDESCRIPTOR.iPixelType">
  5173. <summary>
  5174. Specifies the type of pixel data. The following types are defined.
  5175. </summary>
  5176. <remarks>
  5177. <list type="table">
  5178. <listheader>
  5179. <term>Value</term>
  5180. <description>Meaning</description>
  5181. </listheader>
  5182. <item>
  5183. <term>PFD_TYPE_RGBA</term>
  5184. <description>
  5185. RGBA pixels. Each pixel has four components in this order: red, green, blue, and alpha.
  5186. </description>
  5187. </item>
  5188. <item>
  5189. <term>PFD_TYPE_COLORINDEX</term>
  5190. <description>Color-index pixels. Each pixel uses a color-index value.</description>
  5191. </item>
  5192. </list>
  5193. </remarks>
  5194. </member>
  5195. <member name="F:Tao.Platform.Windows.Gdi.PIXELFORMATDESCRIPTOR.cColorBits">
  5196. <summary>
  5197. Specifies the number of color bitplanes in each color buffer. For RGBA pixel types, it is the size
  5198. of the color buffer, excluding the alpha bitplanes. For color-index pixels, it is the size of the
  5199. color-index buffer.
  5200. </summary>
  5201. </member>
  5202. <member name="F:Tao.Platform.Windows.Gdi.PIXELFORMATDESCRIPTOR.cRedBits">
  5203. <summary>
  5204. Specifies the number of red bitplanes in each RGBA color buffer.
  5205. </summary>
  5206. </member>
  5207. <member name="F:Tao.Platform.Windows.Gdi.PIXELFORMATDESCRIPTOR.cRedShift">
  5208. <summary>
  5209. Specifies the shift count for red bitplanes in each RGBA color buffer.
  5210. </summary>
  5211. </member>
  5212. <member name="F:Tao.Platform.Windows.Gdi.PIXELFORMATDESCRIPTOR.cGreenBits">
  5213. <summary>
  5214. Specifies the number of green bitplanes in each RGBA color buffer.
  5215. </summary>
  5216. </member>
  5217. <member name="F:Tao.Platform.Windows.Gdi.PIXELFORMATDESCRIPTOR.cGreenShift">
  5218. <summary>
  5219. Specifies the shift count for green bitplanes in each RGBA color buffer.
  5220. </summary>
  5221. </member>
  5222. <member name="F:Tao.Platform.Windows.Gdi.PIXELFORMATDESCRIPTOR.cBlueBits">
  5223. <summary>
  5224. Specifies the number of blue bitplanes in each RGBA color buffer.
  5225. </summary>
  5226. </member>
  5227. <member name="F:Tao.Platform.Windows.Gdi.PIXELFORMATDESCRIPTOR.cBlueShift">
  5228. <summary>
  5229. Specifies the shift count for blue bitplanes in each RGBA color buffer.
  5230. </summary>
  5231. </member>
  5232. <member name="F:Tao.Platform.Windows.Gdi.PIXELFORMATDESCRIPTOR.cAlphaBits">
  5233. <summary>
  5234. Specifies the number of alpha bitplanes in each RGBA color buffer. Alpha bitplanes are not supported.
  5235. </summary>
  5236. </member>
  5237. <member name="F:Tao.Platform.Windows.Gdi.PIXELFORMATDESCRIPTOR.cAlphaShift">
  5238. <summary>
  5239. Specifies the shift count for alpha bitplanes in each RGBA color buffer. Alpha bitplanes are not supported.
  5240. </summary>
  5241. </member>
  5242. <member name="F:Tao.Platform.Windows.Gdi.PIXELFORMATDESCRIPTOR.cAccumBits">
  5243. <summary>
  5244. Specifies the total number of bitplanes in the accumulation buffer.
  5245. </summary>
  5246. </member>
  5247. <member name="F:Tao.Platform.Windows.Gdi.PIXELFORMATDESCRIPTOR.cAccumRedBits">
  5248. <summary>
  5249. Specifies the number of red bitplanes in the accumulation buffer.
  5250. </summary>
  5251. </member>
  5252. <member name="F:Tao.Platform.Windows.Gdi.PIXELFORMATDESCRIPTOR.cAccumGreenBits">
  5253. <summary>
  5254. Specifies the number of green bitplanes in the accumulation buffer.
  5255. </summary>
  5256. </member>
  5257. <member name="F:Tao.Platform.Windows.Gdi.PIXELFORMATDESCRIPTOR.cAccumBlueBits">
  5258. <summary>
  5259. Specifies the number of blue bitplanes in the accumulation buffer.
  5260. </summary>
  5261. </member>
  5262. <member name="F:Tao.Platform.Windows.Gdi.PIXELFORMATDESCRIPTOR.cAccumAlphaBits">
  5263. <summary>
  5264. Specifies the number of alpha bitplanes in the accumulation buffer.
  5265. </summary>
  5266. </member>
  5267. <member name="F:Tao.Platform.Windows.Gdi.PIXELFORMATDESCRIPTOR.cDepthBits">
  5268. <summary>
  5269. Specifies the depth of the depth (z-axis) buffer.
  5270. </summary>
  5271. </member>
  5272. <member name="F:Tao.Platform.Windows.Gdi.PIXELFORMATDESCRIPTOR.cStencilBits">
  5273. <summary>
  5274. Specifies the depth of the stencil buffer.
  5275. </summary>
  5276. </member>
  5277. <member name="F:Tao.Platform.Windows.Gdi.PIXELFORMATDESCRIPTOR.cAuxBuffers">
  5278. <summary>
  5279. Specifies the number of auxiliary buffers. Auxiliary buffers are not supported.
  5280. </summary>
  5281. </member>
  5282. <member name="F:Tao.Platform.Windows.Gdi.PIXELFORMATDESCRIPTOR.iLayerType">
  5283. <summary>
  5284. Ignored. Earlier implementations of OpenGL used this member, but it is no longer used.
  5285. </summary>
  5286. <remarks>Specifies the type of layer.</remarks>
  5287. </member>
  5288. <member name="F:Tao.Platform.Windows.Gdi.PIXELFORMATDESCRIPTOR.bReserved">
  5289. <summary>
  5290. Specifies the number of overlay and underlay planes. Bits 0 through 3 specify up to 15 overlay planes and
  5291. bits 4 through 7 specify up to 15 underlay planes.
  5292. </summary>
  5293. </member>
  5294. <member name="F:Tao.Platform.Windows.Gdi.PIXELFORMATDESCRIPTOR.dwLayerMask">
  5295. <summary>
  5296. Ignored. Earlier implementations of OpenGL used this member, but it is no longer used.
  5297. </summary>
  5298. <remarks>
  5299. Specifies the layer mask. The layer mask is used in conjunction with the visible mask to determine
  5300. if one layer overlays another.
  5301. </remarks>
  5302. </member>
  5303. <member name="F:Tao.Platform.Windows.Gdi.PIXELFORMATDESCRIPTOR.dwVisibleMask">
  5304. <summary>
  5305. Specifies the transparent color or index of an underlay plane. When the pixel type is RGBA, <b>dwVisibleMask</b>
  5306. is a transparent RGB color value. When the pixel type is color index, it is a transparent index value.
  5307. </summary>
  5308. </member>
  5309. <member name="F:Tao.Platform.Windows.Gdi.PIXELFORMATDESCRIPTOR.dwDamageMask">
  5310. <summary>
  5311. Ignored. Earlier implementations of OpenGL used this member, but it is no longer used.
  5312. </summary>
  5313. <remarks>
  5314. Specifies whether more than one pixel format shares the same frame buffer. If the result of the bitwise
  5315. AND of the damage masks between two pixel formats is nonzero, then they share the same buffers.
  5316. </remarks>
  5317. </member>
  5318. <member name="T:Tao.Platform.Windows.Gdi.POINTFLOAT">
  5319. <summary>
  5320. The <b>POINTFLOAT</b> structure contains the x and y coordinates of a point.
  5321. </summary>
  5322. <seealso cref="T:Tao.Platform.Windows.Gdi.GLYPHMETRICSFLOAT"/>
  5323. </member>
  5324. <member name="F:Tao.Platform.Windows.Gdi.POINTFLOAT.X">
  5325. <summary>
  5326. Specifies the horizontal (x) coordinate of a point.
  5327. </summary>
  5328. </member>
  5329. <member name="F:Tao.Platform.Windows.Gdi.POINTFLOAT.Y">
  5330. <summary>
  5331. Specifies the vertical (y) coordinate of a point.
  5332. </summary>
  5333. </member>
  5334. <member name="T:Tao.Platform.Windows.Gdi.LAYERPLANEDESCRIPTOR">
  5335. <summary>
  5336. </summary>
  5337. </member>
  5338. <member name="F:Tao.Platform.Windows.Gdi.LAYERPLANEDESCRIPTOR.nSize">
  5339. <summary>
  5340. </summary>
  5341. </member>
  5342. <member name="F:Tao.Platform.Windows.Gdi.LAYERPLANEDESCRIPTOR.nVersion">
  5343. <summary>
  5344. </summary>
  5345. </member>
  5346. <member name="F:Tao.Platform.Windows.Gdi.LAYERPLANEDESCRIPTOR.dwFlags">
  5347. <summary>
  5348. </summary>
  5349. </member>
  5350. <member name="F:Tao.Platform.Windows.Gdi.LAYERPLANEDESCRIPTOR.iPixelType">
  5351. <summary>
  5352. </summary>
  5353. </member>
  5354. <member name="F:Tao.Platform.Windows.Gdi.LAYERPLANEDESCRIPTOR.cColorBits">
  5355. <summary>
  5356. </summary>
  5357. </member>
  5358. <member name="F:Tao.Platform.Windows.Gdi.LAYERPLANEDESCRIPTOR.cRedBits">
  5359. <summary>
  5360. </summary>
  5361. </member>
  5362. <member name="F:Tao.Platform.Windows.Gdi.LAYERPLANEDESCRIPTOR.cRedShift">
  5363. <summary>
  5364. </summary>
  5365. </member>
  5366. <member name="F:Tao.Platform.Windows.Gdi.LAYERPLANEDESCRIPTOR.cGreenBits">
  5367. <summary>
  5368. </summary>
  5369. </member>
  5370. <member name="F:Tao.Platform.Windows.Gdi.LAYERPLANEDESCRIPTOR.cGreenShift">
  5371. <summary>
  5372. </summary>
  5373. </member>
  5374. <member name="F:Tao.Platform.Windows.Gdi.LAYERPLANEDESCRIPTOR.cBlueBits">
  5375. <summary>
  5376. </summary>
  5377. </member>
  5378. <member name="F:Tao.Platform.Windows.Gdi.LAYERPLANEDESCRIPTOR.cBlueShift">
  5379. <summary>
  5380. </summary>
  5381. </member>
  5382. <member name="F:Tao.Platform.Windows.Gdi.LAYERPLANEDESCRIPTOR.cAlphaBits">
  5383. <summary>
  5384. </summary>
  5385. </member>
  5386. <member name="F:Tao.Platform.Windows.Gdi.LAYERPLANEDESCRIPTOR.cAlphaShift">
  5387. <summary>
  5388. </summary>
  5389. </member>
  5390. <member name="F:Tao.Platform.Windows.Gdi.LAYERPLANEDESCRIPTOR.cAccumBits">
  5391. <summary>
  5392. </summary>
  5393. </member>
  5394. <member name="F:Tao.Platform.Windows.Gdi.LAYERPLANEDESCRIPTOR.cAccumRedBits">
  5395. <summary>
  5396. </summary>
  5397. </member>
  5398. <member name="F:Tao.Platform.Windows.Gdi.LAYERPLANEDESCRIPTOR.cAccumGreenBits">
  5399. <summary>
  5400. </summary>
  5401. </member>
  5402. <member name="F:Tao.Platform.Windows.Gdi.LAYERPLANEDESCRIPTOR.cAccumBlueBits">
  5403. <summary>
  5404. </summary>
  5405. </member>
  5406. <member name="F:Tao.Platform.Windows.Gdi.LAYERPLANEDESCRIPTOR.cAccumAlphaBits">
  5407. <summary>
  5408. </summary>
  5409. </member>
  5410. <member name="F:Tao.Platform.Windows.Gdi.LAYERPLANEDESCRIPTOR.cDepthBits">
  5411. <summary>
  5412. </summary>
  5413. </member>
  5414. <member name="F:Tao.Platform.Windows.Gdi.LAYERPLANEDESCRIPTOR.cStencilBits">
  5415. <summary>
  5416. </summary>
  5417. </member>
  5418. <member name="F:Tao.Platform.Windows.Gdi.LAYERPLANEDESCRIPTOR.cAuxBuffers">
  5419. <summary>
  5420. </summary>
  5421. </member>
  5422. <member name="F:Tao.Platform.Windows.Gdi.LAYERPLANEDESCRIPTOR.iLayerPlane">
  5423. <summary>
  5424. </summary>
  5425. </member>
  5426. <member name="F:Tao.Platform.Windows.Gdi.LAYERPLANEDESCRIPTOR.bReserved">
  5427. <summary>
  5428. </summary>
  5429. </member>
  5430. <member name="F:Tao.Platform.Windows.Gdi.LAYERPLANEDESCRIPTOR.crTransparent">
  5431. <summary>
  5432. </summary>
  5433. </member>
  5434. <member name="T:Tao.Platform.Windows.Gdi.DevCaps">
  5435. <summary>
  5436. Flags for <see cref="M:Tao.Platform.Windows.Gdi.GetDeviceCaps(System.IntPtr,System.Int32)"/>
  5437. </summary>
  5438. </member>
  5439. <member name="F:Tao.Platform.Windows.Gdi.DevCaps.DRIVERVERSION">
  5440. <summary>
  5441. Device driver version
  5442. </summary>
  5443. </member>
  5444. <member name="F:Tao.Platform.Windows.Gdi.DevCaps.TECHNOLOGY">
  5445. <summary>
  5446. Device classification
  5447. </summary>
  5448. </member>
  5449. <member name="F:Tao.Platform.Windows.Gdi.DevCaps.HORZSIZE">
  5450. <summary>
  5451. Horizontal size in millimeters
  5452. </summary>
  5453. </member>
  5454. <member name="F:Tao.Platform.Windows.Gdi.DevCaps.VERTSIZE">
  5455. <summary>
  5456. Vertical size in millimeters
  5457. </summary>
  5458. </member>
  5459. <member name="F:Tao.Platform.Windows.Gdi.DevCaps.HORZRES">
  5460. <summary>
  5461. Horizontal width in pixels
  5462. </summary>
  5463. </member>
  5464. <member name="F:Tao.Platform.Windows.Gdi.DevCaps.VERTRES">
  5465. <summary>
  5466. Vertical height in pixels
  5467. </summary>
  5468. </member>
  5469. <member name="F:Tao.Platform.Windows.Gdi.DevCaps.BITSPIXEL">
  5470. <summary>
  5471. Number of bits per pixel
  5472. </summary>
  5473. </member>
  5474. <member name="F:Tao.Platform.Windows.Gdi.DevCaps.PLANES">
  5475. <summary>
  5476. Number of planes
  5477. </summary>
  5478. </member>
  5479. <member name="F:Tao.Platform.Windows.Gdi.DevCaps.NUMBRUSHES">
  5480. <summary>
  5481. Number of brushes the device has
  5482. </summary>
  5483. </member>
  5484. <member name="F:Tao.Platform.Windows.Gdi.DevCaps.NUMPENS">
  5485. <summary>
  5486. Number of pens the device has
  5487. </summary>
  5488. </member>
  5489. <member name="F:Tao.Platform.Windows.Gdi.DevCaps.NUMMARKERS">
  5490. <summary>
  5491. Number of markers the device has
  5492. </summary>
  5493. </member>
  5494. <member name="F:Tao.Platform.Windows.Gdi.DevCaps.NUMFONTS">
  5495. <summary>
  5496. Number of fonts the device has
  5497. </summary>
  5498. </member>
  5499. <member name="F:Tao.Platform.Windows.Gdi.DevCaps.NUMCOLORS">
  5500. <summary>
  5501. Number of colors the device supports
  5502. </summary>
  5503. </member>
  5504. <member name="F:Tao.Platform.Windows.Gdi.DevCaps.PDEVICESIZE">
  5505. <summary>
  5506. Size required for device descriptor
  5507. </summary>
  5508. </member>
  5509. <member name="F:Tao.Platform.Windows.Gdi.DevCaps.CURVECAPS">
  5510. <summary>
  5511. Curve capabilities
  5512. </summary>
  5513. </member>
  5514. <member name="F:Tao.Platform.Windows.Gdi.DevCaps.LINECAPS">
  5515. <summary>
  5516. Line capabilities
  5517. </summary>
  5518. </member>
  5519. <member name="F:Tao.Platform.Windows.Gdi.DevCaps.POLYGONALCAPS">
  5520. <summary>
  5521. Polygonal capabilities
  5522. </summary>
  5523. </member>
  5524. <member name="F:Tao.Platform.Windows.Gdi.DevCaps.TEXTCAPS">
  5525. <summary>
  5526. Text capabilities
  5527. </summary>
  5528. </member>
  5529. <member name="F:Tao.Platform.Windows.Gdi.DevCaps.CLIPCAPS">
  5530. <summary>
  5531. Clipping capabilities
  5532. </summary>
  5533. </member>
  5534. <member name="F:Tao.Platform.Windows.Gdi.DevCaps.RASTERCAPS">
  5535. <summary>
  5536. Bitblt capabilities
  5537. </summary>
  5538. </member>
  5539. <member name="F:Tao.Platform.Windows.Gdi.DevCaps.ASPECTX">
  5540. <summary>
  5541. Length of the X leg
  5542. </summary>
  5543. </member>
  5544. <member name="F:Tao.Platform.Windows.Gdi.DevCaps.ASPECTY">
  5545. <summary>
  5546. Length of the Y leg
  5547. </summary>
  5548. </member>
  5549. <member name="F:Tao.Platform.Windows.Gdi.DevCaps.ASPECTXY">
  5550. <summary>
  5551. Length of the hypotenuse
  5552. </summary>
  5553. </member>
  5554. <member name="F:Tao.Platform.Windows.Gdi.DevCaps.SHADEBLENDCAPS">
  5555. <summary>
  5556. Shading and Blending caps
  5557. </summary>
  5558. </member>
  5559. <member name="F:Tao.Platform.Windows.Gdi.DevCaps.LOGPIXELSX">
  5560. <summary>
  5561. Logical pixels inch in X
  5562. </summary>
  5563. </member>
  5564. <member name="F:Tao.Platform.Windows.Gdi.DevCaps.LOGPIXELSY">
  5565. <summary>
  5566. Logical pixels inch in Y
  5567. </summary>
  5568. </member>
  5569. <member name="F:Tao.Platform.Windows.Gdi.DevCaps.SIZEPALETTE">
  5570. <summary>
  5571. Number of entries in physical palette
  5572. </summary>
  5573. </member>
  5574. <member name="F:Tao.Platform.Windows.Gdi.DevCaps.NUMRESERVED">
  5575. <summary>
  5576. Number of reserved entries in palette
  5577. </summary>
  5578. </member>
  5579. <member name="F:Tao.Platform.Windows.Gdi.DevCaps.COLORRES">
  5580. <summary>
  5581. Actual color resolution
  5582. </summary>
  5583. </member>
  5584. <member name="F:Tao.Platform.Windows.Gdi.DevCaps.PHYSICALWIDTH">
  5585. <summary>
  5586. Physical Width in device units
  5587. </summary>
  5588. </member>
  5589. <member name="F:Tao.Platform.Windows.Gdi.DevCaps.PHYSICALHEIGHT">
  5590. <summary>
  5591. Physical Height in device units
  5592. </summary>
  5593. </member>
  5594. <member name="F:Tao.Platform.Windows.Gdi.DevCaps.PHYSICALOFFSETX">
  5595. <summary>
  5596. Physical Printable Area x margin
  5597. </summary>
  5598. </member>
  5599. <member name="F:Tao.Platform.Windows.Gdi.DevCaps.PHYSICALOFFSETY">
  5600. <summary>
  5601. Physical Printable Area y margin
  5602. </summary>
  5603. </member>
  5604. <member name="F:Tao.Platform.Windows.Gdi.DevCaps.SCALINGFACTORX">
  5605. <summary>
  5606. Scaling factor x
  5607. </summary>
  5608. </member>
  5609. <member name="F:Tao.Platform.Windows.Gdi.DevCaps.SCALINGFACTORY">
  5610. <summary>
  5611. Scaling factor y
  5612. </summary>
  5613. </member>
  5614. <member name="F:Tao.Platform.Windows.Gdi.DevCaps.VREFRESH">
  5615. <summary>
  5616. Current vertical refresh rate of the display device (for displays only) in Hz
  5617. </summary>
  5618. </member>
  5619. <member name="F:Tao.Platform.Windows.Gdi.DevCaps.DESKTOPVERTRES">
  5620. <summary>
  5621. Horizontal width of entire desktop in pixels
  5622. </summary>
  5623. </member>
  5624. <member name="F:Tao.Platform.Windows.Gdi.DevCaps.DESKTOPHORZRES">
  5625. <summary>
  5626. Vertical height of entire desktop in pixels
  5627. </summary>
  5628. </member>
  5629. <member name="F:Tao.Platform.Windows.Gdi.DevCaps.BLTALIGNMENT">
  5630. <summary>
  5631. Preferred blt alignment
  5632. </summary>
  5633. </member>
  5634. </members>
  5635. </doc>