Something went wrong. Try again.
Reactos
Something went wrong. Try again.
12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285228622872288228922902291229222932294229522962297229822992300230123022303230423052306230723082309231023112312231323142315231623172318231923202321232223232324232523262327232823292330233123322333233423352336233723382339234023412342234323442345234623472348234923502351235223532354235523562357235823592360236123622363236423652366236723682369237023712372237323742375237623772378237923802381238223832384238523862387238823892390239123922393239423952396239723982399240024012402240324042405240624072408240924102411241224132414241524162417241824192420242124222423242424252426242724282429243024312432243324342435243624372438243924402441244224432444244524462447244824492450245124522453245424552456245724582459246024612462246324642465246624672468246924702471247224732474247524762477247824792480248124822483248424852486248724882489249024912492249324942495249624972498249925002501250225032504250525062507250825092510251125122513251425152516251725182519252025212522252325242525252625272528252925302531253225332534253525362537253825392540254125422543254425452546254725482549255025512552255325542555255625572558255925602561256225632564256525662567256825692570257125722573257425752576257725782579258025812582258325842585258625872588258925902591259225932594259525962597259825992600260126022603260426052606260726082609261026112612261326142615261626172618261926202621262226232624262526262627262826292630263126322633263426352636263726382639264026412642264326442645264626472648264926502651265226532654265526562657265826592660266126622663266426652666266726682669267026712672267326742675267626772678267926802681268226832684268526862687268826892690269126922693269426952696269726982699270027012702270327042705270627072708270927102711271227132714271527162717271827192720272127222723272427252726272727282729273027312732273327342735273627372738/*++
Copyright (c) Microsoft Corporation
Module Name:
FxDeviceApi.cpp
Abstract:
This module exposes the "C" interface to the FxDevice object.
Author:
Environment:
Both kernel and user mode
Revision History:
--*/
#include "coreprivshared.hpp"#include "fxiotarget.hpp"
extern "C" {// #include "FxDeviceApi.tmh"}
struct FxOffsetAndName { __nullterminated PCHAR Name; UCHAR Offset;};
#define OFFSET_AND_NAME(type, offset) { #offset, FIELD_OFFSET(type, offset) }
//// extern "C" the entire file//extern "C" {
__drv_maxIRQL(DISPATCH_LEVEL)WDFDRIVERNTAPIWDFEXPORT(WdfDeviceGetDriver)( __in PWDF_DRIVER_GLOBALS DriverGlobals, __in WDFDEVICE Device )/*++
Routine Description:
Given a Device Handle, return a Handle to the Driver object containing this device.
Arguments: Device - WDF Device handle.
Returns: WDF Driver handle.
--*/
{ DDI_ENTRY();
FxDevice* pDevice;
FxObjectHandleGetPtr(GetFxDriverGlobals(DriverGlobals), Device, FX_TYPE_DEVICE, (PVOID*) &pDevice);
// // No need to ref count the driver handle b/c it will be around as long // as the device handle is. // return pDevice->GetDriver()->GetHandle();}
__drv_maxIRQL(DISPATCH_LEVEL)WDFIOTARGETNTAPIWDFEXPORT(WdfDeviceGetIoTarget)( __in PWDF_DRIVER_GLOBALS DriverGlobals, __in WDFDEVICE Device ){ DDI_ENTRY();
FxIoTarget* pTarget; FxDeviceBase *pDeviceBase;
FxObjectHandleGetPtr(GetFxDriverGlobals(DriverGlobals), Device, FX_TYPE_DEVICE_BASE, (PVOID*) &pDeviceBase);
pTarget = pDeviceBase->GetDefaultIoTarget();
if (pTarget != NULL) { return pTarget->GetHandle(); }
return NULL;}
_IRQL_requires_max_(DISPATCH_LEVEL)WDFIOTARGETNTAPIWDFEXPORT(WdfDeviceGetSelfIoTarget)( _In_ PWDF_DRIVER_GLOBALS DriverGlobals, _In_ WDFDEVICE Device )
/*++
Routine Description:
Return the handle to the Self IO target for the device. A Self IO target is only created if the client opted for it by calling WdfDeviceInitAllowSelfTarget
Arguments:
Device - Handle to the Device Object for which Self IO target is needed
Returns:
WDFIOTARGET handle to the Self IO Target. NULL is returned in case the device does not have an Self IO target.
--*/
{ DDI_ENTRY();
FxIoTargetSelf* pTarget; FxDevice *pDevice;
FxObjectHandleGetPtr(GetFxDriverGlobals(DriverGlobals), Device, FX_TYPE_DEVICE, (PVOID*) &pDevice);
pTarget = pDevice->GetSelfIoTarget();
if (pTarget != NULL) { return pTarget->GetHandle(); }
return NULL;}
_Must_inspect_result___drv_maxIRQL(PASSIVE_LEVEL)NTSTATUSNTAPIWDFEXPORT(WdfDeviceRetrieveDeviceName)( __in PWDF_DRIVER_GLOBALS DriverGlobals, __in WDFDEVICE Device, __in WDFSTRING String ){ DDI_ENTRY();
PFX_DRIVER_GLOBALS pFxDriverGlobals; FxDevice *pDevice; FxString* pString; NTSTATUS status;
FxObjectHandleGetPtrAndGlobals(GetFxDriverGlobals(DriverGlobals), Device, FX_TYPE_DEVICE, (PVOID *) &pDevice, &pFxDriverGlobals);
status = FxVerifierCheckIrqlLevel(pFxDriverGlobals, PASSIVE_LEVEL); if (!NT_SUCCESS(status)) { return status; }
FxObjectHandleGetPtr(pFxDriverGlobals, String, FX_TYPE_STRING, (PVOID*) &pString);
if (pDevice->m_DeviceName.Buffer != NULL) { status = pString->Assign(&pDevice->m_DeviceName); } else { status = STATUS_INVALID_PARAMETER; DoTraceLevelMessage( pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGPNP, "Device name for WDFDEVICE 0x%p is NULL. Possibly incorrect " "device handle was passed, %!STATUS!", Device, status); }
return status;}
__drv_maxIRQL(DISPATCH_LEVEL)VOIDNTAPIWDFEXPORT(WdfDeviceSetCharacteristics)( __in PWDF_DRIVER_GLOBALS DriverGlobals, __in WDFDEVICE Device, __in ULONG DeviceCharacteristics ){ DDI_ENTRY();
FxDevice *pDevice; MxDeviceObject deviceObject;
FxObjectHandleGetPtr(GetFxDriverGlobals(DriverGlobals), Device, FX_TYPE_DEVICE, (PVOID*) &pDevice);
deviceObject.SetObject(pDevice->GetDeviceObject()); deviceObject.SetCharacteristics(DeviceCharacteristics | FILE_DEVICE_SECURE_OPEN);}
__drv_maxIRQL(DISPATCH_LEVEL)ULONGNTAPIWDFEXPORT(WdfDeviceGetCharacteristics)( __in PWDF_DRIVER_GLOBALS DriverGlobals, __in WDFDEVICE Device ){ DDI_ENTRY();
FxDevice *pDevice; MxDeviceObject deviceObject;
FxObjectHandleGetPtr(GetFxDriverGlobals(DriverGlobals), Device, FX_TYPE_DEVICE, (PVOID*) &pDevice);
deviceObject.SetObject(pDevice->GetDeviceObject());
return deviceObject.GetCharacteristics();}
__drv_maxIRQL(DISPATCH_LEVEL)ULONGNTAPIWDFEXPORT(WdfDeviceGetAlignmentRequirement)( __in PWDF_DRIVER_GLOBALS DriverGlobals, __in WDFDEVICE Device ){ DDI_ENTRY();
FxDeviceBase* pDeviceBase; MxDeviceObject deviceObject;
FxObjectHandleGetPtr(GetFxDriverGlobals(DriverGlobals), Device, FX_TYPE_DEVICE_BASE, (PVOID*) &pDeviceBase);
deviceObject.SetObject(pDeviceBase->GetDeviceObject());
return deviceObject.GetAlignmentRequirement();}
__drv_maxIRQL(DISPATCH_LEVEL)VOIDNTAPIWDFEXPORT(WdfDeviceSetAlignmentRequirement)( __in PWDF_DRIVER_GLOBALS DriverGlobals, __in WDFDEVICE Device, __in ULONG AlignmentRequirement ){ DDI_ENTRY();
FxDeviceBase* pDeviceBase; MxDeviceObject deviceObject;
FxObjectHandleGetPtr(GetFxDriverGlobals(DriverGlobals), Device, FX_TYPE_DEVICE_BASE, (PVOID*) &pDeviceBase);
deviceObject.SetObject(pDeviceBase->GetDeviceObject());
deviceObject.SetAlignmentRequirement(AlignmentRequirement);}
__drv_maxIRQL(DISPATCH_LEVEL)WDF_DEVICE_PNP_STATENTAPIWDFEXPORT(WdfDeviceGetDevicePnpState)( __in PWDF_DRIVER_GLOBALS DriverGlobals, __in WDFDEVICE Device ){ DDI_ENTRY();
FxDevice *pDevice;
FxObjectHandleGetPtr(GetFxDriverGlobals(DriverGlobals), Device, FX_TYPE_DEVICE, (PVOID*) &pDevice);
return pDevice->GetDevicePnpState();}
__drv_maxIRQL(DISPATCH_LEVEL)WDF_DEVICE_POWER_STATENTAPIWDFEXPORT(WdfDeviceGetDevicePowerState)( __in PWDF_DRIVER_GLOBALS DriverGlobals, __in WDFDEVICE Device ){ DDI_ENTRY();
FxDevice *pDevice;
FxObjectHandleGetPtr(GetFxDriverGlobals(DriverGlobals), Device, FX_TYPE_DEVICE, (PVOID*) &pDevice);
return pDevice->GetDevicePowerState();}
__drv_maxIRQL(DISPATCH_LEVEL)WDF_DEVICE_POWER_POLICY_STATENTAPIWDFEXPORT(WdfDeviceGetDevicePowerPolicyState)( __in PWDF_DRIVER_GLOBALS DriverGlobals, __in WDFDEVICE Device ){ DDI_ENTRY();
FxDevice *pDevice;
FxObjectHandleGetPtr(GetFxDriverGlobals(DriverGlobals), Device, FX_TYPE_DEVICE, (PVOID*) &pDevice);
return pDevice->GetDevicePowerPolicyState();}
_Must_inspect_result___drv_maxIRQL(DISPATCH_LEVEL)NTSTATUSNTAPIWDFEXPORT(WdfDeviceAssignS0IdleSettings)( __in PWDF_DRIVER_GLOBALS DriverGlobals, __in WDFDEVICE Device, __in PWDF_DEVICE_POWER_POLICY_IDLE_SETTINGS Settings ){ DDI_ENTRY();
PFX_DRIVER_GLOBALS pFxDriverGlobals; NTSTATUS status; FxDevice* pDevice;
FxObjectHandleGetPtrAndGlobals(GetFxDriverGlobals(DriverGlobals), Device, FX_TYPE_DEVICE, (PVOID *) &pDevice, &pFxDriverGlobals);
FxPointerNotNull(pFxDriverGlobals, Settings);
if (pDevice->m_PkgPnp->IsPowerPolicyOwner() == FALSE) { status = STATUS_INVALID_DEVICE_REQUEST;
DoTraceLevelMessage( pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGPNP, "Device 0x%p is not the power policy owner, caller cannot set S0" " idle settings %!STATUS!", Device, status);
return status; }
// // Validate the Settings parameter // if (Settings->Size != sizeof(WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS) && Settings->Size != sizeof(WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_V1_9) && Settings->Size != sizeof(WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_V1_7)) { status = STATUS_INFO_LENGTH_MISMATCH; DoTraceLevelMessage( pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE, "Expected Settings Size %d, got %d, %!STATUS!", sizeof(WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS), Settings->Size, status); return status; } else if (Settings->DxState < PowerDeviceD1 || Settings->DxState > PowerDeviceMaximum || Settings->IdleCaps < IdleCannotWakeFromS0 || Settings->IdleCaps > IdleUsbSelectiveSuspend || Settings->UserControlOfIdleSettings < IdleDoNotAllowUserControl || Settings->UserControlOfIdleSettings > IdleAllowUserControl || Settings->Enabled < WdfFalse || Settings->Enabled > WdfUseDefault) {
status = STATUS_INVALID_PARAMETER; DoTraceLevelMessage( pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE, "a field (DxState, IdleCaps, Enabled, or UserControlOfIdleSettings)" " is out range, %!STATUS!", status); return status; }
// // PowerUpIdleDeviceOnSystemWake is available only on > 1.7 and can be set to true // only when IdleCaps is IdleCannotWakeFromS0 // if (Settings->Size > sizeof(WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_V1_7)) { if (Settings->PowerUpIdleDeviceOnSystemWake < WdfFalse || Settings->PowerUpIdleDeviceOnSystemWake > WdfUseDefault) {
status = STATUS_INVALID_PARAMETER; DoTraceLevelMessage( pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE, "value of field PowerUpIdleDeviceOnSystemWake is out of range," " %!STATUS!", status); return status; } else if (Settings->IdleCaps != IdleCannotWakeFromS0 && Settings->PowerUpIdleDeviceOnSystemWake != WdfUseDefault) {
status = STATUS_INVALID_PARAMETER; DoTraceLevelMessage( pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE, "value of field PowerUpIdleDeviceOnSystemWake should be set only when" " IdleCaps is IdleCannotWakeFromS0, %!STATUS!", status); return status; } }
// // IdleTimeoutType is available only on > 1.9 // if (Settings->Size > sizeof(WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_V1_9)) { if (Settings->IdleTimeoutType > SystemManagedIdleTimeoutWithHint) { status = STATUS_INVALID_PARAMETER; DoTraceLevelMessage( pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE, "WDFDEVICE %p, value of field IdleTimeoutType is out of range," " %!STATUS!", Device, status); return status; } }
return pDevice->m_PkgPnp->PowerPolicySetS0IdleSettings(Settings);}
_Must_inspect_result___drv_maxIRQL(DISPATCH_LEVEL)NTSTATUSNTAPIWDFEXPORT(WdfDeviceAssignSxWakeSettings)( __in PWDF_DRIVER_GLOBALS DriverGlobals, __in WDFDEVICE Device, __in PWDF_DEVICE_POWER_POLICY_WAKE_SETTINGS Settings ){ DDI_ENTRY();
NTSTATUS status; FxDevice* pDevice; PFX_DRIVER_GLOBALS pFxDriverGlobals; BOOLEAN armForWakeIfChildrenAreArmedForWake; BOOLEAN indicateChildWakeOnParentWake;
FxObjectHandleGetPtrAndGlobals(GetFxDriverGlobals(DriverGlobals), Device, FX_TYPE_DEVICE, (PVOID *) &pDevice, &pFxDriverGlobals);
FxPointerNotNull(pFxDriverGlobals, Settings);
if (pDevice->m_PkgPnp->IsPowerPolicyOwner() == FALSE) { status = STATUS_INVALID_DEVICE_REQUEST;
DoTraceLevelMessage( pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGPNP, "Device 0x%p is not the power policy owner, caller cannot set Sx" " wake settings %!STATUS!", Device, status);
return status; }
// // Validate the Settings parameter // if (Settings->Size != sizeof(WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS) && Settings->Size != sizeof(WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS_V1_5)) { status = STATUS_INFO_LENGTH_MISMATCH; DoTraceLevelMessage(pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE, "Expected Settings Size %x, got %x, %!STATUS!", sizeof(WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS), Settings->Size, status); return status; } else if (Settings->DxState < PowerDeviceD1 || Settings->DxState > PowerDeviceMaximum || Settings->UserControlOfWakeSettings < WakeDoNotAllowUserControl || Settings->UserControlOfWakeSettings > WakeAllowUserControl || Settings->Enabled < WdfFalse || Settings->Enabled > WdfUseDefault) {
status = STATUS_INVALID_PARAMETER; DoTraceLevelMessage( pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE, "a field (DxState, Enabled, or UserControlOfIdleSettings) is out " "range, %!STATUS!", status); return status; }
// // Extract the values from the structure for all the parameters that were // added after v1.5. Since the size of the structure can only grow, get // the values only if we are using a version of the struct after v1.5 //
// // ArmForWakeIfChildrenAreArmedForWake added after v1.5 // armForWakeIfChildrenAreArmedForWake = (Settings->Size > sizeof(WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS_V1_5)) ? Settings->ArmForWakeIfChildrenAreArmedForWake : FALSE;
// // IndicateChildWakeOnParentWake added after v1.5 // indicateChildWakeOnParentWake = (Settings->Size > sizeof(WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS_V1_5)) ? Settings->IndicateChildWakeOnParentWake : FALSE;
return pDevice->m_PkgPnp->PowerPolicySetSxWakeSettings( Settings, armForWakeIfChildrenAreArmedForWake, indicateChildWakeOnParentWake);}
_Must_inspect_result___drv_maxIRQL(PASSIVE_LEVEL)NTSTATUSNTAPIWDFEXPORT(WdfDeviceOpenRegistryKey)( __in PWDF_DRIVER_GLOBALS DriverGlobals, __in WDFDEVICE Device, __in ULONG DeviceInstanceKeyType, __in ACCESS_MASK DesiredAccess, __in_opt PWDF_OBJECT_ATTRIBUTES KeyAttributes, __out WDFKEY* Key ){ DDI_ENTRY();
NTSTATUS status; FxDevice* pDevice; PFX_DRIVER_GLOBALS pFxDriverGlobals;
FxObjectHandleGetPtrAndGlobals(GetFxDriverGlobals(DriverGlobals), Device, FX_TYPE_DEVICE, (PVOID *) &pDevice, &pFxDriverGlobals);
FxPointerNotNull(pFxDriverGlobals, Key);
*Key = NULL;
status = FxVerifierCheckIrqlLevel(pFxDriverGlobals, PASSIVE_LEVEL); if (!NT_SUCCESS(status)) { FxVerifierDbgBreakPoint(pFxDriverGlobals); return status; }
status = FxValidateObjectAttributes(pFxDriverGlobals, KeyAttributes, FX_VALIDATE_OPTION_PARENT_NOT_ALLOWED); if (!NT_SUCCESS(status)) {
return status; }
return FxDevice::_OpenKey(pDevice->GetDriverGlobals(), NULL, pDevice, DeviceInstanceKeyType, DesiredAccess, KeyAttributes, Key);}
_Must_inspect_result__IRQL_requires_max_(PASSIVE_LEVEL)NTSTATUSNTAPIWDFEXPORT(WdfDeviceOpenDevicemapKey) ( _In_ PWDF_DRIVER_GLOBALS DriverGlobals, _In_ WDFDEVICE Device, _In_ PCUNICODE_STRING KeyName, _In_ ACCESS_MASK DesiredAccess, _In_opt_ PWDF_OBJECT_ATTRIBUTES KeyAttributes, _Out_ WDFKEY* Key ){ DDI_ENTRY();
NTSTATUS status; FxDevice* pDevice; PFX_DRIVER_GLOBALS pFxDriverGlobals; FxRegKey* pKey = NULL; WDFKEY keyHandle;
FxObjectHandleGetPtrAndGlobals(GetFxDriverGlobals(DriverGlobals), Device, FX_TYPE_DEVICE, (PVOID *) &pDevice, &pFxDriverGlobals);
FxPointerNotNull(pFxDriverGlobals, Key);
*Key = NULL;
status = FxValidateUnicodeString(pFxDriverGlobals, KeyName); if (!NT_SUCCESS(status)) { return status; }
if (KeyName->Length == 0) { status = STATUS_INVALID_PARAMETER; DoTraceLevelMessage( pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE, "The subkey cannot be of length zero, %!STATUS!", status); return status; }
status = FxVerifierCheckIrqlLevel(pFxDriverGlobals, PASSIVE_LEVEL); if (!NT_SUCCESS(status)) { FxVerifierDbgBreakPoint(pFxDriverGlobals); return status; }
status = FxValidateObjectAttributes(pFxDriverGlobals, KeyAttributes, FX_VALIDATE_OPTION_PARENT_NOT_ALLOWED); if (!NT_SUCCESS(status)) { return status; }
pKey = new(pFxDriverGlobals, KeyAttributes) FxRegKey(pFxDriverGlobals);
if (pKey == NULL) { status = STATUS_INSUFFICIENT_RESOURCES; DoTraceLevelMessage( pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE, "Unable to allocate memory for WDFKEY object, %!STATUS!", status); return status; }
pKey->SetDeviceBase(pDevice);
status = pKey->Commit(KeyAttributes, (WDFOBJECT*)&keyHandle); if (NT_SUCCESS(status)) {
status = pDevice->OpenDevicemapKeyWorker(pFxDriverGlobals, KeyName, DesiredAccess, pKey); if (NT_SUCCESS(status)) { *Key = keyHandle; } }
if (!NT_SUCCESS(status)) { pKey->DeleteFromFailedCreate(); pKey = NULL; }
return status;}
__drv_maxIRQL(DISPATCH_LEVEL)VOIDNTAPIWDFEXPORT(WdfDeviceGetDeviceState)( __in PWDF_DRIVER_GLOBALS DriverGlobals, __in WDFDEVICE Device, __out PWDF_DEVICE_STATE DeviceState ){ DDI_ENTRY();
FxDevice *pDevice; PFX_DRIVER_GLOBALS pFxDriverGlobals;
FxObjectHandleGetPtrAndGlobals(GetFxDriverGlobals(DriverGlobals), Device, FX_TYPE_DEVICE, (PVOID *) &pDevice, &pFxDriverGlobals);
FxPointerNotNull(pFxDriverGlobals, DeviceState);
if (DeviceState->Size != sizeof(WDF_DEVICE_STATE)) { DoTraceLevelMessage( pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE, "WDFDEVICE 0x%p DeviceState Size %d, expected %d", Device, DeviceState->Size, sizeof(WDF_DEVICE_STATE));
FxVerifierDbgBreakPoint(pFxDriverGlobals);
return; // STATUS_INFO_LENGTH_MISMATCH; }
pDevice->m_PkgPnp->GetPnpState(DeviceState);}
__drv_maxIRQL(DISPATCH_LEVEL)VOIDNTAPIWDFEXPORT(WdfDeviceSetDeviceState)( __in PWDF_DRIVER_GLOBALS DriverGlobals, __in WDFDEVICE Device, __in PWDF_DEVICE_STATE DeviceState ){ DDI_ENTRY();
FxDevice *pDevice; PFX_DRIVER_GLOBALS pFxDriverGlobals; ULONG i;
const static FxOffsetAndName offsets[] = { OFFSET_AND_NAME(WDF_DEVICE_STATE, Disabled), OFFSET_AND_NAME(WDF_DEVICE_STATE, DontDisplayInUI), OFFSET_AND_NAME(WDF_DEVICE_STATE, Failed), OFFSET_AND_NAME(WDF_DEVICE_STATE, NotDisableable), OFFSET_AND_NAME(WDF_DEVICE_STATE, Removed), OFFSET_AND_NAME(WDF_DEVICE_STATE, ResourcesChanged), };
FxObjectHandleGetPtrAndGlobals(GetFxDriverGlobals(DriverGlobals), Device, FX_TYPE_DEVICE, (PVOID *) &pDevice, &pFxDriverGlobals);
FxPointerNotNull(pFxDriverGlobals, DeviceState);
if (DeviceState->Size != sizeof(WDF_DEVICE_STATE)) { DoTraceLevelMessage( pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE, "WDFDEVICE 0x%p, DeviceState Size %d, expected %d", Device, DeviceState->Size, sizeof(WDF_DEVICE_STATE));
FxVerifierDbgBreakPoint(pFxDriverGlobals); return; // STATUS_INFO_LENGTH_MISMATCH; }
for (i = 0; i < ARRAY_SIZE(offsets); i++) { WDF_TRI_STATE value;
// // This check makes prefast happy // if (offsets[i].Offset + sizeof(WDF_TRI_STATE) > sizeof(*DeviceState)) { return; }
value = *(WDF_TRI_STATE*) WDF_PTR_ADD_OFFSET(DeviceState, offsets[i].Offset);
switch (value) { case WdfFalse: case WdfTrue: case WdfUseDefault: break;
default: DoTraceLevelMessage( pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE, "WDFDEVICE 0x%p DeviceState WDF_TRI_STATE %s value out of range, " "value is %d", Device, offsets[i].Name, value); FxVerifierDbgBreakPoint(pFxDriverGlobals);
return; // STATUS_INVALID_PARAMETER } }
pDevice->m_PkgPnp->SetPnpState(DeviceState);
pDevice->InvalidateDeviceState();}
_Must_inspect_result___drv_maxIRQL(PASSIVE_LEVEL)NTSTATUSNTAPIWDFEXPORT(WdfDeviceCreate)( __in PWDF_DRIVER_GLOBALS DriverGlobals,
__inout
PWDFDEVICE_INIT* DeviceInit, __in_opt PWDF_OBJECT_ATTRIBUTES DeviceAttributes, __out WDFDEVICE* Device ){ DDI_ENTRY();
FxDevice* pDevice; NTSTATUS status; PFX_DRIVER_GLOBALS pFxDriverGlobals;
pFxDriverGlobals = GetFxDriverGlobals(DriverGlobals);
FxPointerNotNull(pFxDriverGlobals, DeviceInit); FxPointerNotNull(pFxDriverGlobals, *DeviceInit); FxPointerNotNull(pFxDriverGlobals, Device);
// // Use the object's globals, not the caller's globals // pFxDriverGlobals = (*DeviceInit)->DriverGlobals;
*Device = NULL;
status = FxVerifierCheckIrqlLevel(pFxDriverGlobals, PASSIVE_LEVEL); if (!NT_SUCCESS(status)) { return status; }
// // Make sure the device attributes is initialized properly if passed in // status = FxValidateObjectAttributes(pFxDriverGlobals, DeviceAttributes, (FX_VALIDATE_OPTION_PARENT_NOT_ALLOWED | FX_VALIDATE_OPTION_EXECUTION_LEVEL_ALLOWED | FX_VALIDATE_OPTION_SYNCHRONIZATION_SCOPE_ALLOWED));
if (!NT_SUCCESS(status)) { return status; }
if ((*DeviceInit)->CreatedDevice != NULL) { // // Already created the device! // DoTraceLevelMessage(pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE, "WDFDEVICE 0x%p already created" "STATUS_INVALID_DEVICE_STATE", Device);
return STATUS_INVALID_DEVICE_STATE; }
// // If security is specified, then the device being created *must* have a // name to apply that security too. // if ((*DeviceInit)->Security.Sddl != NULL || (*DeviceInit)->Security.DeviceClassSet) { if ((*DeviceInit)->HasName()) { // // Driver writer specified a name, all is good // DO_NOTHING(); } else { status = STATUS_INVALID_SECURITY_DESCR;
DoTraceLevelMessage( pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE, "Device init: has device class or SDDL set, but does not have " "a name, %!STATUS!", status);
return status; } }
if ((*DeviceInit)->RequiresSelfIoTarget) { if ((*DeviceInit)->InitType != FxDeviceInitTypeFdo) { status = STATUS_INVALID_DEVICE_REQUEST; DoTraceLevelMessage( pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE, "Client called WdfDeviceInitAllowSelfTarget. Self " "IO Targets are supported only for FDOs, %!STATUS!", status); return status; } }
status = FxDevice::_Create(pFxDriverGlobals, DeviceInit, DeviceAttributes, &pDevice); if (NT_SUCCESS(status)) { *Device = pDevice->GetHandle(); }
return status;}
_Must_inspect_result___drv_maxIRQL(PASSIVE_LEVEL)NTSTATUSNTAPIWDFEXPORT(WdfDeviceCreateSymbolicLink)( __in PWDF_DRIVER_GLOBALS DriverGlobals, __in WDFDEVICE Device, __in PCUNICODE_STRING SymbolicLinkName ){ DDI_ENTRY();
PFX_DRIVER_GLOBALS pFxDriverGlobals; FxAutoString pdoName; FxDevice* pDevice; NTSTATUS status;
FxObjectHandleGetPtrAndGlobals(GetFxDriverGlobals(DriverGlobals), Device, FX_TYPE_DEVICE, (PVOID *) &pDevice, &pFxDriverGlobals);
FxPointerNotNull(pFxDriverGlobals, SymbolicLinkName);
if (SymbolicLinkName->Length == 0) { status = STATUS_INVALID_DEVICE_REQUEST;
DoTraceLevelMessage(pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE, "WDFDEVICE %p, SymbolicLinkName has no length, %!STATUS!", Device, status);
return status; }
status = FxVerifierCheckIrqlLevel(pFxDriverGlobals, PASSIVE_LEVEL); if (!NT_SUCCESS(status)) { return status; }
status = FxValidateUnicodeString(pFxDriverGlobals, SymbolicLinkName); if (!NT_SUCCESS(status)) { return status; }
if (pDevice->m_SymbolicLinkName.Buffer != NULL) { status = STATUS_INVALID_DEVICE_REQUEST;
DoTraceLevelMessage( pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE, "WDFDEVICE %p already has a symbolic link associated with it, %!STATUS!", Device, status);
return status; }
status = pDevice->CreateSymbolicLink(pFxDriverGlobals, SymbolicLinkName);
return status;}
_Must_inspect_result___drv_maxIRQL(PASSIVE_LEVEL)NTSTATUSNTAPIWDFEXPORT(WdfDeviceQueryProperty)( __in PWDF_DRIVER_GLOBALS DriverGlobals, __in WDFDEVICE Device, __in DEVICE_REGISTRY_PROPERTY DeviceProperty, __in ULONG BufferLength, __out_bcount_full(BufferLength) PVOID PropertyBuffer, __out PULONG ResultLength )/*++
Routine Description: Retrieves the requested device property for the given device
Arguments: Device - the device whose PDO whose will be queried
DeviceProperty - the property being queried
BufferLength - length of PropertyBuffer in bytes
PropertyBuffer - Buffer which will receive the property being queried
ResultLength - if STATUS_BUFFER_TOO_SMALL is returned, then this will contain the required length
Return Value: NTSTATUS
--*/{ DDI_ENTRY();
PFX_DRIVER_GLOBALS pFxDriverGlobals; FxDevice* pDevice; NTSTATUS status;
FxObjectHandleGetPtrAndGlobals(GetFxDriverGlobals(DriverGlobals), Device, FX_TYPE_DEVICE, (PVOID *) &pDevice, &pFxDriverGlobals);
FxPointerNotNull(pFxDriverGlobals, ResultLength); if (BufferLength > 0) { FxPointerNotNull(pFxDriverGlobals, PropertyBuffer); }
status = FxVerifierCheckIrqlLevel(pFxDriverGlobals, PASSIVE_LEVEL); if (!NT_SUCCESS(status)) { return status; }
if (pDevice->IsLegacy()) { status = STATUS_INVALID_DEVICE_REQUEST;
DoTraceLevelMessage(pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE, "WDFDEVICE 0x%p is not a PnP device %!STATUS!", Device, status);
return status; }
status = FxDevice::_QueryProperty(pFxDriverGlobals, NULL, pDevice, NULL, DeviceProperty, BufferLength, PropertyBuffer, ResultLength);
DoTraceLevelMessage(pFxDriverGlobals, TRACE_LEVEL_VERBOSE, TRACINGDEVICE, "exit WDFDEVICE %p, Property %d, %!STATUS!", Device, DeviceProperty, status);
return status;}
_Must_inspect_result___drv_maxIRQL(PASSIVE_LEVEL)NTSTATUSNTAPIWDFEXPORT(WdfDeviceAllocAndQueryProperty)( __in PWDF_DRIVER_GLOBALS DriverGlobals, __in WDFDEVICE Device, __in DEVICE_REGISTRY_PROPERTY DeviceProperty, __in __drv_strictTypeMatch(__drv_typeExpr) POOL_TYPE PoolType, __in_opt PWDF_OBJECT_ATTRIBUTES PropertyMemoryAttributes, __out WDFMEMORY* PropertyMemory )/*++
Routine Description: Allocates and retrieves the requested device property for the given device
Arguments: Device - the pnp device whose PDO whose will be queried
DeviceProperty - the property being queried
PoolType - what type of pool to allocate
PropertyMemoryAttributes - attributes to associate with PropertyMemory
PropertyMemory - handle which will receive the property buffer
Return Value: NTSTATUS
--*/{ DDI_ENTRY();
PFX_DRIVER_GLOBALS pFxDriverGlobals; FxDevice* pDevice; NTSTATUS status;
FxObjectHandleGetPtrAndGlobals(GetFxDriverGlobals(DriverGlobals), Device, FX_TYPE_DEVICE, (PVOID *) &pDevice, &pFxDriverGlobals);
FxPointerNotNull(pFxDriverGlobals, PropertyMemory);
*PropertyMemory = NULL;
status = FxVerifierCheckIrqlLevel(pFxDriverGlobals, PASSIVE_LEVEL); if (!NT_SUCCESS(status)) { return status; }
FxVerifierCheckNxPoolType(pFxDriverGlobals, PoolType, pFxDriverGlobals->Tag);
status = FxValidateObjectAttributes(pFxDriverGlobals, PropertyMemoryAttributes); if (!NT_SUCCESS(status)) { return status; }
if (pDevice->IsLegacy()) { status = STATUS_INVALID_DEVICE_REQUEST;
DoTraceLevelMessage(pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE, "WDFDEVICE %p is not a PnP device, %!STATUS!", Device, status);
return status; }
status = FxDevice::_AllocAndQueryProperty(pFxDriverGlobals, NULL, pDevice, NULL, DeviceProperty, PoolType, PropertyMemoryAttributes, PropertyMemory);
DoTraceLevelMessage(pFxDriverGlobals, TRACE_LEVEL_VERBOSE, TRACINGDEVICE, "exit WDFDEVICE %p, Property %d, %!STATUS!", Device, DeviceProperty, status);
return status;}
__drv_maxIRQL(DISPATCH_LEVEL)VOIDNTAPIWDFEXPORT(WdfDeviceSetStaticStopRemove)( __in PWDF_DRIVER_GLOBALS DriverGlobals, __in WDFDEVICE Device, __in BOOLEAN Stoppable ){ DDI_ENTRY();
FxDevice *pDevice;
FxObjectHandleGetPtr(GetFxDriverGlobals(DriverGlobals), Device, FX_TYPE_DEVICE, (PVOID*) &pDevice);
if (Stoppable) { // // Stoppable means that query stop / query remove can succeed. // This means m_DeviceStopCount == 0 (eventually if there are nested // calls to this function). // ASSERT(pDevice->m_PkgPnp->m_DeviceStopCount > 0); InterlockedDecrement((PLONG) &pDevice->m_PkgPnp->m_DeviceStopCount); } else { InterlockedIncrement((PLONG) &pDevice->m_PkgPnp->m_DeviceStopCount); }
return;}
__drv_maxIRQL(DISPATCH_LEVEL)VOIDNTAPIWDFEXPORT(WdfDeviceSetFailed)( __in PWDF_DRIVER_GLOBALS DriverGlobals, __in WDFDEVICE Device, __in WDF_DEVICE_FAILED_ACTION FailedAction ){ DDI_ENTRY();
PFX_DRIVER_GLOBALS pFxDriverGlobals; FxDevice *pDevice;
FxObjectHandleGetPtrAndGlobals(GetFxDriverGlobals(DriverGlobals), Device, FX_TYPE_DEVICE, (PVOID *) &pDevice, &pFxDriverGlobals);
if (FailedAction < WdfDeviceFailedAttemptRestart || FailedAction > WdfDeviceFailedNoRestart) { DoTraceLevelMessage( pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE, "Invalid FailedAction %d", FailedAction); FxVerifierDbgBreakPoint(pDevice->GetDriverGlobals()); return; }
DoTraceLevelMessage( pFxDriverGlobals, TRACE_LEVEL_INFORMATION, TRACINGDEVICE, "WDFDEVICE %p, !devobj %p SetFailed %!WDF_DEVICE_FAILED_ACTION!", Device, pDevice->GetDeviceObject(), FailedAction);
pDevice->m_PkgPnp->SetDeviceFailed(FailedAction);}
__inlineNTSTATUSStopIdleWorker( __in PWDF_DRIVER_GLOBALS DriverGlobals, __in WDFDEVICE Device, __in BOOLEAN WaitForD0, __in PVOID Tag, __in LONG Line, __in PSTR File ){ PFX_DRIVER_GLOBALS pFxDriverGlobals; NTSTATUS status; FxDevice *pDevice;
FxObjectHandleGetPtrAndGlobals(GetFxDriverGlobals(DriverGlobals), Device, FX_TYPE_DEVICE, (PVOID *) &pDevice, &pFxDriverGlobals);
if (WaitForD0) { status = FxVerifierCheckIrqlLevel(pFxDriverGlobals, PASSIVE_LEVEL); if (!NT_SUCCESS(status)) { return status; } }
if (pDevice->m_PkgPnp->IsPowerPolicyOwner() == FALSE) { status = STATUS_INVALID_DEVICE_STATE; DoTraceLevelMessage( pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE, "WDFDEVICE %p WdfDeviceStopIdle does nothing if you are not the power " "policy owner for the stack, %!STATUS!", Device, status); return status; }
status = pDevice->m_PkgPnp->PowerReference(WaitForD0, Tag, Line, File);
DoTraceLevelMessage( pFxDriverGlobals, TRACE_LEVEL_VERBOSE, TRACINGDEVICE, "WDFDEVICE %p WdfDeviceStopIdle, WaitForD0 %d %!STATUS!", Device, WaitForD0, status);
return status;}
__inlineVOIDResumeIdleWorker( __in PWDF_DRIVER_GLOBALS DriverGlobals, __in WDFDEVICE Device, __in PVOID Tag, __in LONG Line, __in PSTR File ){ PFX_DRIVER_GLOBALS pFxDriverGlobals; FxDevice *pDevice;
FxObjectHandleGetPtrAndGlobals(GetFxDriverGlobals(DriverGlobals), Device, FX_TYPE_DEVICE, (PVOID *) &pDevice, &pFxDriverGlobals);
if (pDevice->m_PkgPnp->IsPowerPolicyOwner() == FALSE) { DoTraceLevelMessage( pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE, "WdfDeviceResumeIdle does nothing if you are not the power " "policy owner for the stack"); return; }
pDevice->m_PkgPnp->PowerDereference(Tag, Line, File);}
_Must_inspect_result___drv_when(WaitForD0 == 0, __drv_maxIRQL(DISPATCH_LEVEL))__drv_when(WaitForD0 != 0, __drv_maxIRQL(PASSIVE_LEVEL))NTSTATUSNTAPIWDFEXPORT(WdfDeviceStopIdleNoTrack)( __in PWDF_DRIVER_GLOBALS DriverGlobals, __in WDFDEVICE Device, __in BOOLEAN WaitForD0 ){ DDI_ENTRY();
NTSTATUS status;
status = StopIdleWorker(DriverGlobals, Device, WaitForD0, NULL, 0, NULL);
return status;}
_Must_inspect_result___drv_when(WaitForD0 == 0, __drv_maxIRQL(DISPATCH_LEVEL))__drv_when(WaitForD0 != 0, __drv_maxIRQL(PASSIVE_LEVEL))NTSTATUSNTAPIWDFEXPORT(WdfDeviceStopIdleActual)( __in PWDF_DRIVER_GLOBALS DriverGlobals, __in WDFDEVICE Device, __in BOOLEAN WaitForD0, __in_opt PVOID Tag, __in LONG Line, __in PSTR File ){ DDI_ENTRY();
NTSTATUS status;
status = StopIdleWorker(DriverGlobals, Device, WaitForD0, Tag, Line, File);
return status;}
__drv_maxIRQL(DISPATCH_LEVEL)VOIDNTAPIWDFEXPORT(WdfDeviceResumeIdleNoTrack)( __in PWDF_DRIVER_GLOBALS DriverGlobals, __in WDFDEVICE Device ){ DDI_ENTRY();
ResumeIdleWorker(DriverGlobals, Device, NULL, 0, NULL);}
__drv_maxIRQL(DISPATCH_LEVEL)VOIDNTAPIWDFEXPORT(WdfDeviceResumeIdleActual)( __in PWDF_DRIVER_GLOBALS DriverGlobals, __in WDFDEVICE Device, __in_opt PVOID Tag, __in LONG Line, __in PSTR File ){ DDI_ENTRY();
ResumeIdleWorker(DriverGlobals, Device, Tag, Line, File);}
__drv_maxIRQL(DISPATCH_LEVEL)VOIDNTAPIWDFEXPORT(WdfDeviceSetPnpCapabilities)( __in PWDF_DRIVER_GLOBALS DriverGlobals, __in WDFDEVICE Device, __in PWDF_DEVICE_PNP_CAPABILITIES PnpCapabilities )/*++
Routine Description: Sets the pnp capabilities of the device. This function is usually called during AddDevice or EvtDevicePrepareHardware since these values are queried by the stack and pnp during start device processing or immediately afterwards.
Arguments: Device - Device being set
PnpCapabilities - Caps being set
Return Value: None
--*/{ DDI_ENTRY();
PFX_DRIVER_GLOBALS pFxDriverGlobals; FxDevice* pDevice; ULONG i;
const static FxOffsetAndName offsets[] = { OFFSET_AND_NAME(WDF_DEVICE_PNP_CAPABILITIES, LockSupported), OFFSET_AND_NAME(WDF_DEVICE_PNP_CAPABILITIES, EjectSupported), OFFSET_AND_NAME(WDF_DEVICE_PNP_CAPABILITIES, Removable), OFFSET_AND_NAME(WDF_DEVICE_PNP_CAPABILITIES, DockDevice), OFFSET_AND_NAME(WDF_DEVICE_PNP_CAPABILITIES, UniqueID), OFFSET_AND_NAME(WDF_DEVICE_PNP_CAPABILITIES, SilentInstall), OFFSET_AND_NAME(WDF_DEVICE_PNP_CAPABILITIES, SurpriseRemovalOK), OFFSET_AND_NAME(WDF_DEVICE_PNP_CAPABILITIES, HardwareDisabled), OFFSET_AND_NAME(WDF_DEVICE_PNP_CAPABILITIES, NoDisplayInUI), };
FxObjectHandleGetPtrAndGlobals(GetFxDriverGlobals(DriverGlobals), Device, FX_TYPE_DEVICE, (PVOID *) &pDevice, &pFxDriverGlobals);
FxPointerNotNull(pFxDriverGlobals, PnpCapabilities);
if (PnpCapabilities->Size != sizeof(WDF_DEVICE_PNP_CAPABILITIES)) { DoTraceLevelMessage( pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE, "WDFDEVICE 0x%p PnpCapabilities Size %d, expected %d", Device, PnpCapabilities->Size, sizeof(WDF_DEVICE_PNP_CAPABILITIES)); FxVerifierDbgBreakPoint(pFxDriverGlobals);
return; // STATUS_INFO_LENGTH_MISMATCH; } else { for (i = 0; i < ARRAY_SIZE(offsets); i++) { WDF_TRI_STATE value;
// // This check makes prefast happy // if (offsets[i].Offset + sizeof(WDF_TRI_STATE) > sizeof(*PnpCapabilities)) { return; }
value = *(WDF_TRI_STATE*) WDF_PTR_ADD_OFFSET(PnpCapabilities, offsets[i].Offset); switch (value) { case WdfFalse: case WdfTrue: case WdfUseDefault: break;
default: DoTraceLevelMessage( pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE, "WDFDEVICE 0x%p PnpCapabilities WDF_TRI_STATE %s value out " "of range, value is %d", Device, offsets[i].Name, value); FxVerifierDbgBreakPoint(pFxDriverGlobals);
return; // STATUS_INVALID_PARAMETER } } }
pDevice->m_PkgPnp->SetPnpCaps(PnpCapabilities);}
__drv_maxIRQL(DISPATCH_LEVEL)VOIDNTAPIWDFEXPORT(WdfDeviceSetPowerCapabilities)( __in PWDF_DRIVER_GLOBALS DriverGlobals, __in WDFDEVICE Device, __in PWDF_DEVICE_POWER_CAPABILITIES PowerCapabilities )/*++
Routine Description: Sets the power capabilities of the device. This function is usually called during AddDevice or EvtDevicePrepareHardware since these values are queried by the stack and power during start device processing or immediately afterwards.
Arguments: Device - Device being set
PowerCapabilities - Caps being set
Return Value: None
--*/{ DDI_ENTRY();
FxDevice* pDevice; ULONG i; PFX_DRIVER_GLOBALS pFxDriverGlobals;
const static FxOffsetAndName offsets[] = { OFFSET_AND_NAME(WDF_DEVICE_POWER_CAPABILITIES, DeviceD1), OFFSET_AND_NAME(WDF_DEVICE_POWER_CAPABILITIES, DeviceD2), OFFSET_AND_NAME(WDF_DEVICE_POWER_CAPABILITIES, WakeFromD0), OFFSET_AND_NAME(WDF_DEVICE_POWER_CAPABILITIES, WakeFromD1), OFFSET_AND_NAME(WDF_DEVICE_POWER_CAPABILITIES, WakeFromD2), OFFSET_AND_NAME(WDF_DEVICE_POWER_CAPABILITIES, WakeFromD3), };
FxObjectHandleGetPtrAndGlobals(GetFxDriverGlobals(DriverGlobals), Device, FX_TYPE_DEVICE, (PVOID *) &pDevice, &pFxDriverGlobals);
FxPointerNotNull(pFxDriverGlobals, PowerCapabilities);
if (PowerCapabilities->Size != sizeof(WDF_DEVICE_POWER_CAPABILITIES)) {
DoTraceLevelMessage( pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE, "WDFDEVICE 0x%p PowerCapabilities Size %d, expected %d", Device, PowerCapabilities->Size, sizeof(WDF_DEVICE_POWER_CAPABILITIES));
FxVerifierDbgBreakPoint(pFxDriverGlobals);
return; // STATUS_INFO_LENGTH_MISMATCH; } else { for (i = 0; i < ARRAY_SIZE(offsets); i++) { WDF_TRI_STATE value;
// // This check makes prefast happy // if (offsets[i].Offset + sizeof(WDF_TRI_STATE) > sizeof(*PowerCapabilities)) { return; }
value = *(WDF_TRI_STATE*) WDF_PTR_ADD_OFFSET(PowerCapabilities, offsets[i].Offset); switch (value) { case WdfFalse: case WdfTrue: case WdfUseDefault: break;
default: DoTraceLevelMessage( pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE, "WDFDEVICE 0x%p PowerCapabilities WDF_TRI_STATE %s value out " "of range, value is %d", Device, offsets[i].Name, value); FxVerifierDbgBreakPoint(pFxDriverGlobals);
return; // STATUS_INVALID_PARAMETER } }
for (i = 0; i < ARRAY_SIZE(PowerCapabilities->DeviceState); i++) { if (PowerCapabilities->DeviceState[i] < PowerDeviceUnspecified || PowerCapabilities->DeviceState[i] > PowerDeviceMaximum) {
DoTraceLevelMessage(pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE, "WDFDEVICE 0x%p PowerCapabilities DeviceState is invalid", Device);
FxVerifierDbgBreakPoint(pFxDriverGlobals);
return; // STATUS_INVALID_PARAMETER; } }
if (PowerCapabilities->DeviceWake < PowerDeviceUnspecified || PowerCapabilities->DeviceWake > PowerDeviceMaximum) {
DoTraceLevelMessage( pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE, "WDFDEVICE 0x%p PowerCapabilities DeviceWake %d is out of range", Device, PowerCapabilities->DeviceWake);
FxVerifierDbgBreakPoint(pFxDriverGlobals);
return; // STATUS_INVALID_PARAMETER; }
if (PowerCapabilities->SystemWake < PowerSystemUnspecified || PowerCapabilities->SystemWake > PowerSystemMaximum) {
DoTraceLevelMessage( pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE, "WDFDEVICE 0x%p PowerCapabilities SystemWake %d is out of range", Device, PowerCapabilities->SystemWake);
FxVerifierDbgBreakPoint(pFxDriverGlobals);
return; // STATUS_INVALID_PARAMETER; }
if (pDevice->m_PkgPnp->IsPowerPolicyOwner() == FALSE && PowerCapabilities->IdealDxStateForSx != PowerDeviceMaximum) { DoTraceLevelMessage( pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE, "WDFDEVICE 0x%p PowerCapabilities IdealDxStateForSx %d can only" " be set by the power policy owner", Device, PowerCapabilities->IdealDxStateForSx);
FxVerifierDbgBreakPoint(pFxDriverGlobals);
return; // STATUS_INVALID_PARAMETER; }
// // D0 is not allowed as an ideal Dx state // if (PowerCapabilities->IdealDxStateForSx < PowerDeviceD1 || PowerCapabilities->IdealDxStateForSx > PowerDeviceMaximum) {
DoTraceLevelMessage( pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE, "WDFDEVICE 0x%p PowerCapabilities IdealDxStateForSx %d is out " "of range", Device, PowerCapabilities->IdealDxStateForSx);
FxVerifierDbgBreakPoint(pFxDriverGlobals);
return; // STATUS_INVALID_PARAMETER; } }
pDevice->m_PkgPnp->SetPowerCaps(PowerCapabilities);}
_Must_inspect_result___drv_maxIRQL(DISPATCH_LEVEL)NTSTATUSNTAPIWDFEXPORT(WdfDeviceConfigureRequestDispatching)( __in PWDF_DRIVER_GLOBALS DriverGlobals, __in WDFDEVICE Device, __in WDFQUEUE Queue, __in __drv_strictTypeMatch(__drv_typeCond) WDF_REQUEST_TYPE RequestType )
/*++
Routine Description:
Configure which IRP_MJ_* requests are automatically forwarded by the I/O package to the specified Queue.
By default the I/O package sends all requests to the devices default queue. This API allows certain requests to be specified to their own queues under driver control.
Arguments:
Device - The device which is handling the IO.
Queue - I/O Queue object to forward specified request to.
RequestType - WDF Request type to be forwarded to the queue
Returns:
NTSTATUS
--*/
{ DDI_ENTRY();
PFX_DRIVER_GLOBALS pFxDriverGlobals; NTSTATUS status; FxDevice* pDevice; FxIoQueue* pFxIoQueue;
pDevice = NULL; pFxIoQueue = NULL;
FxObjectHandleGetPtrAndGlobals(GetFxDriverGlobals(DriverGlobals), Device, FX_TYPE_DEVICE, (PVOID *) &pDevice, &pFxDriverGlobals);
if (RequestType != WdfRequestTypeCreate && RequestType != WdfRequestTypeRead && RequestType != WdfRequestTypeWrite && RequestType != WdfRequestTypeDeviceControl && RequestType != WdfRequestTypeDeviceControlInternal) { status = STATUS_INVALID_PARAMETER; DoTraceLevelMessage(pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGIO, "Invalid RequestType %!WDF_REQUEST_TYPE!, %!STATUS!", RequestType, status); return status; }
// // Validate the Queue handle // FxObjectHandleGetPtr(pFxDriverGlobals, Queue, FX_TYPE_QUEUE, (PVOID*)&pFxIoQueue);
if (pDevice != pFxIoQueue->GetDevice()) { status = STATUS_INVALID_DEVICE_REQUEST;
DoTraceLevelMessage( pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGIO, "Input WDFQUEUE 0x%p doesn't belong to the WDFDEVICE 0x%p, %!STATUS!", Queue, Device, status);
return status; }
if (pDevice->IsLegacy()) { // // This is a controldevice. Make sure the create is called after the device // is initialized and ready to accept I/O. // MxDeviceObject deviceObject(pDevice->GetDeviceObject()); if ((deviceObject.GetFlags() & DO_DEVICE_INITIALIZING) == 0x0) {
status = STATUS_INVALID_DEVICE_STATE; DoTraceLevelMessage( pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGPNP, "Queue cannot be configured for automatic dispatching" " after WdfControlDeviceFinishInitializing" "is called on the WDFDEVICE %p is called %!STATUS!", Device, status); return status; } } else { // // This is either FDO or PDO. Make sure it's not started yet. // if (pDevice->GetDevicePnpState() != WdfDevStatePnpInit) { status = STATUS_INVALID_DEVICE_STATE; DoTraceLevelMessage( pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGPNP, "Queue cannot be configured for automatic dispatching" "after the WDFDEVICE %p is started, %!STATUS!", Device, status); return status; } }
if (RequestType == WdfRequestTypeCreate) { status = pDevice->m_PkgGeneral->ConfigureForwarding(pFxIoQueue); } else { status = pDevice->m_PkgIo->ConfigureForwarding(pFxIoQueue, RequestType); }
return status;}
__drv_maxIRQL(DISPATCH_LEVEL)WDFQUEUENTAPIWDFEXPORT(WdfDeviceGetDefaultQueue)( __in PWDF_DRIVER_GLOBALS DriverGlobals, __in WDFDEVICE Device )
/*++
Routine Description:
Return the handle to the default queue for the device.
Arguments:
Device - Handle to the Device Object
Returns:
WDFQUEUE
--*/
{ DDI_ENTRY();
FxPkgIo* pPkgIo;; FxIoQueue* pFxIoQueue;; FxDevice * pFxDevice; PFX_DRIVER_GLOBALS pFxDriverGlobals;
pPkgIo = NULL; pFxIoQueue = NULL;
// // Validate the I/O Package handle, and get the FxPkgIo* // FxObjectHandleGetPtrAndGlobals(GetFxDriverGlobals(DriverGlobals), Device, FX_TYPE_DEVICE, (PVOID *) &pFxDevice, &pFxDriverGlobals);
pPkgIo = (FxPkgIo *) pFxDevice->m_PkgIo; pFxIoQueue = pPkgIo->GetDefaultQueue();
// // A default queue is optional // if (pFxIoQueue == NULL) { DoTraceLevelMessage(pFxDriverGlobals, TRACE_LEVEL_WARNING, TRACINGIO, "No default Queue configured " "for Device 0x%p", Device); return NULL; }
return (WDFQUEUE)pFxIoQueue->GetObjectHandle();;}
_Must_inspect_result___drv_maxIRQL(DISPATCH_LEVEL)NTSTATUSNTAPIWDFEXPORT(WdfDeviceEnqueueRequest)( __in PWDF_DRIVER_GLOBALS DriverGlobals, __in WDFDEVICE Device, __in WDFREQUEST Request )
/*++
Routine Description:
Inserts a request into the I/O Package processing pipeline.
The given request is processed by the I/O package, forwarding it to its configured destination or the default queue.
If an EvtIoInCallerContext is callback is registered, it is not called.
Arguments:
Device - Handle to the Device Object
Request - Request to insert in the processing pipeline
Return Value:
STATUS_SUCCESS - Request has been inserted into the I/O processing pipeline
!NT_SUCCESS(status) STATUS_WDF_BUSY - Device is not accepting requests, the driver still owns the the request and must complete it, or correct the conditions.
--*/
{ DDI_ENTRY();
PFX_DRIVER_GLOBALS pFxDriverGlobals; FxDevice *pDevice; FxRequest* pRequest;
// // Validate the device object handle // FxObjectHandleGetPtrAndGlobals(GetFxDriverGlobals(DriverGlobals), Device, FX_TYPE_DEVICE, (PVOID *) &pDevice, &pFxDriverGlobals); // // Validate Device object handle // FxObjectHandleGetPtr(pFxDriverGlobals, Device, FX_TYPE_DEVICE, (PVOID *) &pDevice);
// // Validate the request object handle // FxObjectHandleGetPtr(pFxDriverGlobals, Request, FX_TYPE_REQUEST, (PVOID *) &pRequest);
// // Dispatch it to the Io Package object // return pDevice->m_PkgIo->EnqueueRequest(pDevice, pRequest);}
__drv_maxIRQL(DISPATCH_LEVEL)POWER_ACTIONNTAPIWDFEXPORT(WdfDeviceGetSystemPowerAction)( __in PWDF_DRIVER_GLOBALS DriverGlobals, __in WDFDEVICE Device )
/*++
Routine Description:
This DDI returns the System power action.
If the DDI is called in the power down path of a device, it will return the current system power transition type because of which the device is powering down. If the DDI is called in the power up path of a device, it will return the system power transition type which initially put the device into a lower power state. If the DDI is called during the normal functioning of a device that is not undergoing a power state transition, or if the device is powering up as part of the system start up, the DDI will return the PowerActionNone value.
Arguments:
Device - Handle to the Device Object
Return Value:
Returns a POWER_ACTION enum value that represents the current system power action with regards to any system power transition underway.
--*/
{ DDI_ENTRY();
FxDevice *pDevice;
// // Validate Device object handle // FxObjectHandleGetPtr(GetFxDriverGlobals(DriverGlobals), Device, FX_TYPE_DEVICE, (PVOID*) &pDevice);
return pDevice->m_PkgPnp->GetSystemPowerAction();}
_Must_inspect_result__IRQL_requires_max_(APC_LEVEL)WDFAPINTSTATUSNTAPIWDFEXPORT(WdfDeviceQueryPropertyEx)( _In_ PWDF_DRIVER_GLOBALS DriverGlobals, _In_ WDFDEVICE Device, _In_ PWDF_DEVICE_PROPERTY_DATA DeviceProperty, _In_ ULONG BufferLength, _Out_ PVOID PropertyBuffer, _Out_ PULONG RequiredSize, _Out_ PDEVPROPTYPE Type )/*++
Routine Description:
This routine queries interface property.
Arguments:
DriverGlobals - DriverGlobals pointer
Device - WDF Device handle.
DeviceProperty - A pointer to WDF_DEVICE_PROPERTY_ DATA structure.
BufferLength - The size, in bytes, of the buffer that is pointed to by PropertyBuffer.
PropertyBuffer - A caller-supplied pointer to a caller-allocated buffer that receives the requested information. The pointer can be NULL if the BufferLength parameter is zero.
ResultLength - A caller-supplied location that, on return, contains the size, in bytes, of the information that the method stored in PropertyBuffer. If the function's return value is STATUS_BUFFER_TOO_SMALL, this location receives the required buffer size.
Type - A pointer to a DEVPROPTYPE variable. If method successfully retrieves the property data, the routine writes the property type value to this variable. This value indicates the type of property data that is in the Data buffer.
Return Value:
Method returns an NTSTATUS value. This routine might return one of the following values.
STATUS_BUFFER_TOO_SMALL - The supplied buffer is too small to receive the information. The ResultLength member receives the size of buffer required. STATUS_SUCCESS - The operation succeeded. STATUS_INVALID_PARAMETER - One of the parameters is incorrect.
The method might return other NTSTATUS values.
--*/
{ DDI_ENTRY();
PFX_DRIVER_GLOBALS pFxDriverGlobals; FxDevice* pDevice; NTSTATUS status;
FxObjectHandleGetPtrAndGlobals(GetFxDriverGlobals(DriverGlobals), Device, FX_TYPE_DEVICE, (PVOID *) &pDevice, &pFxDriverGlobals);
FxPointerNotNull(pFxDriverGlobals, DeviceProperty);
// // Validate PropertyData // if (DeviceProperty->Size != sizeof(WDF_DEVICE_PROPERTY_DATA)) { status = STATUS_INFO_LENGTH_MISMATCH; DoTraceLevelMessage(pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGPNP, "PropertyData size (%d) incorrect, expected %d, %!STATUS!", DeviceProperty->Size, sizeof(WDF_DEVICE_PROPERTY_DATA), status); return status; }
status = FxVerifierCheckIrqlLevel(pFxDriverGlobals, APC_LEVEL); if (!NT_SUCCESS(status)) { FxVerifierDbgBreakPoint(pFxDriverGlobals); return status; }
FxPointerNotNull(pFxDriverGlobals, RequiredSize); FxPointerNotNull(pFxDriverGlobals, Type);
if (BufferLength != 0 && PropertyBuffer == NULL) { status = STATUS_INVALID_PARAMETER; DoTraceLevelMessage(pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE, "Property buffer size is non-zero, while the buffer is NULL" ", %!STATUS!", status); return status; }
if (BufferLength == 0 && PropertyBuffer != NULL) { status = STATUS_INVALID_PARAMETER; DoTraceLevelMessage(pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE, "Property buffer size is zero, while the buffer is non-NULL" ", %!STATUS!", status); return status; }
status = FxDevice::_QueryPropertyEx(pFxDriverGlobals, NULL, pDevice, DeviceProperty, FxDeviceProperty, BufferLength, PropertyBuffer, RequiredSize, Type); return status;}
_Must_inspect_result__IRQL_requires_max_(APC_LEVEL)WDFAPINTSTATUSNTAPIWDFEXPORT(WdfDeviceAllocAndQueryPropertyEx)( _In_ PWDF_DRIVER_GLOBALS DriverGlobals, _In_ WDFDEVICE Device, _In_ PWDF_DEVICE_PROPERTY_DATA DeviceProperty, _In_ _Strict_type_match_ POOL_TYPE PoolType, _In_opt_ PWDF_OBJECT_ATTRIBUTES PropertyMemoryAttributes, _Out_ WDFMEMORY* PropertyMemory, _Out_ PDEVPROPTYPE Type )/*++
Routine Description:
This routine queries device property.
Arguments:
DriverGlobals - DriverGlobals pointer
Device - WDF Device handle.
PropertyData - A pointer to WDF_DEVICE_PROPERTY_ DATA structure.
PoolType - A POOL_TYPE-typed enumerator that specifies the type of memory to be allocated.
PropertyMemoryAttributes - optional, A pointer to a caller-allocated WDF_OBJECT_ATTRIBUTES structure that describes object attributes for the memory object that the function will allocate. This parameter is optional and can be WDF_NO_OBJECT_ATTRIBUTES.
PropertyMemory - A pointer to a WDFMEMORY-typed location that receives a handle to a framework memory object.
Type - A pointer to a DEVPROPTYPE variable. If method successfully retrieves the property data, the routine writes the property type value to this variable. This value indicates the type of property data that is in the Data buffer.
Return Value:
Method returns an NTSTATUS value. This routine might return one of the following values. It might return other NTSTATUS-codes as well.
STATUS_SUCCESS The operation succeeded. STATUS_INVALID_PARAMETER One of the parameters is incorrect.
--*/{ DDI_ENTRY();
PFX_DRIVER_GLOBALS pFxDriverGlobals; FxDevice* pDevice; NTSTATUS status;
FxObjectHandleGetPtrAndGlobals(GetFxDriverGlobals(DriverGlobals), Device, FX_TYPE_DEVICE, (PVOID *) &pDevice, &pFxDriverGlobals);
FxPointerNotNull(pFxDriverGlobals, DeviceProperty);
// // Validate PropertyData // if (DeviceProperty->Size != sizeof(WDF_DEVICE_PROPERTY_DATA)) { status = STATUS_INFO_LENGTH_MISMATCH; DoTraceLevelMessage(pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGPNP, "PropertyData size (%d) incorrect, expected %d, %!STATUS!", DeviceProperty->Size, sizeof(WDF_DEVICE_PROPERTY_DATA), status); return status; }
status = FxVerifierCheckIrqlLevel(pFxDriverGlobals, APC_LEVEL); if (!NT_SUCCESS(status)) { FxVerifierDbgBreakPoint(pFxDriverGlobals); return status; }
FxVerifierCheckNxPoolType(pFxDriverGlobals, PoolType, pFxDriverGlobals->Tag);
FxPointerNotNull(pFxDriverGlobals, PropertyMemory); FxPointerNotNull(pFxDriverGlobals, Type);
*PropertyMemory = NULL;
status = FxValidateObjectAttributes(pFxDriverGlobals, PropertyMemoryAttributes); if (!NT_SUCCESS(status)) { return status; }
status = FxDevice::_AllocAndQueryPropertyEx(pFxDriverGlobals, NULL, pDevice, DeviceProperty, FxDeviceProperty, PoolType, PropertyMemoryAttributes, PropertyMemory, Type); return status;}
_Must_inspect_result__IRQL_requires_max_(APC_LEVEL)WDFAPINTSTATUSNTAPIWDFEXPORT(WdfDeviceAssignProperty)( _In_ PWDF_DRIVER_GLOBALS DriverGlobals, _In_ WDFDEVICE Device, _In_ PWDF_DEVICE_PROPERTY_DATA DeviceProperty, _In_ DEVPROPTYPE Type, _In_ ULONG BufferLength, _In_opt_ PVOID PropertyBuffer )/*++
Routine Description:
This routine assigns interface property.
Arguments:
DriverGlobals - DriverGlobals pointer
Device - WDF Device handle.
PropertyData - A pointer to WDF_DEVICE_PROPERTY_ DATA structure.
Type - Set this parameter to the DEVPROPTYPE value that specifies the type of the data that is supplied in the Data buffer.
BufferLength - Specifies the length, in bytes, of the buffer that PropertyBuffer points to.
PropertyBuffer - optional, A pointer to the device interface property data. Set this parameter to NULL to delete the specified property.
Return Value:
Mthod returns an NTSTATUS value. This routine might return one of the following values. It might return other NTSTATUS-codes as well.
STATUS_SUCCESS - The operation succeeded. STATUS_INVALID_PARAMETER - One of the parameters is incorrect.
--*/
{ DDI_ENTRY();
PFX_DRIVER_GLOBALS pFxDriverGlobals; FxDevice *pDevice; NTSTATUS status;
// // Validate the Device object handle and get its FxDevice. Also get the // driver globals pointer. // FxObjectHandleGetPtrAndGlobals(GetFxDriverGlobals(DriverGlobals), Device, FX_TYPE_DEVICE, (PVOID *) &pDevice, &pFxDriverGlobals);
FxPointerNotNull(pFxDriverGlobals, DeviceProperty);
// // Validate PropertyData // if (DeviceProperty->Size != sizeof(WDF_DEVICE_PROPERTY_DATA)) { status = STATUS_INFO_LENGTH_MISMATCH; DoTraceLevelMessage(pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGPNP, "PropertyData size (%d) incorrect, expected %d, %!STATUS!", DeviceProperty->Size, sizeof(WDF_DEVICE_PROPERTY_DATA), status); return status; }
status = FxVerifierCheckIrqlLevel(pFxDriverGlobals, APC_LEVEL); if (!NT_SUCCESS(status)) { FxVerifierDbgBreakPoint(pFxDriverGlobals); return status; }
if (BufferLength == 0 && PropertyBuffer != NULL) { status = STATUS_INVALID_PARAMETER; DoTraceLevelMessage(pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE, "Property buffer size is zero, while the buffer is non-NULL" ", %!STATUS!", status); return status; }
status = pDevice->AssignProperty(DeviceProperty, FxDeviceProperty, Type, BufferLength, PropertyBuffer ); return status;}
_Must_inspect_result___drv_maxIRQL(DISPATCH_LEVEL)WDFAPINTSTATUSNTAPIWDFEXPORT(WdfDeviceConfigureWdmIrpDispatchCallback)( _In_ PWDF_DRIVER_GLOBALS DriverGlobals, _In_ WDFDEVICE Device, _In_opt_ WDFDRIVER Driver, _In_ UCHAR MajorFunction, _In_ PFN_WDFDEVICE_WDM_IRP_DISPATCH EvtDeviceWdmIrpDispatch, _In_opt_ WDFCONTEXT DriverContext )
/*++
Routine Description:
Configure callbacks for IRP_MJ_READ, IRP_MJ_WRITE, IRP_MJ_DEVICE_CONTROL, and IRP_MJ_INTERNAL_DEVICE_CONTROL (KMDF only). By default the I/O package sends all requests to a device's default queue, or to the queues configured with WdfDeviceConfigureRequestDisaptching. This DDI allows a driver specified callback to select a different queue dynamically during runtime.
Arguments:
Device - The device which is handling the I/O.
Driver - An optional driver handle. Used to associate the callback with a specific class extension.
MajorFunction - IRP major function type to be forwarded to the callback
EvtDeviceWdmIrpDispatch - Callback invoked when encountering the given major function.
DriverContext - An optional untyped driver specified context.
Returns:
STATUS_SUCCESS on success STATUS_INVALID_PARAMETER if an incorrect MajorFunction was provided STATUS_INSUFFICIENT_RESOURCES if insufficient memory was available STATUS_INVALID_DEVICE_STATE if this DDI was called at an improper time
--*/{ PFX_DRIVER_GLOBALS pFxDriverGlobals; NTSTATUS status; FxDevice* pDevice; FxCxDeviceInfo* pCxDeviceInfo; ULONG deviceFlags;
pDevice = NULL; pCxDeviceInfo = NULL;
FxObjectHandleGetPtrAndGlobals(GetFxDriverGlobals(DriverGlobals), Device, FX_TYPE_DEVICE, (PVOID *) &pDevice, &pFxDriverGlobals);
// // Validate the MajorFunction provided. Note that // IRP_MJ_INTERNAL_DEVICE_CONTROL is KMDF only. // switch (MajorFunction) { case IRP_MJ_WRITE: case IRP_MJ_READ: case IRP_MJ_DEVICE_CONTROL:#if (FX_CORE_MODE == FX_CORE_KERNEL_MODE) case IRP_MJ_INTERNAL_DEVICE_CONTROL:#endif break; default: status = STATUS_INVALID_PARAMETER; DoTraceLevelMessage( pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGPNP, "Invalid MajorFunction provided %!IRPMJ!, %!STATUS!", MajorFunction, status); goto exit; }
// // Validate the driver handle and get (if present) the associated cx info. // if (Driver != NULL) { FxDriver* pDriver;
FxObjectHandleGetPtr(pFxDriverGlobals, Driver, FX_TYPE_DRIVER, (PVOID*)&pDriver);
// // Find the driver's cx info if it's not the main driver for this device. // cx struct info can be NULL if cx acts as client driver. // pCxDeviceInfo = pDevice->GetCxDeviceInfo(pDriver); }
// // Make sure callback is not null. // FxPointerNotNull(pFxDriverGlobals, EvtDeviceWdmIrpDispatch);
// // This callback can only be called during initialization. // if (pDevice->IsLegacy()) {
// // Extract the device flags from the device object //#if (FX_CORE_MODE == FX_CORE_KERNEL_MODE) deviceFlags = pDevice->GetDeviceObject()->Flags;#else deviceFlags = pDevice->GetDeviceObject()->GetDeviceObjectWdmFlags();#endif
// // This is a controldevice. Make sure the create is called after the device // is initialized and ready to accept I/O. // if ((deviceFlags & DO_DEVICE_INITIALIZING) == 0x0) { status = STATUS_INVALID_DEVICE_STATE; DoTraceLevelMessage( pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGPNP, "Driver cannot set IRP dispatch callback " "after WdfControlDeviceFinishInitializing " "is called on the WDFDEVICE %p, %!STATUS!", pDevice, status); goto exit; } } else { // // This is either FDO or PDO. Make sure it's not started yet. // if (pDevice->GetDevicePnpState() != WdfDevStatePnpInit) { status = STATUS_INVALID_DEVICE_STATE; DoTraceLevelMessage( pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGPNP, "Driver cannot set IRP dispatch callback " "after the WDFDEVICE %p is started, %!STATUS!", pDevice, status); goto exit; } }
// // Let I/O package do the rest. // status = pDevice->m_PkgIo->ConfigureDynamicDispatching(MajorFunction, pCxDeviceInfo, EvtDeviceWdmIrpDispatch, DriverContext);exit: return status;}
_Must_inspect_result_NTSTATUSFX_VF_FUNCTION(VerifyWdfDeviceWdmDispatchIrpToIoQueue) ( _In_ PFX_DRIVER_GLOBALS FxDriverGlobals, _In_ FxDevice* device, _In_ MdIrp Irp, _In_ FxIoQueue* queue, _In_ ULONG Flags ){ NTSTATUS status = STATUS_SUCCESS; UCHAR majorFunction, minorFunction; FxIrp fxIrp(Irp);
PAGED_CODE_LOCKED();
majorFunction = fxIrp.GetMajorFunction(); minorFunction = fxIrp.GetMinorFunction();
DoTraceLevelMessage( FxDriverGlobals, TRACE_LEVEL_VERBOSE, TRACINGIO, "WDFDEVICE 0x%p !devobj 0x%p %!IRPMJ!, IRP_MN %x, IRP 0x%p", device->GetHandle(), device->GetDeviceObject(), majorFunction, minorFunction, Irp);
// // Validate Flags. For UMDF, this field is reserved and must be zero. //#if (FX_CORE_MODE == FX_CORE_KERNEL_MODE) if (Flags & ~FX_DISPATCH_IRP_TO_IO_QUEUE_FLAGS_MASK) {#else if (Flags != WDF_DISPATCH_IRP_TO_IO_QUEUE_NO_FLAGS) {#endif status = STATUS_INVALID_PARAMETER; DoTraceLevelMessage( FxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGIO, "Flags 0x%x are invalid, %!STATUS!", Flags, status); FxVerifierDbgBreakPoint(FxDriverGlobals); goto Done; }
// // Only read/writes/ctrls/internal_ctrls IRPs are allowed, i.e., the I/O request set. // if (device->GetDispatchPackage(majorFunction) != device->m_PkgIo) { status = STATUS_INVALID_PARAMETER; DoTraceLevelMessage( FxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGIO, "Only Read/Write/Control/Internal-Control IRPs can be " "forwarded to I/O Queue 0x%p, Irp 0x%p, %!IRPMJ!, " "IRP_MN %x, Device 0x%p, %!STATUS!", queue->GetHandle(), Irp, majorFunction, minorFunction, device->GetObjectHandle(), status); FxVerifierDbgBreakPoint(FxDriverGlobals); goto Done; }
// // Make sure queue can handle the request. // if (FALSE == queue->IsIoEventHandlerRegistered( (WDF_REQUEST_TYPE)majorFunction)) {
status = STATUS_INVALID_PARAMETER; DoTraceLevelMessage( FxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGIO, "I/O Queue 0x%p cannot handle Irp 0x%p, %!IRPMJ!, " "IRP_MN %x, Device 0x%p, %!STATUS!", queue->GetHandle(), Irp, majorFunction, minorFunction, device->GetObjectHandle(), status); FxVerifierDbgBreakPoint(FxDriverGlobals); goto Done; }
if (device->m_ParentDevice == queue->GetDevice()) { // // Send to parent device's queue validation. // if (device->m_ParentDevice == NULL) { status = STATUS_INVALID_PARAMETER; DoTraceLevelMessage( FxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGIO, "No parent device for Device 0x%p, %!STATUS!", device->GetObjectHandle(), status); FxVerifierDbgBreakPoint(FxDriverGlobals); goto Done; }
// // Make sure the child device is a PDO // ASSERT(device->IsPdo());
// // Check if the WdfPdoInitSetForwardRequestToParent was called to // increase the StackSize of the child Device to include the stack // size of the parent Device // if (device->IsPnp() && device->GetPdoPkg()->m_AllowForwardRequestToParent == FALSE) { status = STATUS_INVALID_DEVICE_REQUEST; DoTraceLevelMessage( FxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGIO, "WdfPdoInitSetForwardRequestToParent not called on " "Device 0x%p, %!STATUS!", device->GetObjectHandle(), status); FxVerifierDbgBreakPoint(FxDriverGlobals); goto Done; } } else { // // Send to current device's queue validation. // if (device != queue->GetDevice()) { status = STATUS_INVALID_PARAMETER; DoTraceLevelMessage( FxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGIO, "Cannot forward a request to " "a different Device 0x%p, %!STATUS!", queue->GetDevice()->GetObjectHandle(), status); FxVerifierDbgBreakPoint(FxDriverGlobals); goto Done; } }
Done: return status;}
} // extern "C"