mirror of
https://github.com/reactos/reactos.git
synced 2025-08-02 06:05:48 +00:00
[WDF] Add Windows Driver Framework files
Takern from Microsoft GitHub repo:
d9c6040fe9
Licensed under MIT
This commit is contained in:
Victor Perevertkin
parent
545df81502
commit
8a978a179f
475 changed files with 285099 additions and 0 deletions
482
sdk/lib/drivers/wdf/shared/irphandlers/pnp/pnppriv.hpp
Normal file
482
sdk/lib/drivers/wdf/shared/irphandlers/pnp/pnppriv.hpp
Normal file
|
|
@ -0,0 +1,482 @@
|
|||
/*++
|
||||
|
||||
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_
|
||||
Loading…
Add table
Add a link
Reference in a new issue