fxdevicepdoapi.cpp File Reference

#include "fxcorepch.hpp"

Include dependency graph for fxdevicepdoapi.cpp:

Go to the source code of this file.

Functions
NTSTATUS	GetPdoPackageFromDeviceHandle (__in IN PFX_DRIVER_GLOBALS CallersGlobals, __in WDFDEVICE Device, __in PCHAR FunctionName, __out FxPkgPdo **Package, __out PFX_DRIVER_GLOBALS *ObjectGlobals, __out_opt FxDevice **OutDevice=NULL)
_Must_inspect_result_	__drv_maxIRQL (DISPATCH_LEVEL) NTSTATUS NTAPI WDFEXPORT(WdfPdoMarkMissing)(__in PWDF_DRIVER_GLOBALS DriverGlobals
	if (NT_SUCCESS(status))
	FxVerifierDbgBreakPoint (pFxDriverGlobals)
	FxPointerNotNull (pFxDriverGlobals, IdentificationDescription)
	FxPointerNotNull (pFxDriverGlobals, AddressDescription)
	FxPointerNotNull (pFxDriverGlobals, PhysicalDevice)
	if (!NT_SUCCESS(status))
pPkgPdo	RemoveEjectionDevice (PhysicalDevice)
pPkgPdo	ClearEjectionDevicesList ()

Variables
_Must_inspect_result_ __in WDFDEVICE	Device
NTSTATUS	status
FxPkgPdo *	pPkgPdo
FxDevice *	pDevice
PFX_DRIVER_GLOBALS	pFxDriverGlobals
	else
return	NULL
_Must_inspect_result_ __in WDFDEVICE __inout PWDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER	IdentificationDescription
_Must_inspect_result_ __in WDFDEVICE __inout PWDF_CHILD_ADDRESS_DESCRIPTION_HEADER	AddressDescription
_Must_inspect_result_ __in WDFDEVICE __in PDEVICE_OBJECT	PhysicalDevice

Function Documentation

__drv_maxIRQL()

_Must_inspect_result_ __drv_maxIRQL

(

DISPATCH_LEVEL

)

ClearEjectionDevicesList()

pPkgPdo ClearEjectionDevicesList

(

)

FxPointerNotNull() [1/3]

FxPointerNotNull	(	pFxDriverGlobals	,
		AddressDescription
	)

FxPointerNotNull() [2/3]

FxPointerNotNull	(	pFxDriverGlobals	,
		IdentificationDescription
	)

FxPointerNotNull() [3/3]

FxPointerNotNull	(	pFxDriverGlobals	,
		PhysicalDevice
	)

FxVerifierDbgBreakPoint()

FxVerifierDbgBreakPoint

(

pFxDriverGlobals

)

Referenced by __drv_maxIRQL(), __drv_when(), FxFileObject::_CreateFileObject(), FxFileObject::_DestroyFileObject(), FxObject::_GetEffectiveLock(), FxFileObject::_GetFileObjectFromWdm(), _Requires_lock_held_(), _Requires_lock_not_held_(), FxDevice::_ValidateOpenKeyParams(), FxPkgGeneral::AcquireRemoveLockForClose(), FxResourceCollection::AddAt(), FxCommonBuffer::AllocateCommonBuffer(), FxDmaEnabler::AllocateCommonBuffer(), WDFDEVICE_INIT::AssignIoType(), FxInterrupt::AssignResources(), FxCallbackLock::CheckOwnership(), IdleTimeoutManagement::CommitPowerFrameworkSettings(), FxRequest::CompleteInternal(), FxPkgGeneral::ConfigureConstraints(), FxPkgGeneral::ConfigureFileObjectClass(), FxPkgGeneral::ConfigureForwarding(), FxPkgIo::ConfigureForwarding(), FxDmaEnabler::ConfigureSystemAdapter(), FxRequest::CopyCompletionParams(), IFxMemory::CopyFromPtr(), FxChildList::CreateDevice(), FxPkgIo::DispatchStep1(), FxDmaTransactionBase::DmaCompleted(), FxVerifierLock::DumpDetails(), FxWorkItem::Enqueue(), FxPkgIo::EnqueueRequest(), FxSystemWorkItem::EnqueueWorker(), FxDevice::FdoInitialize(), FxPkgIo::FlushAllQueuesByFileObject(), FxTimer::FlushAndRundown(), FxWorkItem::FlushAndWait(), FxRequestBase::FreeMdls(), IdleTimeoutManagement::FreezeIdleTimeoutManagementStatus(), FX_VF_METHOD(), FxMdlDump(), FxMdlFreeDebug(), FxPoolAllocator(), FxPoolDump(), FxValiateCx(), FxDevice::FxValidateInterfacePropertyData(), FxVerifyLogHeader(), FxUsbInterface::GetConfiguredSettingIndex(), FxRequest::GetMdl(), FxRequest::GetMemoryObject(), FxVerifierLock::GetThreadTableEntry(), FxIoTarget::GotoPurgeState(), FxUsbPipe::GotoPurgeState(), FxUsbPipe::GotoRemoveState(), FxIoTarget::GotoStartState(), FxUsbPipe::GotoStopState(), if(), FxRequest::Impersonate(), FxDmaEnabler::Initialize(), FxDmaScatterGatherTransaction::InitializeResources(), FxPowerIdleMachine::IoDecrement(), FxIoQueue::PeekRequest(), FxPkgPdo::PnpEventEjectHardwareOverload(), FxPkgPnp::PnpEventQueryRemoveAskDriver(), FxPkgPnp::PnpEventQueryStopAskDriver(), FxPkgPnp::PnpReleaseHardware(), FxPkgPnp::PowerPolicySetS0IdleSettings(), FxRequest::ProbeAndLockForRead(), FxRequest::ProbeAndLockForWrite(), FxIoQueue::ReadyNotify(), FxRequest::ReleaseIrpReference(), FxVerifierLock::ReleaseOrReplaceThreadTableEntry(), FxResourceCollection::RemoveAndDelete(), FxRequest::RemoveFromIrpQueue(), FxInterrupt::ReportActive(), FxInterrupt::ReportInactive(), FxIoQueue::Requeue(), FxRequest::Reuse(), FxIoTargetSelf::Send(), FxRequest::SetCompletionState(), FxPkgIo::SetFilter(), FxDmaTransactionBase::SetImmediateExecution(), FxInterrupt::SetPolicy(), FxIoQueue::SetState(), FxTimer::Start(), FxDmaPacketTransaction::StartTransfer(), FxTimer::Stop(), switch(), FxDmaPacketTransaction::TransferCompleted(), FxVerifierLock::Unlock(), FxTagTracker::UpdateTagHistory(), IdleTimeoutManagement::UseSystemManagedIdleTimeout(), FxPkgPnp::ValidateCmResource(), FxPkgPnp::ValidateInterruptResourceCm(), VerifyWdfDeviceWdmDispatchIrp(), VerifyWdfDeviceWdmDispatchIrpToIoQueue(), FxDpc::~FxDpc(), FxInterrupt::~FxInterrupt(), FxSystemWorkItem::~FxSystemWorkItem(), FxTimer::~FxTimer(), FxVerifierLock::~FxVerifierLock(), and FxWorkItem::~FxWorkItem().

GetPdoPackageFromDeviceHandle()

NTSTATUS GetPdoPackageFromDeviceHandle	(	__in IN PFX_DRIVER_GLOBALS	CallersGlobals,
		__in WDFDEVICE	Device,
		__in PCHAR	FunctionName,
		__out FxPkgPdo **	Package,
		__out PFX_DRIVER_GLOBALS *	ObjectGlobals,
		__out_opt FxDevice **	OutDevice = NULL
	)

Definition at line 32 of file fxdevicepdoapi.cpp.

{
    NTSTATUS status;
    FxDevice *pDevice;
 
    FxObjectHandleGetPtrAndGlobals(CallersGlobals,
                                   Device,
                                   FX_TYPE_DEVICE,
                                   (PVOID*) &pDevice,
                                   ObjectGlobals);
 
    //
    // If the optional "OutDevice" argument is present, return the pointer
    // to the device.
    //
    if (OutDevice != NULL) {
        *OutDevice = pDevice;
    }
 
    //
    // Check to see if a PDO package is installed on the device.
    //
    if (pDevice->IsPdo()) {
        *Package = (FxPkgPdo *) pDevice->GetPdoPkg();
        status = STATUS_SUCCESS;
    }
    else {
        DoTraceLevelMessage((*ObjectGlobals), TRACE_LEVEL_ERROR, TRACINGDEVICE,
                            "%s: Incorrect device handle supplied (0x%p).  "
                            "Device is not a PDO.", FunctionName, Device);
 
        status = STATUS_INVALID_PARAMETER;
    }
 
    return status;
}

if() [1/2]

if

(

!

NT_SUCCESSstatus

)

Definition at line 402 of file fxdevicepdoapi.cpp.

                             {
        return status;
    }

if() [2/2]

if

(

NT_SUCCESS(status)

)

Definition at line 110 of file fxdevicepdoapi.cpp.

                            {
        //
        // Check to see if the device is enumerated off of a child list.  If so,
        // have the child list object perform any necessary actions.
        //
        status = pPkgPdo->m_OwningChildList->UpdateDeviceAsMissing(pDevice);
    }

RemoveEjectionDevice()

pPkgPdo RemoveEjectionDevice

(

PhysicalDevice

)

Variable Documentation

AddressDescription

_Must_inspect_result_ __in WDFDEVICE __inout PWDF_CHILD_ADDRESS_DESCRIPTION_HEADER AddressDescription

Initial value:

{
    PFX_DRIVER_GLOBALS pFxDriverGlobals

Definition at line 265 of file fxdevicepdoapi.cpp.

Device

__in WDFDEVICE Device

Initial value:

{
    PFX_DRIVER_GLOBALS pFxDriverGlobals

Definition at line 95 of file fxdevicepdoapi.cpp.

else

else

Initial value:

{
        DoTraceLevelMessage(pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
                            "Can only eject PDOs, %!STATUS!", status)

Definition at line 159 of file fxdevicepdoapi.cpp.

IdentificationDescription

_Must_inspect_result_ __in WDFDEVICE __inout PWDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER IdentificationDescription

Initial value:

{
    PFX_DRIVER_GLOBALS pFxDriverGlobals

Definition at line 210 of file fxdevicepdoapi.cpp.

NULL

return NULL

Definition at line 195 of file fxdevicepdoapi.cpp.

Referenced by GetPdoPackageFromDeviceHandle().

pDevice

FxDevice* pDevice

Definition at line 101 of file fxdevicepdoapi.cpp.

Referenced by GetPdoPackageFromDeviceHandle(), and if().

pFxDriverGlobals

PFX_DRIVER_GLOBALS pFxDriverGlobals

Definition at line 135 of file fxdevicepdoapi.cpp.

PhysicalDevice

__in WDFDEVICE __in PDEVICE_OBJECT PhysicalDevice

Initial value:

{
    PFX_DRIVER_GLOBALS pFxDriverGlobals

Definition at line 370 of file fxdevicepdoapi.cpp.

pPkgPdo

FxPkgPdo * pPkgPdo

Definition at line 100 of file fxdevicepdoapi.cpp.

Referenced by FxPkgPdo::_QueryCapsWorkItem(), FxDevice::DeleteObject(), if(), and FxDevice::PdoInitialize().

status

status

Initial value:

= GetPdoPackageFromDeviceHandle(GetFxDriverGlobals(DriverGlobals),
                                           Device,
                                           (PCHAR)__FUNCTION__,
                                           &pPkgPdo,
                                           &pFxDriverGlobals,
                                           &pDevice)

Definition at line 99 of file fxdevicepdoapi.cpp.

Referenced by GetPdoPackageFromDeviceHandle(), and if().