fxpkgfdo.hpp

Go to the documentation of this file.

/*++

Copyright (c) Microsoft Corporation

Module Name:

    FxPkgFdo.hpp

Abstract:

    This module implements the pnp package for Fdo objects.

Author:



Environment:

    Both kernel and user mode

Revision History:

--*/

#ifndef _FXPKGFDO_H_
#define _FXPKGFDO_H_

struct FxStaticChildDescription {
    WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER Header;

    CfxDevice* Pdo;
};

class FxPkgFdo : public FxPkgPnp
{
public:
    //
    // Pnp Properties
    //
    FxChildList* m_DefaultDeviceList;

    FxChildList* m_StaticDeviceList;

    //
    // Default target to the attached device in the stack
    //
    FxIoTarget* m_DefaultTarget;

    //
    // A virtual target to yourself. This allows a cx to send
    // the client. It may also be used by the client to send IO to itself.
    //
    FxIoTargetSelf* m_SelfTarget;

private:

    REENUMERATE_SELF_INTERFACE_STANDARD m_SurpriseRemoveAndReenumerateSelfInterface;

    //
    // The following structure contains the function pointer table
    // for the "events" this package can raise.
    //
    FxPnpDeviceFilterResourceRequirements m_DeviceFilterAddResourceRequirements;

    FxPnpDeviceFilterResourceRequirements m_DeviceFilterRemoveResourceRequirements;

    FxPnpDeviceRemoveAddedResources m_DeviceRemoveAddedResources;

    BOOLEAN m_Filter;

    //
    // Table of internal methods to handle PnP minor function codes.
    //
    static const PFN_PNP_POWER_CALLBACK m_FdoPnpFunctionTable[IRP_MN_SURPRISE_REMOVAL + 1];

    //
    // Table of internal methods to handle power minor function codes.
    //
    static const PFN_PNP_POWER_CALLBACK  m_FdoPowerFunctionTable[IRP_MN_QUERY_POWER + 1];

    FxPkgFdo(
        __in PFX_DRIVER_GLOBALS FxDriverGlobals,
        __in CfxDevice *Device
        );

public:

    _Must_inspect_result_
    static
    NTSTATUS
    _Create(
        __in PFX_DRIVER_GLOBALS pGlobals,
        __in CfxDevice * Device,
        __deref_out FxPkgFdo ** PkgFdo
        );

    _Must_inspect_result_
    NTSTATUS
    RegisterCallbacks(
        __in PWDF_FDO_EVENT_CALLBACKS DispatchTable
        );

    _Must_inspect_result_
    NTSTATUS
    CreateDefaultDeviceList(
        __in PWDF_CHILD_LIST_CONFIG ListConfig,
        __in PWDF_OBJECT_ATTRIBUTES ListAttributes
        );

    _Must_inspect_result_
    virtual
    NTSTATUS
    Initialize(
        __in PWDFDEVICE_INIT DeviceInit
        );

    _Must_inspect_result_
    NTSTATUS
    PostCreateDeviceInitialize(
        VOID
        );

    _Must_inspect_result_
    NTSTATUS
    SetFilter(
        __in BOOLEAN Value
        );

    BOOLEAN
    IsFilter(
        VOID
        )
    {
        return m_Filter;
    }

private:

    _Must_inspect_result_
    virtual
    NTSTATUS
    SendIrpSynchronously(
        __inout FxIrp* Irp
        );

    _Must_inspect_result_
    virtual
    NTSTATUS
    FireAndForgetIrp(
        __inout FxIrp *Irp
        );

    _Must_inspect_result_
    static
    NTSTATUS
    _PnpPassDown(
        __in FxPkgPnp* This,
        __inout FxIrp* Irp
        );

    _Must_inspect_result_
    static
    NTSTATUS
    _PnpSurpriseRemoval(
        __inout FxPkgPnp* This,
        __inout FxIrp *Irp
        );

    _Must_inspect_result_
    static
    NTSTATUS
    _PnpQueryDeviceRelations(
        __inout FxPkgPnp* This,
        __inout FxIrp *Irp
        );

    _Must_inspect_result_
    NTSTATUS
    PnpQueryDeviceRelations(
        __inout FxIrp *Irp
        );

    _Must_inspect_result_
    static
    NTSTATUS
    _PnpQueryInterface(
        __inout FxPkgPnp* This,
        __inout FxIrp *Irp
        );

    _Must_inspect_result_
    static
    NTSTATUS
    _PnpQueryCapabilities(
        __inout FxPkgPnp* This,
        __inout FxIrp *Irp
        );

    _Must_inspect_result_
    NTSTATUS
    PnpQueryCapabilities(
        __inout FxIrp *Irp
        );

    VOID
    HandleQueryCapabilities(
        __inout FxIrp *Irp
        );

    VOID
    HandleQueryCapabilitiesCompletion(
        __inout FxIrp *Irp
        );

    _Must_inspect_result_
    static
    NTSTATUS
    _PnpQueryCapabilitiesCompletionRoutine(
        __in    MdDeviceObject DeviceObject,
        __inout MdIrp Irp,
        __inout PVOID Context
        );

    _Must_inspect_result_
    static
    NTSTATUS
    _PnpFilterResourceRequirements(
        __inout FxPkgPnp* This,
        __inout FxIrp *Irp
        );

    _Must_inspect_result_
    NTSTATUS
    PnpFilterResourceRequirements(
        __inout FxIrp *Irp
        );

    _Must_inspect_result_
    static
    NTSTATUS
    _PnpQueryPnpDeviceState(
        __inout FxPkgPnp* This,
        __inout FxIrp *Irp
        );

    _Must_inspect_result_
    static
    NTSTATUS
    _PnpQueryPnpDeviceStateCompletionRoutine(
        __in    MdDeviceObject DeviceObject,
        __inout MdIrp Irp,
        __inout PVOID Context
        );

    VOID
    HandleQueryPnpDeviceStateCompletion(
        __inout FxIrp *Irp
        );

    virtual
    BOOLEAN
    PnpSendStartDeviceDownTheStackOverload(
        VOID
        );

    virtual
    WDF_DEVICE_PNP_STATE
    PnpEventEjectHardwareOverload(
        VOID
        );

    virtual
    WDF_DEVICE_PNP_STATE
    PnpEventCheckForDevicePresenceOverload(
        VOID
        );

    virtual
    WDF_DEVICE_PNP_STATE
    PnpEventPdoRemovedOverload(
        VOID
        );

    virtual
    WDF_DEVICE_PNP_STATE
    PnpGetPostRemoveState(
        VOID
        );

    virtual
    WDF_DEVICE_PNP_STATE
    PnpEventFdoRemovedOverload(
        VOID
        );

    static
    _Must_inspect_result_
    NTSTATUS
    _PowerPassDown(
        __inout FxPkgPnp* This,
        __in FxIrp *Irp
        );

    static
    _Must_inspect_result_
    NTSTATUS
    _DispatchSetPower(
        __inout FxPkgPnp* This,
        __in FxIrp *Irp
        );

    static
    _Must_inspect_result_
    NTSTATUS
    _DispatchQueryPower(
        __inout FxPkgPnp* This,
        __in FxIrp *Irp
        );

    virtual
    _Must_inspect_result_
    NTSTATUS
    PowerCheckParentOverload(
        __out BOOLEAN* ParentOn
        );

    virtual
    WDF_DEVICE_POWER_STATE
    PowerCheckDeviceTypeOverload(
        VOID
        );

    virtual
    WDF_DEVICE_POWER_STATE
    PowerCheckDeviceTypeNPOverload(
        VOID
        );

    virtual
    VOID
    PowerParentPowerDereference(
        VOID
        );

    _Must_inspect_result_
    NTSTATUS
    DispatchSystemSetPower(
        __in FxIrp *Irp
        );

    _Must_inspect_result_
    NTSTATUS
    DispatchDeviceSetPower(
        __in FxIrp *Irp
        );

    _Must_inspect_result_
    NTSTATUS
    DispatchSystemQueryPower(
        __in FxIrp *Irp
        );

    _Must_inspect_result_
    NTSTATUS
    DispatchDeviceQueryPower(
        __in FxIrp *Irp
        );

     _Must_inspect_result_
   NTSTATUS
    RaiseDevicePower(
        __in FxIrp *Irp
        );

    _Must_inspect_result_
    NTSTATUS
    LowerDevicePower(
        __in FxIrp *Irp
        );

    virtual
    VOID
    PowerReleasePendingDeviceIrp(
        __in BOOLEAN IrpMustBePresent = TRUE
        );

    _Must_inspect_result_
    virtual
    NTSTATUS
    ProcessRemoveDeviceOverload(
        __inout FxIrp* Irp
        );

    virtual
    VOID
    DeleteSymbolicLinkOverload(
        __in BOOLEAN GracefulRemove
        );

    virtual
    VOID
    QueryForReenumerationInterface(
        VOID
        );

    virtual
    VOID
    ReleaseReenumerationInterface(
        VOID
        );

    _Must_inspect_result_
    virtual
    NTSTATUS
    AskParentToRemoveAndReenumerate(
        VOID
        );

    _Must_inspect_result_
    virtual
    NTSTATUS
    QueryForPowerThread(
        VOID
        );

    virtual
    const PFN_PNP_POWER_CALLBACK*
    GetDispatchPnp(
        VOID
        )
    {
        return m_FdoPnpFunctionTable;
    }

    virtual
    const PFN_PNP_POWER_CALLBACK*
    GetDispatchPower(
        VOID
        )
    {
        return m_FdoPowerFunctionTable;
    }

    _Must_inspect_result_
    NTSTATUS
    QueryForDsfInterface(
        VOID
        );

public:

    static
    MdCompletionRoutineType
    RaiseDevicePowerCompletion;

protected:
    ~FxPkgFdo();

    static
    MdCompletionRoutineType
    _SystemPowerS0Completion;

    static
    MdCompletionRoutineType
    _SystemPowerSxCompletion;

    _Must_inspect_result_
    static
    NTSTATUS
    STDCALL
    _PnpFilteredStartDeviceCompletionRoutine(
        __in    MdDeviceObject DeviceObject,
        __inout MdIrp Irp,
        __inout PVOID Context
        );

    _Must_inspect_result_
    static
    NTSTATUS
    STDCALL
    _PnpStartDeviceCompletionRoutine(
        __in    MdDeviceObject DeviceObject,
        __inout MdIrp Irp,
        __inout PVOID Context
        );
};

#endif // _FXPKGFDO_H