mirror of
https://github.com/reactos/reactos.git
synced 2025-03-10 18:24:02 +00:00
483 lines
12 KiB
C++
483 lines
12 KiB
C++
|
/*++
|
||
|
|
|
||
|
|
Copyright (c) Microsoft Corporation
|
||
|
|
|
||
|
|
Module Name:
|
||
|
|
|
||
|
|
pnppriv.hpp
|
||
|
|
|
||
|
|
Abstract:
|
||
|
|
|
||
|
|
This module implements the pnp package for the driver frameworks.
|
||
|
|
|
||
|
|
Author:
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
Environment:
|
||
|
|
|
||
|
|
Both kernel and user mode
|
||
|
|
|
||
|
|
Revision History:
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
--*/
|
||
|
|
|
||
|
|
#ifndef _PNPPRIV_H_
|
||
|
|
#define _PNPPRIV_H_
|
||
|
|
|
||
|
|
#if ((FX_CORE_MODE)==(FX_CORE_USER_MODE))
|
||
|
|
#define FX_IS_USER_MODE (TRUE)
|
||
|
|
#define FX_IS_KERNEL_MODE (FALSE)
|
||
|
|
#elif ((FX_CORE_MODE)==(FX_CORE_KERNEL_MODE))
|
||
|
|
#define FX_IS_USER_MODE (FALSE)
|
||
|
|
#define FX_IS_KERNEL_MODE (TRUE)
|
||
|
|
#endif
|
||
|
|
|
||
|
|
//
|
||
|
|
// common header file for all irphandler\* files
|
||
|
|
//
|
||
|
|
#include "irphandlerspriv.hpp"
|
||
|
|
|
||
|
|
//
|
||
|
|
// public headers
|
||
|
|
//
|
||
|
|
#include "wdfDevice.h"
|
||
|
|
#include "wdfChildList.h"
|
||
|
|
#include "wdfPdo.h"
|
||
|
|
#include "wdffdo.h"
|
||
|
|
#include "wdfQueryInterface.h"
|
||
|
|
#include "wdfMemory.h"
|
||
|
|
#include "wdfWmi.h"
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
#ifndef _INTERRUPT_COMMON_H_
|
||
|
|
#include "WdfInterrupt.h"
|
||
|
|
#endif
|
||
|
|
#ifndef _WUDFDDI_TYPES_PRIVATE_H_
|
||
|
|
#include "wdfrequest.h"
|
||
|
|
#include "wdfio.h"
|
||
|
|
#endif
|
||
|
|
|
||
|
|
//
|
||
|
|
// private headers
|
||
|
|
//
|
||
|
|
#include "FxWaitLock.hpp"
|
||
|
|
#include "FxTransactionedList.hpp"
|
||
|
|
#include "FxRelatedDeviceList.hpp"
|
||
|
|
#include "FxCollection.hpp"
|
||
|
|
|
||
|
|
// support
|
||
|
|
#include "StringUtil.hpp"
|
||
|
|
#include "FxString.hpp"
|
||
|
|
#include "FxDeviceText.hpp"
|
||
|
|
#include "FxCallback.hpp"
|
||
|
|
#include "FxSystemThread.hpp"
|
||
|
|
#include "FxResource.hpp"
|
||
|
|
|
||
|
|
// io
|
||
|
|
#include "FxPkgIoShared.hpp"
|
||
|
|
|
||
|
|
//
|
||
|
|
// FxDeviceInitShared.hpp is new header with definition of PdoInit split from
|
||
|
|
// FxDeviceInit.hpp
|
||
|
|
//
|
||
|
|
#include "FxDeviceInitShared.hpp"
|
||
|
|
|
||
|
|
// bus
|
||
|
|
#include "FxChildList.hpp"
|
||
|
|
|
||
|
|
// FxDevice To Shared interface header
|
||
|
|
#include "FxDeviceToMxInterface.hpp"
|
||
|
|
|
||
|
|
// mode specific headers
|
||
|
|
#if FX_IS_KERNEL_MODE
|
||
|
|
#include "PnpPrivKM.hpp"
|
||
|
|
#elif FX_IS_USER_MODE
|
||
|
|
#include "PnpPrivUM.hpp"
|
||
|
|
#endif
|
||
|
|
|
||
|
|
#include "FxSpinLock.hpp"
|
||
|
|
|
||
|
|
#if FX_IS_KERNEL_MODE
|
||
|
|
#include "FxInterruptKm.hpp"
|
||
|
|
#elif FX_IS_USER_MODE
|
||
|
|
#include "FxInterruptUm.hpp"
|
||
|
|
#endif
|
||
|
|
|
||
|
|
#if FX_IS_KERNEL_MODE
|
||
|
|
#include "FxPerfTraceKm.hpp"
|
||
|
|
#endif
|
||
|
|
|
||
|
|
#include "FxTelemetry.hpp"
|
||
|
|
|
||
|
|
// pnp
|
||
|
|
#include "FxRelatedDevice.hpp"
|
||
|
|
#include "FxDeviceInterface.hpp"
|
||
|
|
#include "FxQueryInterface.hpp"
|
||
|
|
#include "FxPnpCallbacks.hpp"
|
||
|
|
#include "FxPackage.hpp"
|
||
|
|
#include "FxPkgPnp.hpp"
|
||
|
|
#include "FxWatchDog.hpp"
|
||
|
|
#include "FxPkgPdo.hpp"
|
||
|
|
#include "FxPkgFdo.hpp"
|
||
|
|
|
||
|
|
// wmi
|
||
|
|
#include "FxWmiIrpHandler.hpp"
|
||
|
|
#include "FxWmiProvider.hpp"
|
||
|
|
#include "FxWmiInstance.hpp"
|
||
|
|
|
||
|
|
|
||
|
|
VOID
|
||
|
|
PnpPassThroughQIWorker(
|
||
|
|
__in MxDeviceObject* Device,
|
||
|
|
__inout FxIrp* Irp,
|
||
|
|
__inout FxIrp* ForwardIrp
|
||
|
|
);
|
||
|
|
|
||
|
|
VOID
|
||
|
|
CopyQueryInterfaceToIrpStack(
|
||
|
|
__in PPOWER_THREAD_INTERFACE PowerThreadInterface,
|
||
|
|
__in FxIrp* Irp
|
||
|
|
);
|
||
|
|
|
||
|
|
_Must_inspect_result_
|
||
|
|
NTSTATUS
|
||
|
|
SendDeviceUsageNotification(
|
||
|
|
__in MxDeviceObject* RelatedDevice,
|
||
|
|
__in FxIrp* RelatedIrp,
|
||
|
|
__in MxWorkItem* Workitem,
|
||
|
|
__in FxIrp* OriginalIrp,
|
||
|
|
__in BOOLEAN Revert
|
||
|
|
);
|
||
|
|
|
||
|
|
_Must_inspect_result_
|
||
|
|
NTSTATUS
|
||
|
|
GetStackCapabilities(
|
||
|
|
__in PFX_DRIVER_GLOBALS DriverGlobals,
|
||
|
|
__in MxDeviceObject* DeviceInStack,
|
||
|
|
__in_opt PD3COLD_SUPPORT_INTERFACE D3ColdInterface,
|
||
|
|
__out PSTACK_DEVICE_CAPABILITIES Capabilities
|
||
|
|
);
|
||
|
|
|
||
|
|
VOID
|
||
|
|
SetD3ColdSupport(
|
||
|
|
__in PFX_DRIVER_GLOBALS DriverGlobals,
|
||
|
|
__in MxDeviceObject* DeviceInStack,
|
||
|
|
__in PD3COLD_SUPPORT_INTERFACE D3ColdInterface,
|
||
|
|
__in BOOLEAN UseD3Cold
|
||
|
|
);
|
||
|
|
|
||
|
|
#define SET_TRI_STATE_FROM_STATE_BITS(state, S, FieldName) \
|
||
|
|
{ \
|
||
|
|
switch (state & (FxPnpState##FieldName##Mask)) { \
|
||
|
|
case FxPnpState##FieldName##False : \
|
||
|
|
S->FieldName = WdfFalse; \
|
||
|
|
break; \
|
||
|
|
case FxPnpState##FieldName##True: \
|
||
|
|
S->FieldName = WdfTrue; \
|
||
|
|
break; \
|
||
|
|
case FxPnpState##FieldName##UseDefault : \
|
||
|
|
default: \
|
||
|
|
S->FieldName = WdfUseDefault; \
|
||
|
|
break; \
|
||
|
|
} \
|
||
|
|
}
|
||
|
|
|
||
|
|
LONG
|
||
|
|
__inline
|
||
|
|
FxGetValueBits(
|
||
|
|
__in WDF_TRI_STATE State,
|
||
|
|
__in LONG TrueValue,
|
||
|
|
__in LONG UseDefaultValue
|
||
|
|
)
|
||
|
|
{
|
||
|
|
switch (State) {
|
||
|
|
case WdfFalse: return 0x0;
|
||
|
|
case WdfTrue: return TrueValue;
|
||
|
|
case WdfUseDefault:
|
||
|
|
default: return UseDefaultValue;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
#define GET_PNP_STATE_BITS_FROM_STRUCT(S, FieldName)\
|
||
|
|
FxGetValueBits(S->FieldName, \
|
||
|
|
FxPnpState##FieldName##True, \
|
||
|
|
FxPnpState##FieldName##UseDefault)
|
||
|
|
|
||
|
|
#define GET_PNP_CAP_BITS_FROM_STRUCT(S, FieldName) \
|
||
|
|
FxGetValueBits(S->FieldName, \
|
||
|
|
FxPnpCap##FieldName##True, \
|
||
|
|
FxPnpCap##FieldName##UseDefault)
|
||
|
|
|
||
|
|
#define GET_POWER_CAP_BITS_FROM_STRUCT(S, FieldName)\
|
||
|
|
FxGetValueBits(S->FieldName, \
|
||
|
|
FxPowerCap##FieldName##True, \
|
||
|
|
FxPowerCap##FieldName##UseDefault)
|
||
|
|
|
||
|
|
__inline
|
||
|
|
VOID
|
||
|
|
FxSetPnpDeviceStateBit(
|
||
|
|
__in PNP_DEVICE_STATE* PnpDeviceState,
|
||
|
|
__in LONG ExternalState,
|
||
|
|
__in LONG InternalState,
|
||
|
|
__in LONG BitMask,
|
||
|
|
__in LONG TrueValue
|
||
|
|
)
|
||
|
|
{
|
||
|
|
LONG bits;
|
||
|
|
|
||
|
|
bits = InternalState & BitMask;
|
||
|
|
|
||
|
|
if (bits == TrueValue) {
|
||
|
|
*PnpDeviceState |= ExternalState;
|
||
|
|
}
|
||
|
|
else if (bits == 0) { // 0 is the always false for every bit-set
|
||
|
|
*PnpDeviceState &= ~ExternalState;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
#define SET_PNP_DEVICE_STATE_BIT(State, ExternalState, value, Name) \
|
||
|
|
FxSetPnpDeviceStateBit(State, \
|
||
|
|
ExternalState, \
|
||
|
|
state, \
|
||
|
|
FxPnpState##Name##Mask, \
|
||
|
|
FxPnpState##Name##True)
|
||
|
|
|
||
|
|
#define SET_PNP_CAP_IF_TRUE(caps, pCaps, FieldName) \
|
||
|
|
{ \
|
||
|
|
if ((caps & FxPnpCap##FieldName##Mask) == FxPnpCap##FieldName##True) { \
|
||
|
|
pCaps->FieldName = TRUE; \
|
||
|
|
} \
|
||
|
|
}
|
||
|
|
|
||
|
|
#define SET_PNP_CAP_IF_FALSE(caps, pCaps, FieldName) \
|
||
|
|
{ \
|
||
|
|
if ((caps & FxPnpCap##FieldName##Mask) == FxPnpCap##FieldName##False) { \
|
||
|
|
pCaps->FieldName = FALSE; \
|
||
|
|
} \
|
||
|
|
}
|
||
|
|
|
||
|
|
#define SET_PNP_CAP(caps, pCaps, FieldName) \
|
||
|
|
{ \
|
||
|
|
if ((caps & FxPnpCap##FieldName##Mask) == FxPnpCap##FieldName##False) { \
|
||
|
|
pCaps->FieldName = FALSE; \
|
||
|
|
} \
|
||
|
|
else if ((caps & FxPnpCap##FieldName##Mask) == FxPnpCap##FieldName##True) { \
|
||
|
|
pCaps->FieldName = TRUE; \
|
||
|
|
} \
|
||
|
|
}
|
||
|
|
|
||
|
|
#define SET_POWER_CAP(caps, pCaps, FieldName) \
|
||
|
|
{ \
|
||
|
|
if ((caps & FxPowerCap##FieldName##Mask) == FxPowerCap##FieldName##False) { \
|
||
|
|
pCaps->FieldName = FALSE; \
|
||
|
|
} \
|
||
|
|
else if ((caps & FxPowerCap##FieldName##Mask) == FxPowerCap##FieldName##True) { \
|
||
|
|
pCaps->FieldName = TRUE; \
|
||
|
|
} \
|
||
|
|
}
|
||
|
|
|
||
|
|
_Must_inspect_result_
|
||
|
|
PVOID
|
||
|
|
GetIoMgrObjectForWorkItemAllocation(
|
||
|
|
VOID
|
||
|
|
);
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
typedef struct _WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_V1_7 {
|
||
|
|
//
|
||
|
|
// Size of this structure in bytes
|
||
|
|
//
|
||
|
|
ULONG Size;
|
||
|
|
|
||
|
|
//
|
||
|
|
// Indicates whether the device can wake itself up while the machine is in
|
||
|
|
// S0.
|
||
|
|
//
|
||
|
|
WDF_POWER_POLICY_S0_IDLE_CAPABILITIES IdleCaps;
|
||
|
|
|
||
|
|
//
|
||
|
|
// The low power state in which the device will be placed when it is idled
|
||
|
|
// out while the machine is in S0.
|
||
|
|
//
|
||
|
|
DEVICE_POWER_STATE DxState;
|
||
|
|
|
||
|
|
//
|
||
|
|
// Amount of time the device must be idle before idling out. Timeout is in
|
||
|
|
// milliseconds.
|
||
|
|
//
|
||
|
|
ULONG IdleTimeout;
|
||
|
|
|
||
|
|
//
|
||
|
|
// Inidcates whether a user can control the idle policy of the device.
|
||
|
|
// By default, a user is allowed to change the policy.
|
||
|
|
//
|
||
|
|
WDF_POWER_POLICY_S0_IDLE_USER_CONTROL UserControlOfIdleSettings;
|
||
|
|
|
||
|
|
//
|
||
|
|
// If WdfTrue, idling out while the machine is in S0 will be enabled.
|
||
|
|
//
|
||
|
|
// If WdfFalse, idling out will be disabled.
|
||
|
|
//
|
||
|
|
// If WdfUseDefault, the idling out will be enabled. If
|
||
|
|
// UserControlOfIdleSettings is set to IdleAllowUserControl, the user's
|
||
|
|
// settings will override the default.
|
||
|
|
//
|
||
|
|
WDF_TRI_STATE Enabled;
|
||
|
|
|
||
|
|
} WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_V1_7, *PWDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_V1_7;
|
||
|
|
|
||
|
|
typedef struct _WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_V1_9 {
|
||
|
|
//
|
||
|
|
// Size of this structure in bytes
|
||
|
|
//
|
||
|
|
ULONG Size;
|
||
|
|
|
||
|
|
//
|
||
|
|
// Indicates whether the device can wake itself up while the machine is in
|
||
|
|
// S0.
|
||
|
|
//
|
||
|
|
WDF_POWER_POLICY_S0_IDLE_CAPABILITIES IdleCaps;
|
||
|
|
|
||
|
|
//
|
||
|
|
// The low power state in which the device will be placed when it is idled
|
||
|
|
// out while the machine is in S0.
|
||
|
|
//
|
||
|
|
DEVICE_POWER_STATE DxState;
|
||
|
|
|
||
|
|
//
|
||
|
|
// Amount of time the device must be idle before idling out. Timeout is in
|
||
|
|
// milliseconds.
|
||
|
|
//
|
||
|
|
ULONG IdleTimeout;
|
||
|
|
|
||
|
|
//
|
||
|
|
// Inidcates whether a user can control the idle policy of the device.
|
||
|
|
// By default, a user is allowed to change the policy.
|
||
|
|
//
|
||
|
|
WDF_POWER_POLICY_S0_IDLE_USER_CONTROL UserControlOfIdleSettings;
|
||
|
|
|
||
|
|
//
|
||
|
|
// If WdfTrue, idling out while the machine is in S0 will be enabled.
|
||
|
|
//
|
||
|
|
// If WdfFalse, idling out will be disabled.
|
||
|
|
//
|
||
|
|
// If WdfUseDefault, the idling out will be enabled. If
|
||
|
|
// UserControlOfIdleSettings is set to IdleAllowUserControl, the user's
|
||
|
|
// settings will override the default.
|
||
|
|
//
|
||
|
|
WDF_TRI_STATE Enabled;
|
||
|
|
|
||
|
|
//
|
||
|
|
// This field is applicable only when IdleCaps == IdleCannotWakeFromS0
|
||
|
|
// If WdfTrue,device is powered up on System Wake even if device is idle
|
||
|
|
// If WdfFalse, device is not powered up on system wake if it is idle
|
||
|
|
// If WdfUseDefault, the behavior is same as WdfFalse
|
||
|
|
//
|
||
|
|
WDF_TRI_STATE PowerUpIdleDeviceOnSystemWake;
|
||
|
|
|
||
|
|
} WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_V1_9,
|
||
|
|
*PWDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_V1_9;
|
||
|
|
|
||
|
|
typedef struct _WDF_PDO_EVENT_CALLBACKS_V1_9 {
|
||
|
|
//
|
||
|
|
// The size of this structure in bytes
|
||
|
|
//
|
||
|
|
ULONG Size;
|
||
|
|
|
||
|
|
//
|
||
|
|
// Called in response to IRP_MN_QUERY_RESOURCES
|
||
|
|
//
|
||
|
|
PFN_WDF_DEVICE_RESOURCES_QUERY EvtDeviceResourcesQuery;
|
||
|
|
|
||
|
|
//
|
||
|
|
// Called in response to IRP_MN_QUERY_RESOURCE_REQUIREMENTS
|
||
|
|
//
|
||
|
|
PFN_WDF_DEVICE_RESOURCE_REQUIREMENTS_QUERY EvtDeviceResourceRequirementsQuery;
|
||
|
|
|
||
|
|
//
|
||
|
|
// Called in response to IRP_MN_EJECT
|
||
|
|
//
|
||
|
|
PFN_WDF_DEVICE_EJECT EvtDeviceEject;
|
||
|
|
|
||
|
|
//
|
||
|
|
// Called in response to IRP_MN_SET_LOCK
|
||
|
|
//
|
||
|
|
PFN_WDF_DEVICE_SET_LOCK EvtDeviceSetLock;
|
||
|
|
|
||
|
|
//
|
||
|
|
// Called in response to the power policy owner sending a wait wake to the
|
||
|
|
// PDO. Bus generic arming shoulding occur here.
|
||
|
|
//
|
||
|
|
PFN_WDF_DEVICE_ENABLE_WAKE_AT_BUS EvtDeviceEnableWakeAtBus;
|
||
|
|
|
||
|
|
//
|
||
|
|
// Called in response to the power policy owner sending a wait wake to the
|
||
|
|
// PDO. Bus generic disarming shoulding occur here.
|
||
|
|
//
|
||
|
|
PFN_WDF_DEVICE_DISABLE_WAKE_AT_BUS EvtDeviceDisableWakeAtBus;
|
||
|
|
|
||
|
|
} WDF_PDO_EVENT_CALLBACKS_V1_9, *PWDF_PDO_EVENT_CALLBACKS_V1_9;
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
typedef struct _WDF_INTERRUPT_INFO_V1_7 {
|
||
|
|
//
|
||
|
|
// Size of this structure in bytes
|
||
|
|
//
|
||
|
|
ULONG Size;
|
||
|
|
|
||
|
|
ULONG64 Reserved1;
|
||
|
|
|
||
|
|
KAFFINITY TargetProcessorSet;
|
||
|
|
|
||
|
|
ULONG Reserved2;
|
||
|
|
|
||
|
|
ULONG MessageNumber;
|
||
|
|
|
||
|
|
ULONG Vector;
|
||
|
|
|
||
|
|
KIRQL Irql;
|
||
|
|
|
||
|
|
KINTERRUPT_MODE Mode;
|
||
|
|
|
||
|
|
WDF_INTERRUPT_POLARITY Polarity;
|
||
|
|
|
||
|
|
BOOLEAN MessageSignaled;
|
||
|
|
|
||
|
|
// CM_SHARE_DISPOSITION
|
||
|
|
UCHAR ShareDisposition;
|
||
|
|
|
||
|
|
} WDF_INTERRUPT_INFO_V1_7, *PWDF_INTERRUPT_INFO_V1_7;
|
||
|
|
|
||
|
|
typedef struct _WDF_INTERRUPT_INFO_V1_7 *PWDF_INTERRUPT_INFO_V1_7;
|
||
|
|
typedef const struct _WDF_INTERRUPT_INFO_V1_7 *PCWDF_INTERRUPT_INFO_V1_7;
|
||
|
|
|
||
|
|
#endif // _PNPPRIV_H_
|