ReactOS 0.4.15-dev-8100-g1887773
Functions | Variables
fxdeviceapikm.cpp File Reference
#include "coreprivshared.hpp"
#include "fxiotarget.hpp"
Include dependency graph for fxdeviceapikm.cpp:

Go to the source code of this file.

Functions

 FX_DECLARE_VF_FUNCTION_P3 (VOID, VerifyWdfDeviceWdmDispatchIrp, _In_ PWDF_DRIVER_GLOBALS, _In_ FxDevice *, _In_ WDFCONTEXT)
 
 FX_DECLARE_VF_FUNCTION_P4 (NTSTATUS, VerifyWdfDeviceWdmDispatchIrpToIoQueue, _In_ FxDevice *, _In_ MdIrp, _In_ FxIoQueue *, _In_ ULONG)
 
 __drv_maxIRQL (DISPATCH_LEVEL) WDFDEVICE STDCALL WDFEXPORT(WdfWdmDeviceGetWdfDeviceHandle)(__in PWDF_DRIVER_GLOBALS DriverGlobals
 
 FxObjectHandleGetPtr (GetFxDriverGlobals(DriverGlobals), Device, FX_TYPE_DEVICE_BASE,(PVOID *) &pDevice)
 
return pDevice GetDeviceObject ()
 
return pDevice GetAttachedDevice ()
 
return pDevice GetPhysicalDevice ()
 
 FxObjectHandleGetPtr (pFxDriverGlobals, Device, FX_TYPE_DEVICE,(PVOID *)&pDevice)
 
 if (!NT_SUCCESS(status))
 
 FxObjectHandleGetPtrAndGlobals (GetFxDriverGlobals(DriverGlobals), Device, FX_TYPE_DEVICE,(PVOID *) &device, &fxDriverGlobals)
 
 FxPointerNotNull (fxDriverGlobals, Irp)
 
 if (fxDriverGlobals->IsVerificationEnabled(1, 11, OkForDownLevel))
 
return device DispatchPreprocessedIrp (Irp, device->m_PreprocessInfoListHead.Flink->Flink)
 
VOID FX_VF_FUNCTION() VerifyWdfDeviceWdmDispatchIrp (_In_ PFX_DRIVER_GLOBALS FxDriverGlobals, _In_ PWDF_DRIVER_GLOBALS DriverGlobals, _In_ FxDevice *device, _In_ WDFCONTEXT DispatchContext)
 
 FxObjectHandleGetPtr (GetFxDriverGlobals(DriverGlobals), Device, FX_TYPE_DEVICE,(PVOID *) &device)
 
 FxPointerNotNull (device->GetDriverGlobals(), Irp)
 
 FxPointerNotNull (device->GetDriverGlobals(), DispatchContext)
 
 if ((UCHAR)(ULONG_PTR) DispatchContext &FX_IN_DISPATCH_CALLBACK)
 
 FX_TRACK_DRIVER (fxDriverGlobals)
 
 FxObjectHandleGetPtr (GetFxDriverGlobals(DriverGlobals), Queue, FX_TYPE_QUEUE,(PVOID *)&queue)
 
 if (Flags &WDF_DISPATCH_IRP_TO_IO_QUEUE_PREPROCESSED_IRP)
 
 if (device->m_ParentDevice==queue->GetDevice())
 
return device m_PkgIo DispatchStep2 (Irp, ioInCallerCtx, queue)
 
 FxPointerNotNull (pFxDriverGlobals, DependentDevice)
 
return pDevice m_PkgPnp AddUsageDevice (DependentDevice)
 
return pDevice m_PkgPnp RemoveUsageDevice (DependentDevice)
 
_Must_inspect_result_ __drv_maxIRQL (PASSIVE_LEVEL) NTSTATUS STDCALL WDFEXPORT(WdfDeviceAssignMofResourceName)(__in PWDF_DRIVER_GLOBALS DriverGlobals
 
 FxPointerNotNull (pFxDriverGlobals, MofResourceName)
 
 if (pDevice->m_MofResourceName.Buffer !=NULL)
 
 if (FileType< WdfSpecialFilePaging||FileType >=WdfSpecialFileMax)
 
 FxObjectHandleGetPtr (pFxDriverGlobals, Device, FX_TYPE_DEVICE,(PVOID *) &pDevice)
 
pDevice m_PkgPnp SetSpecialFileSupport (FileType, Supported)
 
 if (Device==NULL||WaitWakeStatus==STATUS_PENDING||WaitWakeStatus==STATUS_CANCELLED)
 
 if (pDevice->m_PkgPnp->m_SharedPower.m_WaitWakeOwner)
 
 FxPointerNotNull (pDevice->GetDriverGlobals(), BusInformation)
 
pDevice m_PkgPnp SetChildBusInformation (BusInformation)
 
 FxPointerNotNull (pDevice->GetDriverGlobals(), PhysicalDevice)
 
return pDevice m_PkgPnp AddRemovalDevice (PhysicalDevice)
 
pDevice m_PkgPnp RemoveRemovalDevice (PhysicalDevice)
 
pDevice m_PkgPnp ClearRemovalDevicesList ()
 
 FxPointerNotNull (pFxDriverGlobals, PowerFrameworkSettings)
 
 if (pDevice->m_PkgPnp->IsPowerPolicyOwner()==FALSE)
 
 if (PowerFrameworkSettings->Size !=sizeof(WDF_POWER_FRAMEWORK_SETTINGS))
 
 if (NULL !=PowerFrameworkSettings->Component)
 

Variables

__in PDEVICE_OBJECT DeviceObject
 
__in WDFDEVICE Device
 
__in WDFDEVICE __in MdFileObject FileObject
 
NTSTATUS status
 
FxFileObject * pFxFO = NULL
 
FxDevice * pDevice
 
 pFxDriverGlobals = GetFxDriverGlobals(DriverGlobals)
 
_Must_inspect_result_ __in WDFDEVICE __in MdIrp Irp
 
PFX_DRIVER_GLOBALS fxDriverGlobals = device->GetDriverGlobals()
 
_Must_inspect_result_ __in WDFDEVICE __in MdIrp __in WDFCONTEXT DispatchContext
 
 else
 
_Must_inspect_result_ __in WDFDEVICE __in MdIrp __in WDFQUEUE Queue
 
_Must_inspect_result_ __in WDFDEVICE __in MdIrp __in WDFQUEUE __in ULONG Flags
 
FxDevice * device
 
PIO_STACK_LOCATION stack
 
FxIoInCallerContext * ioInCallerCtx = NULL
 
 queue = NULL
 
_Must_inspect_result_ __in WDFDEVICE __in PDEVICE_OBJECT DependentDevice
 
_Must_inspect_result_ __in WDFDEVICE __in PCUNICODE_STRING MofResourceName
 
__in WDFDEVICE __in WDF_SPECIAL_FILE_TYPE FileType
 
__in WDFDEVICE __in WDF_SPECIAL_FILE_TYPE __in BOOLEAN Supported
 
_Must_inspect_result_ __in WDFDEVICE __in NTSTATUS WaitWakeStatus
 
__in WDFDEVICE __in PPNP_BUS_INFORMATION BusInformation
 
_Must_inspect_result_ __in WDFDEVICE __in PDEVICE_OBJECT PhysicalDevice
 
_Must_inspect_result_ __in WDFDEVICE __in PWDF_POWER_FRAMEWORK_SETTINGS PowerFrameworkSettings
 

Function Documentation

◆ __drv_maxIRQL() [1/2]

__drv_maxIRQL ( DISPATCH_LEVEL  )

◆ __drv_maxIRQL() [2/2]

_Must_inspect_result_ __drv_maxIRQL ( PASSIVE_LEVEL  )

◆ AddRemovalDevice()

return pDevice m_PkgPnp AddRemovalDevice ( PhysicalDevice  )

◆ AddUsageDevice()

return pDevice m_PkgPnp AddUsageDevice ( DependentDevice  )

◆ ClearRemovalDevicesList()

pDevice m_PkgPnp ClearRemovalDevicesList ( )

◆ DispatchPreprocessedIrp()

return device DispatchPreprocessedIrp ( Irp  ,
device->m_PreprocessInfoListHead.Flink->  Flink 
)

◆ DispatchStep2()

return device m_PkgIo DispatchStep2 ( Irp  ,
ioInCallerCtx  ,
queue   
)

◆ FX_DECLARE_VF_FUNCTION_P3()

FX_DECLARE_VF_FUNCTION_P3 ( VOID  ,
VerifyWdfDeviceWdmDispatchIrp  ,
_In_  PWDF_DRIVER_GLOBALS,
_In_ FxDevice *  ,
_In_  WDFCONTEXT 
)

◆ FX_DECLARE_VF_FUNCTION_P4()

FX_DECLARE_VF_FUNCTION_P4 ( NTSTATUS  ,
VerifyWdfDeviceWdmDispatchIrpToIoQueue  ,
_In_ FxDevice *  ,
_In_  MdIrp,
_In_ FxIoQueue *  ,
_In_  ULONG 
)

◆ FX_TRACK_DRIVER()

FX_TRACK_DRIVER ( fxDriverGlobals  )

Referenced by FxRequestBase::CompleteSubmitted(), FxPkgPnp::Dispatch(), FxWmiIrpHandler::Dispatch(), FxPkgGeneral::Dispatch(), FxPkgIo::Dispatch(), FxDpc::DpcHandler(), FxInterrupt::DpcHandler(), FxEventQueue::EventQueueWorker(), FxTimer::TimerHandler(), FxSystemWorkItem::WorkItemHandler(), FxWorkItem::WorkItemHandler(), and FxInterrupt::WorkItemHandler().

◆ FxObjectHandleGetPtr() [1/5]

FxObjectHandleGetPtr ( GetFxDriverGlobals(DriverGlobals)  ,
Device  ,
FX_TYPE_DEVICE  ,
(PVOID *) &  device 
)

◆ FxObjectHandleGetPtr() [2/5]

FxObjectHandleGetPtr ( GetFxDriverGlobals(DriverGlobals)  ,
Device  ,
FX_TYPE_DEVICE_BASE  ,
(PVOID *) &  pDevice 
)

◆ FxObjectHandleGetPtr() [3/5]

FxObjectHandleGetPtr ( GetFxDriverGlobals(DriverGlobals)  ,
Queue  ,
FX_TYPE_QUEUE  ,
(PVOID *)&  queue 
)

◆ FxObjectHandleGetPtr() [4/5]

FxObjectHandleGetPtr ( pFxDriverGlobals  ,
Device  ,
FX_TYPE_DEVICE  ,
(PVOID *) &  pDevice 
)

◆ FxObjectHandleGetPtr() [5/5]

FxObjectHandleGetPtr ( pFxDriverGlobals  ,
Device  ,
FX_TYPE_DEVICE  ,
(PVOID *)&  pDevice 
)

◆ FxObjectHandleGetPtrAndGlobals()

FxObjectHandleGetPtrAndGlobals ( GetFxDriverGlobals(DriverGlobals)  ,
Device  ,
FX_TYPE_DEVICE  ,
(PVOID *) &  device,
&  fxDriverGlobals 
)

◆ FxPointerNotNull() [1/8]

FxPointerNotNull ( device->  GetDriverGlobals(),
DispatchContext   
)

◆ FxPointerNotNull() [2/8]

FxPointerNotNull ( device->  GetDriverGlobals(),
Irp   
)

◆ FxPointerNotNull() [3/8]

FxPointerNotNull ( fxDriverGlobals  ,
Irp   
)

◆ FxPointerNotNull() [4/8]

FxPointerNotNull ( pDevice->  GetDriverGlobals(),
BusInformation   
)

◆ FxPointerNotNull() [5/8]

FxPointerNotNull ( pDevice->  GetDriverGlobals(),
PhysicalDevice   
)

◆ FxPointerNotNull() [6/8]

FxPointerNotNull ( pFxDriverGlobals  ,
DependentDevice   
)

◆ FxPointerNotNull() [7/8]

FxPointerNotNull ( pFxDriverGlobals  ,
MofResourceName   
)

◆ FxPointerNotNull() [8/8]

FxPointerNotNull ( pFxDriverGlobals  ,
PowerFrameworkSettings   
)

◆ GetAttachedDevice()

return pDevice GetAttachedDevice ( )

◆ GetDeviceObject()

return pDevice GetDeviceObject ( )

Referenced by FxMessageDispatch::CleanupFile(), FxMessageDispatch::CloseFile(), FxMessageDispatch::CreateFile(), FxDevice::DeleteDeviceFromFailedCreateNoDelete(), FxWmiIrpHandler::Deregister(), FxMessageDispatch::DeviceControl(), FxMessageDispatch::DispatchPnP(), FxWmiInstance::FireEvent(), FxMessageDispatch::FlushBuffers(), FxMessageDispatch::GetPreferredTransferMode(), FxDevice::GetRemoveLock(), FxDevice::InvalidateDeviceState(), FxMessageDispatch::PoFxDevicePowerNotRequired(), FxMessageDispatch::PoFxDevicePowerRequired(), FxWmiIrpHandler::PostCreateDeviceInitialize(), FxMessageDispatch::QueryInformationFile(), FxMessageDispatch::ReadFile(), FxWmiIrpHandler::Register(), FxMessageDispatch::RemoteInterfaceArrival(), FxMessageDispatch::RemoteInterfaceRemoval(), FxMessageDispatch::SetInformationFile(), FxMessageDispatch::TransportQueryID(), FxWmiIrpHandler::UpdateGuids(), and FxMessageDispatch::WriteFile().

◆ GetPhysicalDevice()

return pDevice GetPhysicalDevice ( )

Referenced by FxDevice::SetFilterIoType().

◆ if() [1/12]

if ( !  NT_SUCCESSstatus)

Definition at line 197 of file fxdeviceapikm.cpp.

197 {
198 DoTraceLevelMessage(
199 pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
200 "FxFileObject::_GetFileObjectFromWdm returned an error %!STATUS!",
201 status);
202 return NULL;
203 }
TRACINGDEVICE
#define TRACINGDEVICE
Definition: dbgtrace.h:58
NULL
#define NULL
Definition: types.h:112
DoTraceLevelMessage
DoTraceLevelMessage(pFxDriverGlobals, TRACE_LEVEL_VERBOSE, TRACINGPNP, "Enter, WDFDEVICE %p", Device)
pFxDriverGlobals
pFxDriverGlobals
Definition: fxdeviceapikm.cpp:168
TRACE_LEVEL_ERROR
#define TRACE_LEVEL_ERROR
Definition: storswtr.h:27
status
Definition: ps.c:97

◆ if() [2/12]

if ( (UCHAR)(ULONG_PTR) DispatchContext &  FX_IN_DISPATCH_CALLBACK)

Definition at line 371 of file fxdeviceapikm.cpp.

371 {
372 //
373 // Called from a dispach irp callback.
374 //
375 DispatchContext =
376 (WDFCONTEXT)((ULONG_PTR)DispatchContext & ~FX_IN_DISPATCH_CALLBACK);
377
378 //
379 // DispatchContext is validated by DispatchStep1.
380 //
381 status = device->m_PkgIo->DispatchStep1(Irp, DispatchContext);
382 }
Irp
_In_ PIRP Irp
Definition: csq.h:116
device
Definition: devices.h:37
ULONG_PTR
uint32_t ULONG_PTR
Definition: typedefs.h:65
DispatchContext
_In_ UCHAR _In_ UCHAR _In_ ULONG _In_ WDFCONTEXT _Inout_ PIRP _In_ WDFCONTEXT DispatchContext
Definition: wdfdevice.h:1708
WDFCONTEXT
PVOID WDFCONTEXT
Definition: wdftypes.h:94

◆ if() [3/12]

if ( device->  m_ParentDevice = = queue->GetDevice())

Definition at line 473 of file fxdeviceapikm.cpp.

473 {
474 IoCopyCurrentIrpStackLocationToNext(Irp);
475 IoSetNextIrpStackLocation(Irp);
476
477 //
478 // From now on use new device.
479 //
480 device = device->m_ParentDevice;
481
482 //
483 // Save a pointer to the device object for this request so that it can
484 // be used later in completion.
485 //
486 stack = IoGetCurrentIrpStackLocation(Irp);
487 stack->DeviceObject = device->GetDeviceObject();
488 }
IoGetCurrentIrpStackLocation
static PIO_STACK_LOCATION IoGetCurrentIrpStackLocation(PIRP Irp)
Definition: Bus_PDO_EvalMethod.c:150
stack
Definition: _stack.h:55
IoCopyCurrentIrpStackLocationToNext
#define IoCopyCurrentIrpStackLocationToNext(Irp)
Definition: ntifs_ex.h:413
IoSetNextIrpStackLocation
FORCEINLINE VOID IoSetNextIrpStackLocation(_Inout_ PIRP Irp)
Definition: iofuncs.h:2680

◆ if() [4/12]

if ( Device  = = NULL || WaitWakeStatus == STATUS_PENDING || WaitWakeStatus == STATUS_CANCELLED)

Definition at line 681 of file fxdeviceapikm.cpp.

682 {
683 DoTraceLevelMessage(pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
684 "NULL WDFDEVICE handle %p or invalid %!STATUS!",
685 Device, WaitWakeStatus);
686 return STATUS_INVALID_PARAMETER;
687 }
STATUS_INVALID_PARAMETER
#define STATUS_INVALID_PARAMETER
Definition: udferr_usr.h:135
Device
_Must_inspect_result_ _In_ WDFDEVICE Device
Definition: wdfchildlist.h:474
WaitWakeStatus
_Must_inspect_result_ _In_ WDFDEVICE _In_ NTSTATUS WaitWakeStatus
Definition: wdfdevice.h:3945

◆ if() [5/12]

if ( FileType< WdfSpecialFilePaging||FileType >  = WdfSpecialFileMax)

Definition at line 641 of file fxdeviceapikm.cpp.

641 {
642 DoTraceLevelMessage(
643 pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
644 "WDFDEVICE 0x%p FileType %d specified is not in valid range",
645 Device, FileType);
646 FxVerifierDbgBreakPoint(pFxDriverGlobals);
647 return;
648 }
FxVerifierDbgBreakPoint
FxVerifierDbgBreakPoint(pFxDriverGlobals)
FileType
_In_ WDFDEVICE _In_ WDF_SPECIAL_FILE_TYPE FileType
Definition: wdfdevice.h:2741

◆ if() [6/12]

if ( Flags &  WDF_DISPATCH_IRP_TO_IO_QUEUE_PREPROCESSED_IRP)

Definition at line 450 of file fxdeviceapikm.cpp.

450 {
451 IoSetNextIrpStackLocation(Irp);
452 }

◆ if() [7/12]

if ( fxDriverGlobals->  IsVerificationEnabled1, 11, OkForDownLevel)

Definition at line 242 of file fxdeviceapikm.cpp.

242 {
243 if (device->IsCxInIoPath()) {
244 FxDriver* driver = GetFxDriverGlobals(DriverGlobals)->Driver;
245
246 if (IsListEmpty(&device->m_PreprocessInfoListHead) ||
247 device->IsCxDriverInIoPath(driver)) {
248
249 DoTraceLevelMessage(
250 fxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGIO,
251 "This API can only be called by client driver from its "
252 "pre-process IRP callback, STATUS_INVALID_DEVICE_REQUEST");
253 FxVerifierDbgBreakPoint(fxDriverGlobals);
254 }
255 }
256 }
TRACINGIO
#define TRACINGIO
Definition: dbgtrace.h:66
IsListEmpty
#define IsListEmpty(ListHead)
Definition: env_spec_w32.h:954
fxDriverGlobals
PFX_DRIVER_GLOBALS fxDriverGlobals
Definition: fxdeviceapikm.cpp:225
DriverGlobals
DriverGlobals
Definition: fxdriverapi.cpp:107
GetFxDriverGlobals
__inline PFX_DRIVER_GLOBALS GetFxDriverGlobals(__in PWDF_DRIVER_GLOBALS DriverGlobals)
Definition: fxglobals.h:597
driver
struct @1673::@1674 driver
_FX_DRIVER_GLOBALS::Driver
FxDriver * Driver
Definition: fxglobals.h:374

◆ if() [8/12]

if ( NULL !  = PowerFrameworkSettings->Component)

Definition at line 945 of file fxdeviceapikm.cpp.

945 {
946
947 if (0 == PowerFrameworkSettings->Component->IdleStateCount) {
948 status = STATUS_INVALID_PARAMETER;
949 DoTraceLevelMessage(
950 pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
951 "WDFDEVICE 0x%p Component settings are specified but "
952 "IdleStateCount is 0. %!STATUS!", Device, status);
953 FxVerifierDbgBreakPoint(pFxDriverGlobals);
954 return status;
955 }
956
957 if (NULL == PowerFrameworkSettings->Component->IdleStates) {
958 status = STATUS_INVALID_PARAMETER;
959 DoTraceLevelMessage(
960 pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
961 "WDFDEVICE 0x%p Component settings are specified but IdleStates"
962 " is NULL. %!STATUS!", Device, status);
963 FxVerifierDbgBreakPoint(pFxDriverGlobals);
964 return status;
965 }
966 }
status
NTSTATUS status
Definition: fxdeviceapikm.cpp:164
PowerFrameworkSettings
_Must_inspect_result_ _In_ WDFDEVICE _In_ PWDF_POWER_FRAMEWORK_SETTINGS PowerFrameworkSettings
Definition: wdfdevice.h:4335

◆ if() [9/12]

if ( pDevice->m_MofResourceName.Buffer !  = NULL)

Definition at line 593 of file fxdeviceapikm.cpp.

593 {
594 status = STATUS_INVALID_DEVICE_REQUEST;
595
596 DoTraceLevelMessage(
597 pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
598 "WDFDEVICE %p MofResourceName already assigned, %!STATUS!",
599 Device, status);
600
601 return status;
602 }
STATUS_INVALID_DEVICE_REQUEST
#define STATUS_INVALID_DEVICE_REQUEST
Definition: udferr_usr.h:138

◆ if() [10/12]

if ( pDevice->m_PkgPnp->  IsPowerPolicyOwner() = = FALSE)

Definition at line 914 of file fxdeviceapikm.cpp.

914 {
915 status = STATUS_INVALID_DEVICE_REQUEST;
916 DoTraceLevelMessage(
917 pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
918 "WDFDEVICE 0x%p is not the power policy owner, so the caller cannot"
919 " assign power framework settings %!STATUS!", Device, status);
920 FxVerifierDbgBreakPoint(pFxDriverGlobals);
921 return status;
922 }

◆ if() [11/12]

if ( pDevice->m_PkgPnp->m_SharedPower.  m_WaitWakeOwner)

Definition at line 689 of file fxdeviceapikm.cpp.

689 {
690 if (pDevice->m_PkgPnp->PowerIndicateWaitWakeStatus(WaitWakeStatus)) {
691 status = STATUS_SUCCESS;
692 }
693 else {
694 //
695 // There was no request to complete
696 //
697 DoTraceLevelMessage(pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
698 "WDFDEVICE 0x%p No request to complete"
699 " STATUS_INVALID_DEVICE_REQUEST",
700 Device);
701
702 status = STATUS_INVALID_DEVICE_REQUEST;
703 }
704 }
FxDevice::m_PkgPnp
FxPkgPnp * m_PkgPnp
Definition: fxdevice.hpp:670
FxPkgPnp::PowerIndicateWaitWakeStatus
BOOLEAN PowerIndicateWaitWakeStatus(__in NTSTATUS WaitWakeStatus)
Definition: powerstatemachine.cpp:4781
pDevice
FxDevice * pDevice
Definition: fxdeviceapikm.cpp:166
STATUS_SUCCESS
#define STATUS_SUCCESS
Definition: shellext.h:65

◆ if() [12/12]

if ( PowerFrameworkSettings->Size !  = sizeof(WDF_POWER_FRAMEWORK_SETTINGS))

Definition at line 927 of file fxdeviceapikm.cpp.

927 {
928 status = STATUS_INFO_LENGTH_MISMATCH;
929 DoTraceLevelMessage(
930 pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
931 "WDFDEVICE 0x%p Expected PowerFrameworkSettings size %d, actual %d,"
932 " %!STATUS!",
933 Device,
934 sizeof(WDF_POWER_FRAMEWORK_SETTINGS),
935 PowerFrameworkSettings->Size,
936 status);
937 FxVerifierDbgBreakPoint(pFxDriverGlobals);
938 return status;
939 }
_WDF_POWER_FRAMEWORK_SETTINGS
Definition: wdfdevice.h:1760
STATUS_INFO_LENGTH_MISMATCH
#define STATUS_INFO_LENGTH_MISMATCH
Definition: udferr_usr.h:133

◆ RemoveRemovalDevice()

pDevice m_PkgPnp RemoveRemovalDevice ( PhysicalDevice  )

◆ RemoveUsageDevice()

return pDevice m_PkgPnp RemoveUsageDevice ( DependentDevice  )

◆ SetChildBusInformation()

pDevice m_PkgPnp SetChildBusInformation ( BusInformation  )

◆ SetSpecialFileSupport()

pDevice m_PkgPnp SetSpecialFileSupport ( FileType  ,
Supported   
)

◆ VerifyWdfDeviceWdmDispatchIrp()

VOID FX_VF_FUNCTION() VerifyWdfDeviceWdmDispatchIrp ( _In_ PFX_DRIVER_GLOBALS  FxDriverGlobals,
_In_ PWDF_DRIVER_GLOBALS  DriverGlobals,
_In_ FxDevice *  device,
_In_ WDFCONTEXT  DispatchContext 
)

Definition at line 267 of file fxdeviceapikm.cpp.

273{
274 UNREFERENCED_PARAMETER(FxDriverGlobals);
275 FxDriver* driver;
276 BOOLEAN ctxValid;
277 PLIST_ENTRY next;
278 NTSTATUS status;
279
280 PAGED_CODE_LOCKED();
281
282 status = STATUS_SUCCESS;
283 driver = GetFxDriverGlobals(DriverGlobals)->Driver;
284 ctxValid = (PLIST_ENTRY)DispatchContext ==
285 &device->m_PreprocessInfoListHead ? TRUE : FALSE;
286 //
287 // Driver should be a cx.
288 //
289 if (device->IsCxDriverInIoPath(driver) == FALSE) {
290 status = STATUS_INVALID_DEVICE_REQUEST;
291 DoTraceLevelMessage(
292 device->GetDriverGlobals(), TRACE_LEVEL_ERROR, TRACINGIO,
293 "This API can only be called by wdf extension driver "
294 "from its pre-process IRP callback, %!STATUS!",
295 status);
296 FxVerifierDbgBreakPoint(device->GetDriverGlobals());
297 }
298
299 //
300 // Validate DispatchContext.
301 //
302
303 for (next = device->m_PreprocessInfoListHead.Flink;
304 next != &device->m_PreprocessInfoListHead;
305 next = next->Flink) {
306 if ((PLIST_ENTRY)DispatchContext == next) {
307 ctxValid = TRUE;
308 break;
309 }
310 }
311
312 if (FALSE == ctxValid) {
313 status = STATUS_INVALID_PARAMETER;
314 DoTraceLevelMessage(
315 device->GetDriverGlobals(), TRACE_LEVEL_ERROR, TRACINGIO,
316 "DispatchContext 0x%p is invalid, %!STATUS!",
317 DispatchContext, status);
318 FxVerifierDbgBreakPoint(device->GetDriverGlobals());
319 }
320}
BOOLEAN
unsigned char BOOLEAN
Definition: ProcessorBind.h:185
NTSTATUS
LONG NTSTATUS
Definition: precomp.h:26
TRUE
#define TRUE
Definition: types.h:120
FALSE
#define FALSE
Definition: types.h:117
ctxValid
BOOLEAN ctxValid
Definition: fxpkgio.cpp:129
if
if(dx< 0)
Definition: linetemp.h:194
UNREFERENCED_PARAMETER
#define UNREFERENCED_PARAMETER(P)
Definition: ntbasedef.h:317
next
static unsigned __int64 next
Definition: rand_nt.c:6
_LIST_ENTRY
Definition: typedefs.h:120
PLIST_ENTRY
struct _LIST_ENTRY * PLIST_ENTRY
PAGED_CODE_LOCKED
#define PAGED_CODE_LOCKED()
Definition: kefuncs.h:1417

Variable Documentation

◆ BusInformation

__in WDFDEVICE __in PPNP_BUS_INFORMATION BusInformation
Initial value:
{
FxDevice* pDevice

Definition at line 729 of file fxdeviceapikm.cpp.

◆ DependentDevice

__in WDFDEVICE __in PDEVICE_OBJECT DependentDevice
Initial value:
{
PFX_DRIVER_GLOBALS pFxDriverGlobals
_FX_DRIVER_GLOBALS
Definition: fxglobals.h:165

Definition at line 515 of file fxdeviceapikm.cpp.

◆ Device

_Must_inspect_result_ __in WDFDEVICE Device
Initial value:
{
FxDeviceBase *pDevice

Definition at line 81 of file fxdeviceapikm.cpp.

◆ device

FxDevice* device

Definition at line 420 of file fxdeviceapikm.cpp.

◆ DeviceObject

__in PDEVICE_OBJECT DeviceObject
Initial value:
{
FxPointerNotNull(GetFxDriverGlobals(DriverGlobals), DeviceObject)
FxPointerNotNull
#define FxPointerNotNull(FxDriverGlobals, Ptr)
Definition: fxmacros.hpp:253
DeviceObject
_In_ PDEVICE_OBJECT DeviceObject
Definition: wdfdevice.h:2055

Definition at line 66 of file fxdeviceapikm.cpp.

◆ DispatchContext

_Must_inspect_result_ __in WDFDEVICE __in MdIrp __in WDFCONTEXT DispatchContext
Initial value:
{
FxDevice *device

Definition at line 334 of file fxdeviceapikm.cpp.

◆ else

else
Initial value:
{
VerifyWdfDeviceWdmDispatchIrp(device->GetDriverGlobals(),
DriverGlobals,
device,
DispatchContext)
VerifyWdfDeviceWdmDispatchIrp
VOID FX_VF_FUNCTION() VerifyWdfDeviceWdmDispatchIrp(_In_ PFX_DRIVER_GLOBALS FxDriverGlobals, _In_ PWDF_DRIVER_GLOBALS DriverGlobals, _In_ FxDevice *device, _In_ WDFCONTEXT DispatchContext)
Definition: fxdeviceapikm.cpp:267

Definition at line 383 of file fxdeviceapikm.cpp.

◆ FileObject

__in WDFDEVICE __in MdFileObject FileObject
Initial value:
{
PFX_DRIVER_GLOBALS pFxDriverGlobals

Definition at line 144 of file fxdeviceapikm.cpp.

◆ FileType

__in WDFDEVICE __in WDF_SPECIAL_FILE_TYPE FileType

Definition at line 627 of file fxdeviceapikm.cpp.

◆ Flags

_Must_inspect_result_ __in WDFDEVICE __in MdIrp __in WDFQUEUE __in ULONG Flags
Initial value:
{
FxIoQueue *queue
queue
Definition: _queue.h:67

Definition at line 416 of file fxdeviceapikm.cpp.

◆ fxDriverGlobals

fxDriverGlobals = device->GetDriverGlobals()

Definition at line 225 of file fxdeviceapikm.cpp.

Referenced by if().

◆ ioInCallerCtx

ioInCallerCtx = NULL

Definition at line 424 of file fxdeviceapikm.cpp.

Referenced by FxPkgIo::DispatchStep1(), and FxIoTargetSelf::Send().

◆ Irp

_Must_inspect_result_ __in WDFDEVICE __in MdIrp Irp
Initial value:
{
FxDevice *device

Definition at line 221 of file fxdeviceapikm.cpp.

◆ MofResourceName

_Must_inspect_result_ __in WDFDEVICE __in PCUNICODE_STRING MofResourceName
Initial value:
{
PFX_DRIVER_GLOBALS pFxDriverGlobals

Definition at line 568 of file fxdeviceapikm.cpp.

◆ pDevice

FxDevice* pDevice

Definition at line 166 of file fxdeviceapikm.cpp.

Referenced by if().

◆ pFxDriverGlobals

PFX_DRIVER_GLOBALS pFxDriverGlobals = GetFxDriverGlobals(DriverGlobals)

Definition at line 168 of file fxdeviceapikm.cpp.

Referenced by if().

◆ pFxFO

return pFxFO = NULL

Definition at line 165 of file fxdeviceapikm.cpp.

Referenced by FxPkgGeneral::OnCleanup(), FxPkgGeneral::OnClose(), and FxPkgGeneral::OnCreate().

◆ PhysicalDevice

__in WDFDEVICE __in PDEVICE_OBJECT PhysicalDevice
Initial value:
{
FxDevice* pDevice

Definition at line 754 of file fxdeviceapikm.cpp.

◆ PowerFrameworkSettings

_Must_inspect_result_ __in WDFDEVICE __in PWDF_POWER_FRAMEWORK_SETTINGS PowerFrameworkSettings
Initial value:
{
NTSTATUS status

Definition at line 870 of file fxdeviceapikm.cpp.

◆ Queue

_Must_inspect_result_ __in WDFDEVICE __in MdIrp __in WDFQUEUE Queue

Definition at line 414 of file fxdeviceapikm.cpp.

◆ queue

queue = NULL

Definition at line 426 of file fxdeviceapikm.cpp.

◆ stack

PIO_STACK_LOCATION stack

Definition at line 422 of file fxdeviceapikm.cpp.

◆ status

return status
Initial value:
= FxFileObject::_GetFileObjectFromWdm(
pDevice,
pDevice->GetFileObjectClass(),
FileObject,
&pFxFO
)
FxDevice::GetFileObjectClass
__inline WDF_FILEOBJECT_CLASS GetFileObjectClass(VOID)
Definition: fxdevice.hpp:1123
FxFileObject::_GetFileObjectFromWdm
static _Must_inspect_result_ NTSTATUS _GetFileObjectFromWdm(__in FxDevice *pDevice, __in WDF_FILEOBJECT_CLASS FileObjectClass, __in_opt MdFileObject pWdmFileObject, __deref_out_opt FxFileObject **ppFxFileObject)
Definition: fxfileobject.cpp:279
pFxFO
FxFileObject * pFxFO
Definition: fxdeviceapikm.cpp:165
FileObject
_In_ WDFREQUEST _In_ WDFFILEOBJECT FileObject
Definition: wdfdevice.h:550

Definition at line 164 of file fxdeviceapikm.cpp.

Referenced by if(), and VerifyWdfDeviceWdmDispatchIrp().

◆ Supported

__in WDFDEVICE __in WDF_SPECIAL_FILE_TYPE __in BOOLEAN Supported
Initial value:
{
FxDevice* pDevice

Definition at line 629 of file fxdeviceapikm.cpp.

◆ WaitWakeStatus

_Must_inspect_result_ __in WDFDEVICE __in NTSTATUS WaitWakeStatus
Initial value:
{
NTSTATUS status

Definition at line 668 of file fxdeviceapikm.cpp.