fxdevice.cpp File Reference

#include "coreprivshared.hpp"

Include dependency graph for fxdevice.cpp:

Go to the source code of this file.

Functions
_Must_inspect_result_ __inline BOOLEAN	IsPreprocessIrp (__in MdIrp Irp, __in FxIrpPreprocessInfo *Info)
_Must_inspect_result_ __inline NTSTATUS	PreprocessIrp (__in FxDevice *Device, __in MdIrp Irp, __in FxIrpPreprocessInfo *Info, __in PVOID DispatchContext)
_Must_inspect_result_ __inline NTSTATUS	DispatchWorker (__in FxDevice *Device, __in MdIrp Irp, __in WDFCONTEXT DispatchContext)

Function Documentation

DispatchWorker()

_Must_inspect_result_ __inline NTSTATUS DispatchWorker	(	__in FxDevice *	Device,
		__in MdIrp	Irp,
		__in WDFCONTEXT	DispatchContext
	)

Definition at line 1507 of file fxdevice.cpp.

{
    PLIST_ENTRY next;
    FxIrp irp(Irp);

    next = (PLIST_ENTRY)DispatchContext;

    ASSERT(NULL != DispatchContext &&
           ((UCHAR)(ULONG_PTR)DispatchContext & FX_IN_DISPATCH_CALLBACK) == 0);

    //
    // Check for any driver/class-extensions' preprocess requirements.
    //
    while (next != &Device->m_PreprocessInfoListHead) {
        FxIrpPreprocessInfo* info;

        info = CONTAINING_RECORD(next, FxIrpPreprocessInfo, ListEntry);

        //
        // Advance to next node.
        //
        next = next->Flink;

        if (IsPreprocessIrp(Irp, info)) {
            return PreprocessIrp(Device, Irp, info, next);
        }
    }

    //
    // No preprocess requirements, directly dispatch the IRP.
    //
    return Device->GetDispatchPackage(
        irp.GetMajorFunction()
        )->Dispatch(Irp);
}

Referenced by FxDevice::Dispatch(), and FxDevice::DispatchPreprocessedIrp().

IsPreprocessIrp()

_Must_inspect_result_ __inline BOOLEAN IsPreprocessIrp	(	__in MdIrp	Irp,
		__in FxIrpPreprocessInfo *	Info
	)

Definition at line 1408 of file fxdevice.cpp.

{
    UCHAR       major, minor;
    BOOLEAN     preprocess;
    FxIrp irp(Irp);

    major = irp.GetMajorFunction();
    minor = irp.GetMinorFunction();

    preprocess = FALSE;

    if (Info->Dispatch[major].EvtDevicePreprocess != NULL) {
        if (Info->Dispatch[major].NumMinorFunctions == 0) {
            //
            // If the driver is not interested in particular minor codes,
            // just give the irp to it.
            //
            preprocess = TRUE;
        }
        else {
            ULONG i;

            //
            // Try to match up to a minor code.
            //
            for (i = 0; i < Info->Dispatch[major].NumMinorFunctions; i++) {
                if (Info->Dispatch[major].MinorFunctions[i] == minor) {
                    preprocess = TRUE;
                    break;
                }
            }
        }
    }

    return preprocess;
}

Referenced by DispatchWorker().

PreprocessIrp()

_Must_inspect_result_ __inline NTSTATUS PreprocessIrp	(	__in FxDevice *	Device,
		__in MdIrp	Irp,
		__in FxIrpPreprocessInfo *	Info,
		__in PVOID	DispatchContext
	)

Definition at line 1451 of file fxdevice.cpp.

{
    NTSTATUS        status;
    UCHAR           major, minor;
    FxIrp irp(Irp);

    major = irp.GetMajorFunction();
    minor = irp.GetMinorFunction();

    //
    // If this is a pnp remove irp, this object could be deleted by the time
    // EvtDevicePreprocess returns.  To not touch freed pool, capture all
    // values we will need before preprocessing.
    //

    if (Info->ClassExtension == FALSE) {
        status = Info->Dispatch[major].EvtDevicePreprocess( Device->GetHandle(),
                                                            Irp);
    }
    else {
        status = Info->Dispatch[major].EvtCxDevicePreprocess(
                                                            Device->GetHandle(),
                                                            Irp,
                                                            DispatchContext);
    }

    //
    // If we got this far, we handed the irp off to EvtDevicePreprocess, so we
    // must now do our remlock maintainance if necessary.
    //
    if (FxDevice::_RequiresRemLock(major, minor) == FxDeviceRemLockRequired) {
        //
        // Keep the remove lock active until after we call into the driver.
        // If the driver redispatches the irp to the framework, we will
        // reacquire the remove lock at that point in time.
        //
        // Touching pDevObj after sending the pnp remove irp to the framework
        // is OK b/c we have acquired the remlock previously and that will
        // prevent this irp's processing racing with the pnp remove irp
        // processing.
        //
        Mx::MxReleaseRemoveLock(Device->GetRemoveLock(),
                                Irp);
    }

    return status;
}

Referenced by DispatchWorker().