wdfdevice.h 标头

项目
08/08/2023

wdf 使用此标头。有关详细信息，请参阅：

本主题按类别对 Windows 驱动程序框架 (WDF) 设备对象引用进行排序。

此页上的类别包括：

常规框架设备对象事件回调函数
常规框架设备对象初始化方法
常规框架设备对象方法
常规框架设备对象结构和枚举
设备对象结构的初始化函数

常规框架设备对象事件回调函数

常规框架设备对象初始化方法

常规框架设备对象方法

常规框架设备对象结构和枚举

设备对象结构的初始化函数

wdfdevice.h 包含以下编程接口：

函数


WDF_DEVICE_INTERFACE_PROPERTY_DATA_INIT WDF_DEVICE_INTERFACE_PROPERTY_DATA_INIT 函数初始化驱动程序的WDF_DEVICE_INTERFACE_PROPERTY_DATA结构。
WDF_DEVICE_PNP_CAPABILITIES_INIT WDF_DEVICE_PNP_CAPABILITIES_INIT 函数初始化WDF_DEVICE_PNP_CAPABILITIES 结构。
WDF_DEVICE_POWER_CAPABILITIES_INIT WDF_DEVICE_POWER_CAPABILITIES_INIT 函数初始化 WDF_DEVICE_POWER_CAPABILITIES 结构。
WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT 函数初始化驱动程序的WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS结构。
WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS_INIT WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS_INIT 函数初始化驱动程序的WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS结构。
WDF_DEVICE_PROPERTY_DATA_INIT WDF_DEVICE_PROPERTY_DATA_INIT 函数初始化驱动程序的WDF_DEVICE_PROPERTY_DATA结构。
WDF_DEVICE_STATE_INIT WDF_DEVICE_STATE_INIT 函数初始化驱动程序的WDF_DEVICE_STATE结构。
WDF_FILEOBJECT_CONFIG_INIT WDF_FILEOBJECT_CONFIG_INIT 函数初始化驱动程序的WDF_FILEOBJECT_CONFIG结构。
WDF_IO_TYPE_CONFIG_INIT WDF_IO_TYPE_CONFIG_INIT 函数初始化驱动程序的WDF_IO_TYPE_CONFIG结构。
WDF_PNPPOWER_EVENT_CALLBACKS_INIT WDF_PNPPOWER_EVENT_CALLBACKS_INIT 函数初始化驱动程序的WDF_PNPPOWER_EVENT_CALLBACKS结构。
WDF_POWER_FRAMEWORK_SETTINGS_INIT WDF_POWER_FRAMEWORK_SETTINGS_INIT 函数初始化WDF_POWER_FRAMEWORK_SETTINGS 结构。
WDF_POWER_POLICY_EVENT_CALLBACKS_INIT WDF_POWER_POLICY_EVENT_CALLBACKS_INIT 函数初始化驱动程序的WDF_POWER_POLICY_EVENT_CALLBACKS结构。
WDF_REMOVE_LOCK_OPTIONS_INIT WDF_REMOVE_LOCK_OPTIONS_INIT 函数初始化WDF_REMOVE_LOCK_OPTIONS 结构。
WdfDeviceAddDependentUsageDeviceObject WdfDeviceAddDependentUsageDeviceObject 方法指示当指定的设备用于存储特殊文件时，指定的设备依赖于另一个设备。
WdfDeviceAddRemovalRelationsPhysicalDevice WdfDeviceAddRemovalRelationsPhysicalDevice 方法指示在删除另一个指定设备时必须删除指定的设备。
WdfDeviceAllocAndQueryInterfaceProperty WdfDeviceAllocAndQueryInterfaceProperty 方法分配缓冲区并检索指定的设备接口属性。
WdfDeviceAllocAndQueryProperty WdfDeviceAllocAndQueryProperty 方法分配缓冲区并检索指定的设备属性。
WdfDeviceAllocAndQueryPropertyEx WdfDeviceAllocAndQueryPropertyEx 方法分配缓冲区并检索指定的设备属性。
WdfDeviceAssignInterfaceProperty WdfDeviceAssignInterfaceProperty 方法修改设备接口属性的当前值。
WdfDeviceAssignMofResourceName WdfDeviceAssignMofResourceName 方法为指定设备注册 MOF 资源名称。
WdfDeviceAssignProperty WdfDeviceAssignProperty 方法修改设备属性的当前设置。
WdfDeviceAssignS0IdleSettings WdfDeviceAssignS0IdleSettings 方法提供驱动程序提供的信息，当设备空闲且系统处于工作 (S0) 状态时，框架将使用这些信息。
WdfDeviceAssignSxWakeSettings WdfDeviceAssignSxWakeSettings 方法提供有关设备在设备和系统都处于低功耗状态时触发唤醒信号的能力的驱动程序信息。
WdfDeviceClearRemovalRelationsDevices WdfDeviceClearRemovalRelationsDevices 方法从删除指定设备时必须删除的设备列表中删除所有设备。
WdfDeviceConfigureRequestDispatching WdfDeviceConfigureRequestDispatching 方法使框架将指定类型的 I/O 请求排到指定的 I/O 队列。
WdfDeviceConfigureWdmIrpDispatchCallback WdfDeviceConfigureWdmIrpDispatchCallback 方法注册驱动程序的 EvtDeviceWdmIrpDispatch 回调函数。
WdfDeviceCreate WdfDeviceCreate 方法创建框架设备对象。
WdfDeviceCreateDeviceInterface WdfDeviceCreateDeviceInterface 方法为指定设备创建设备接口。
WdfDeviceCreateSymbolicLink WdfDeviceCreateSymbolicLink 方法创建指向指定设备的符号链接。
WdfDeviceEnqueueRequest WdfDeviceEnqueueRequest 方法将指定的 I/O 请求传递给框架，以便框架随后可以将请求添加到驱动程序为指定设备创建的 I/O 队列之一。
WdfDeviceGetAlignmentRequirement WdfDeviceGetAlignmentRequirement 方法检索设备的内存传输操作的地址对齐要求。
WdfDeviceGetCharacteristics WdfDeviceGetCharacteristics 方法返回指定设备的设备特征。
WdfDeviceGetDefaultQueue WdfDeviceGetDefaultQueue 方法返回设备的默认 I/O 队列的句柄。
WdfDeviceGetDevicePnpState WdfDeviceGetDevicePnpState 方法返回指定设备的框架即插即用状态机的当前状态。
WdfDeviceGetDevicePowerPolicyState WdfDeviceGetDevicePowerPolicyState 方法返回指定设备的框架电源策略状态机的当前状态。
WdfDeviceGetDevicePowerState WdfDeviceGetDevicePowerState 方法返回指定设备的框架电源状态机的当前状态。
WdfDeviceGetDeviceStackIoType WdfDeviceGetDeviceStackIoType 方法检索框架用于设备的缓冲区访问方法。
WdfDeviceGetDeviceState WdfDeviceGetDeviceState 方法检索指定设备的设备状态。
WdfDeviceGetDriver WdfDeviceGetDriver 方法返回与指定的框架设备对象关联的框架驱动程序对象的句柄。
WdfDeviceGetFileObject WdfDeviceGetFileObject 方法返回与指定的 WDM 文件对象关联的框架文件对象的句柄。
WdfDeviceGetHardwareRegisterMappedAddress 驱动程序调用 WdfDeviceGetHardwareRegisterMappedAddress 以获取它之前使用 WdfDeviceMapIoSpace 映射的内存资源的用户模式映射地址。
WdfDeviceGetIoTarget WdfDeviceGetIoTarget 方法返回指定设备的函数或筛选器驱动程序的本地 I/O 目标的句柄。
WdfDeviceGetSystemPowerAction WdfDeviceGetSystemPowerAction 方法返回计算机当前发生的系统电源操作（如果有）。
WdfDeviceIndicateWakeStatus WdfDeviceIndicateWakeStatus 方法通知框架，调用总线驱动程序已停止等待指定的设备在总线上触发唤醒信号。
WdfDeviceInitAssignName WdfDeviceInitAssignName 方法将设备名称分配给设备的设备对象。
WdfDeviceInitAssignSDDLString WdfDeviceInitAssignSDDLString 方法为设备分配安全设置。
WdfDeviceInitAssignWdmIrpPreprocessCallback WdfDeviceInitAssignWdmIrpPreprocessCallback 方法注册回调函数以处理 IRP 主要函数代码以及（可选）与主函数代码关联的一个或多个次要函数代码。
WdfDeviceInitFree WdfDeviceInitFree 方法解除分配WDFDEVICE_INIT结构。
WdfDeviceInitRegisterPnpStateChangeCallback WdfDeviceInitRegisterPnpStateChangeCallback 方法注册驱动程序提供的事件回调函数，当设备的即插即用状态机更改状态时，框架将调用该函数。
WdfDeviceInitRegisterPowerPolicyStateChangeCallback WdfDeviceInitRegisterPowerPolicyStateChangeCallback 方法注册驱动程序提供的事件回调函数，当设备的电源策略状态机更改状态时，框架将调用该函数。
WdfDeviceInitRegisterPowerStateChangeCallback WdfDeviceInitRegisterPowerStateChangeCallback 方法注册驱动程序提供的事件回调函数，框架在设备的电源状态机更改状态时调用该函数。
WdfDeviceInitSetCharacteristics WdfDeviceInitSetCharacteristics 方法为指定设备设置设备特征。
WdfDeviceInitSetDeviceClass WdfDeviceInitSetDeviceClass 方法指定标识设备设置类的 GUID。
WdfDeviceInitSetDeviceType WdfDeviceInitSetDeviceType 方法设置指定设备的设备类型。
WdfDeviceInitSetExclusive WdfDeviceInitSetExclusive 方法指示指定的设备是否为独占设备。
WdfDeviceInitSetFileObjectConfig WdfDeviceInitSetFileObjectConfig 方法注册事件回调函数并设置驱动程序框架文件对象的配置信息。
WdfDeviceInitSetIoInCallerContextCallback WdfDeviceInitSetIoInCallerContextCallback 方法注册驱动程序的 EvtIoInCallerContext 事件回调函数。
WdfDeviceInitSetIoType WdfDeviceInitSetIoType 方法设置驱动程序如何访问指定设备的读取和写入请求中包含的数据缓冲区的方法或首选项。
WdfDeviceInitSetIoTypeEx WdfDeviceInitSetIoTypeEx 方法设置驱动程序访问指定设备读取和写入请求中包含的数据缓冲区以及设备 I/O 控制请求的方法或首选项。
WdfDeviceInitSetPnpPowerEventCallbacks WdfDeviceInitSetPnpPowerEventCallbacks 方法注册驱动程序的即插即用和电源管理事件回调函数。
WdfDeviceInitSetPowerInrush WdfDeviceInitSetPowerInrush 方法通知电源管理器，指定的设备在启动时需要当前的浪涌。
WdfDeviceInitSetPowerNotPageable WdfDeviceInitSetPowerNotPageable 方法通知电源管理器，当系统在睡眠状态与工作 (S0) 状态之间转换时，驱动程序将无法访问可分页数据。
WdfDeviceInitSetPowerPageable WdfDeviceInitSetPowerPageable 方法通知电源管理器，当系统在睡眠状态与工作 (S0) 状态之间转换时，驱动程序必须能够访问可分页数据。
WdfDeviceInitSetPowerPolicyEventCallbacks WdfDeviceInitSetPowerPolicyEventCallbacks 方法注册驱动程序的电源策略事件回调函数。
WdfDeviceInitSetPowerPolicyOwnership WdfDeviceInitSetPowerPolicyOwnership 方法确定调用驱动程序是否为指定设备的电源策略所有者。
WdfDeviceInitSetReleaseHardwareOrderOnFailure WdfDeviceInitSetReleaseHardwareOrderOnFailure 方法指定框架是在设备故障后立即调用驱动程序的 EvtDeviceReleaseHardware 回调函数，还是等待所有子设备已删除。
WdfDeviceInitSetRemoveLockOptions WdfDeviceInitSetRemoveLockOptions 方法会导致框架在将任何类型的 IRP 传递给驱动程序之前获取删除锁。
WdfDeviceInitSetRequestAttributes WdfDeviceInitSetRequestAttributes 方法设置对象属性，这些属性将用于框架从设备的 I/O 队列传递到驱动程序的所有框架请求对象。
WdfDeviceMapIoSpace WdfDeviceMapIoSpace 函数将给定的物理地址范围映射到系统地址空间，并返回伪基址。
WdfDeviceOpenDevicemapKey WdfDeviceOpenDevicemapKey 方法打开 DEVICEMAP 键并创建表示注册表项的框架注册表项对象。
WdfDeviceOpenRegistryKey WdfDeviceOpenRegistryKey 方法在注册表中打开设备的硬件密钥或驱动程序的软件密钥，并创建表示注册表项的框架注册表项对象。
WdfDevicePostEvent WdfDevicePostEvent 方法以异步方式通知正在从驱动程序等待指定事件的应用程序。
WdfDeviceQueryInterfaceProperty WdfDeviceQueryInterfaceProperty 方法检索指定的设备接口属性。
WdfDeviceQueryProperty WdfDeviceQueryProperty 方法检索指定的设备属性。
WdfDeviceQueryPropertyEx WdfDeviceQueryPropertyEx 方法检索指定的设备属性。
WdfDeviceReadFromHardware 框架在内部使用 WdfDeviceReadFromHardware 方法。请勿使用。
WdfDeviceRemoveDependentUsageDeviceObject WdfDeviceRemoveDependentUsageDeviceObject 方法指示使用指定的设备存储特殊文件时，指定的设备不再依赖于另一个设备。
WdfDeviceRemoveRemovalRelationsPhysicalDevice WdfDeviceRemoveRemovalRelationsPhysicalDevice 方法从删除另一个指定设备时必须删除的设备列表中删除指定的设备。
WdfDeviceResumeIdle WdfDeviceResumeIdle 方法通知框架指定的设备未使用，如果设备保持空闲状态，可以将其置于低功耗状态。
WdfDeviceResumeIdleWithTag WdfDeviceResumeIdleWithTag 宏递减指定框架设备对象的电源引用计数，并将驱动程序的当前文件名和行号分配给引用。宏还会将标记值分配给引用。
WdfDeviceRetrieveCompanionTarget 此 WdfDeviceRetrieveCompanionTarget 函数文章仅供内部使用。
WdfDeviceRetrieveDeviceDirectoryString 详细了解：WdfDeviceRetrieveDeviceDirectoryString 函数
WdfDeviceRetrieveDeviceInterfaceString WdfDeviceRetrieveDeviceInterfaceString 方法检索操作系统分配给驱动程序为指定设备注册的设备接口的符号链接名称。
WdfDeviceRetrieveDeviceName WdfDeviceRetrieveDeviceName 方法返回指定设备的设备名称。
WdfDeviceSetAlignmentRequirement WdfDeviceSetAlignmentRequirement 方法为设备在内存传输操作期间使用的数据缓冲区注册驱动程序的首选地址对齐方式。
WdfDeviceSetBusInformationForChildren WdfDeviceSetBusInformationForChildren 方法设置有关总线驱动程序支持的信息。此信息可用于总线的子设备。
WdfDeviceSetCharacteristics WdfDeviceSetCharacteristics 方法为指定设备设置设备特征。
WdfDeviceSetDeviceInterfaceState WdfDeviceSetDeviceInterfaceState 方法为指定设备启用或禁用设备接口。
WdfDeviceSetDeviceInterfaceStateEx 详细了解：WdfDeviceSetDeviceInterfaceStateEx
WdfDeviceSetDeviceState WdfDeviceSetDeviceState 方法设置指定设备的设备状态。
WdfDeviceSetFailed WdfDeviceSetFailed 方法通知框架驱动程序遇到与指定设备关联的硬件或软件错误。
WdfDeviceSetPnpCapabilities WdfDeviceSetPnpCapabilities 方法报告设备的即插即用功能。
WdfDeviceSetPowerCapabilities WdfDeviceSetPowerCapabilities 方法报告设备的电源功能。
WdfDeviceSetSpecialFileSupport WdfDeviceSetSpecialFileSupport 方法启用或禁用函数驱动程序对指定设备的特殊文件的支持。
WdfDeviceSetStaticStopRemove WdfDeviceSetStaticStopRemove 方法通知框架是否可以停止和删除设备。
WdfDeviceStopIdle WdfDeviceStopIdle 方法通知框架，指定的设备必须置于其工作 (D0) 电源状态。
WdfDeviceStopIdleWithTag WdfDeviceStopIdleWithTag 宏递增指定框架设备对象的电源引用计数，并将驱动程序的当前文件名和行号分配给引用。宏还会将标记值分配给引用。
WdfDeviceUnmapIoSpace WdfDeviceUnmapIoSpace 函数取消映射以前由 WdfDeviceMapIoSpace 函数映射的指定物理地址范围。
WdfDeviceWdmAssignPowerFrameworkSettings WdfDeviceWdmAssignPowerFrameworkSettings 方法为单组件设备注册电源管理框架 (PoFx) 设置。
WdfDeviceWdmDispatchIrp WdfDeviceWdmDispatchIrp 方法将已调度的 IRP 从 EvtDeviceWdmIrpDispatch 返回给框架。
WdfDeviceWdmDispatchIrpToIoQueue WdfDeviceWdmDispatchIrpToIoQueue 方法将 IRP 转发到指定的 I/O 队列。
WdfDeviceWdmDispatchPreprocessedIrp WdfDeviceWdmDispatchPreprocessedIrp 方法将预处理的 IRP 返回到框架。
WdfDeviceWdmGetAttachedDevice WdfDeviceWdmGetAttachedDevice 方法返回设备堆栈中下一个较低的 WDM 设备对象。
WdfDeviceWdmGetDeviceObject WdfDeviceWdmGetDeviceObject 方法返回与指定框架设备对象关联的 Windows 驱动程序模型 (WDM) 设备对象。
WdfDeviceWdmGetPhysicalDevice WdfDeviceWdmGetPhysicalDevice 方法从设备堆栈检索物理设备的 WDM PDO。
WdfDeviceWriteToHardware WdfDeviceWriteToHardware 方法由框架在内部使用。请勿使用。
WdfDevStateIsNP WdfDevStateIsNP 方法返回一个布尔值，该值指示指定的电源状态或电源策略状态是否为不可分页状态。
WdfDevStateNormalize WdfDevStateNormalize 方法从指定的框架状态机值中删除额外的位，以便驱动程序可以将该值用作计算机状态数组中的索引。
WdfWdmDeviceGetWdfDeviceHandle WdfWdmDeviceGetWdfDeviceHandle 方法返回与指定的 WDM 设备对象关联的框架设备对象的句柄。

回调函数


EVT_WDF_DEVICE_ARM_WAKE_FROM_S0 驱动程序的 EvtDeviceArmWakeFromS0 事件回调函数臂 (即启用) 设备，以便在处于低功耗设备状态时触发唤醒信号（如果系统保持工作状态 (S0) ）。
EVT_WDF_DEVICE_ARM_WAKE_FROM_SX 驱动程序的 EvtDeviceArmWakeFromSx 事件回调函数臂 (即启用) 设备，以便在设备处于低功耗设备状态时可以触发唤醒信号。
EVT_WDF_DEVICE_ARM_WAKE_FROM_SX_WITH_REASON 驱动程序的 EvtDeviceArmWakeFromSxWithReason 事件回调函数臂 (即启用) 设备，以便在处于低功耗设备状态时可以触发唤醒信号。
EVT_WDF_DEVICE_D0_ENTRY 驱动程序的 EvtDeviceD0Entry 事件回调函数执行驱动程序的设备进入 D0 电源状态时所需的操作。
EVT_WDF_DEVICE_D0_ENTRY_POST_HARDWARE_ENABLED 详细了解：EVT_WDF_DEVICE_D0_ENTRY_POST_HARDWARE_ENABLED
EVT_WDF_DEVICE_D0_ENTRY_POST_INTERRUPTS_ENABLED 驱动程序的 EvtDeviceD0EntryPostInterruptsEnabled 事件回调函数执行驱动程序启用设备硬件中断后所需的设备特定操作。
EVT_WDF_DEVICE_D0_EXIT 驱动程序的 EvtDeviceD0Exit 事件回调函数执行驱动程序的设备离开 D0 电源状态时所需的操作。
EVT_WDF_DEVICE_D0_EXIT_PRE_HARDWARE_DISABLED 详细了解：EVT_WDF_DEVICE_D0_EXIT_PRE_HARDWARE_DISABLED
EVT_WDF_DEVICE_D0_EXIT_PRE_INTERRUPTS_DISABLED 驱动程序的 EvtDeviceD0ExitPreInterruptsDisabled 事件回调函数执行特定于设备的操作，这些操作在驱动程序禁用设备的硬件中断之前是必需的。
EVT_WDF_DEVICE_DISARM_WAKE_FROM_S0 驱动程序的 EvtDeviceDisarmWakeFromS0 事件回调函数解除 (即，如果系统保持系统工作状态 (S0) ，则禁用) 设备在低功耗设备状态下触发唤醒信号的能力。
EVT_WDF_DEVICE_DISARM_WAKE_FROM_SX 驱动程序的 EvtDeviceDisarmWakeFromSx 事件回调函数解除 (即禁用) 设备在设备和系统处于低功耗状态时触发唤醒信号的能力。
EVT_WDF_DEVICE_FILE_CREATE 驱动程序的 EvtDeviceFileCreate 回调函数处理应用程序请求访问设备时必须执行的操作。
EVT_WDF_DEVICE_PNP_STATE_CHANGE_NOTIFICATION 驱动程序的 EvtDevicePnpStateChange 事件回调函数通知驱动程序设备的即插即用 (PnP) 状态机正在从一种状态移动到另一种状态。
EVT_WDF_DEVICE_POWER_POLICY_STATE_CHANGE_NOTIFICATION 驱动程序的 EvtDevicePowerPolicyStateChange 事件回调函数通知驱动程序设备的电源策略状态机正在从一种状态移动到另一种状态。
EVT_WDF_DEVICE_POWER_STATE_CHANGE_NOTIFICATION 驱动程序的 EvtDevicePowerStateChange 事件回调函数通知驱动程序设备的电源状态机正在从一种状态移动到另一种状态。
EVT_WDF_DEVICE_PREPARE_HARDWARE 驱动程序的 EvtDevicePrepareHardware 事件回调函数执行使设备可供驱动程序访问所需的任何操作。
EVT_WDF_DEVICE_QUERY_REMOVE 驱动程序的 EvtDeviceQueryRemove 事件回调函数确定是否可以停止和删除指定的设备。
EVT_WDF_DEVICE_QUERY_STOP 驱动程序的 EvtDeviceQueryStop 事件回调函数确定是否可以停止指定的设备，以便 PnP 管理器可以重新分发系统硬件资源。
EVT_WDF_DEVICE_RELATIONS_QUERY 驱动程序的 EvtDeviceRelationsQuery 事件回调报告驱动程序支持的设备之间的关系更改。
EVT_WDF_DEVICE_RELEASE_HARDWARE 驱动程序的 EvtDeviceReleaseHardware 事件回调函数执行设备不再可访问时所需的操作。
EVT_WDF_DEVICE_SELF_MANAGED_IO_CLEANUP 驱动程序的 EvtDeviceSelfManagedIoCleanup 事件回调函数在删除设备后处理设备的自托管 I/O 操作的解除分配活动。
EVT_WDF_DEVICE_SELF_MANAGED_IO_FLUSH 驱动程序的 EvtDeviceSelfManagedIoFlush 事件回调函数处理设备的自我管理 I/O 操作的刷新活动。
EVT_WDF_DEVICE_SELF_MANAGED_IO_INIT 驱动程序的 EvtDeviceSelfManagedIoInit 事件回调函数初始化并启动设备的自我管理 I/O 操作。
EVT_WDF_DEVICE_SELF_MANAGED_IO_RESTART 驱动程序的 EvtDeviceSelfManagedIoRestart 事件回调函数重启设备的自我管理 I/O 操作。
EVT_WDF_DEVICE_SELF_MANAGED_IO_SUSPEND 驱动程序的 EvtDeviceSelfManagedIoSuspend 事件回调函数暂停设备的自我管理 I/O 操作。
EVT_WDF_DEVICE_SURPRISE_REMOVAL 驱动程序的 EvtDeviceSurpriseRemoval 事件回调函数执行从系统意外删除设备后或驱动程序报告设备故障后所需的任何操作。
EVT_WDF_DEVICE_USAGE_NOTIFICATION 驱动程序的 EvtDeviceUsageNotification 事件回调函数在设备用于特殊文件时通知驱动程序。
EVT_WDF_DEVICE_USAGE_NOTIFICATION_EX 驱动程序的 EvtDeviceUsageNotificationEx 事件回调函数确定设备是否可以支持特殊文件类型。
EVT_WDF_DEVICE_WAKE_FROM_S0_TRIGGERED 驱动程序的 EvtDeviceWakeFromS0Triggered 事件回调函数通知驱动程序，其设备之前在系统电源状态保持为 S0 时进入低功耗设备状态，可能已触发唤醒信号。
EVT_WDF_DEVICE_WAKE_FROM_SX_TRIGGERED 驱动程序的 EvtDeviceWakeFromSxTriggered 事件回调函数通知驱动程序，其设备可能触发了唤醒信号，该设备之前由于系统功率降低而进入低功率设备状态。
EVT_WDF_FILE_CLEANUP 驱动程序的 EvtFileCleanup 回调函数处理在应用程序关闭对设备的所有访问时必须执行的操作。
EVT_WDF_FILE_CLOSE 驱动程序的 EvtFileClose 回调函数处理在关闭应用程序对设备的所有访问时必须执行的操作。
EVT_WDF_IO_IN_CALLER_CONTEXT 驱动程序的 EvtIoInCallerContext 事件回调函数在框架将 I/O 请求放入 I/O 队列之前对其进行预处理。
EVT_WDFDEVICE_WDM_IRP_DISPATCH 驱动程序的 EvtDeviceWdmIrpDispatch 事件回调函数在框架处理 IRP 之前接收 IRP。
EVT_WDFDEVICE_WDM_IRP_PREPROCESS 驱动程序的 EvtDeviceWdmIrpPreprocess 事件回调函数在框架处理 IRP 之前接收 IRP。
EVT_WDFDEVICE_WDM_POST_PO_FX_REGISTER_DEVICE EvtDeviceWdmPostPoFxRegisterDevice 回调函数在向 Power Framework 注册框架后执行特定于设备的操作。
EVT_WDFDEVICE_WDM_PRE_PO_FX_UNREGISTER_DEVICE EvtDeviceWdmPrePoFxUnregisterDevice 回调函数执行特定于设备的操作，然后框架删除 Power Framework 的指定注册。

结构


WDF_DEVICE_INTERFACE_PROPERTY_DATA WDF_DEVICE_INTERFACE_PROPERTY_DATA结构描述设备接口属性。
WDF_DEVICE_PNP_CAPABILITIES WDF_DEVICE_PNP_CAPABILITIES结构描述了设备的即插即用功能。
WDF_DEVICE_PNP_NOTIFICATION_DATA WDF_DEVICE_PNP_NOTIFICATION_DATA结构描述设备的即插即用状态机中的状态更改。
WDF_DEVICE_POWER_CAPABILITIES WDF_DEVICE_POWER_CAPABILITIES结构描述了设备的电源功能。
WDF_DEVICE_POWER_NOTIFICATION_DATA WDF_DEVICE_POWER_NOTIFICATION_DATA结构描述设备电源状态机中的状态更改。
WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS 结构包含驱动程序提供的信息，当设备处于空闲状态且系统处于系统工作状态时，框架将使用这些信息 (S0) 。
WDF_DEVICE_POWER_POLICY_NOTIFICATION_DATA WDF_DEVICE_POWER_POLICY_NOTIFICATION_DATA结构描述设备的电源策略状态机中的状态更改。
WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS结构包含驱动程序提供的信息，说明设备在两者都处于低功耗状态时唤醒自身和系统的能力。
WDF_DEVICE_PROPERTY_DATA WDF_DEVICE_PROPERTY_DATA 结构描述设备属性。
WDF_DEVICE_STATE WDF_DEVICE_STATE结构指定设备的即插即用状态。
WDF_FILEOBJECT_CONFIG WDF_FILEOBJECT_CONFIG 结构包含驱动程序的框架文件对象的配置信息。
WDF_IO_TYPE_CONFIG WDF_IO_TYPE_CONFIG 结构为读取和写入请求以及设备 I/O 控制请求指定驱动程序的首选缓冲区访问方法。
WDF_PNPPOWER_EVENT_CALLBACKS WDF_PNPPOWER_EVENT_CALLBACKS 结构包含指向驱动程序的即插即用和电源事件回调函数的指针。
WDF_POWER_FRAMEWORK_SETTINGS WDF_POWER_FRAMEWORK_SETTINGS结构介绍单组件设备的电源管理框架 (PoFx) 设置。
WDF_POWER_POLICY_EVENT_CALLBACKS WDF_POWER_POLICY_EVENT_CALLBACKS 结构包含指向驱动程序的电源策略事件回调函数的指针。
WDF_REMOVE_LOCK_OPTIONS WDF_REMOVE_LOCK_OPTIONS 结构指定用于在将 IRP 传送给驱动程序之前获取删除锁的选项。

枚举


WDF_DEVICE_FAILED_ACTION WDF_DEVICE_FAILED_ACTION枚举标识当驱动程序报告不可恢复的软件或硬件故障时框架将执行的操作。
WDF_DEVICE_HWACCESS_TARGET_SIZE 此枚举由框架在内部使用。请勿使用。此枚举在 wdfdevice.h 中定义。
WDF_DEVICE_HWACCESS_TARGET_TYPE 了解框架如何在内部使用 WDF_DEVICE_HWACCESS_TARGET_SIZE 枚举。请勿使用。此枚举在 wdfdevice.h 中定义。
WDF_DEVICE_IO_TYPE WDF_DEVICE_IO_TYPE 枚举用于指定访问数据缓冲区的方法。
WDF_DEVICE_PNP_STATE WDF_DEVICE_PNP_STATE枚举标识框架的即插即用状态机可以进入的所有状态。
WDF_DEVICE_POWER_POLICY_STATE WDF_DEVICE_POWER_POLICY_STATE枚举标识框架的电源策略状态机可以进入的所有状态。
WDF_DEVICE_POWER_STATE WDF_DEVICE_POWER_STATE枚举标识框架的电源状态机可以进入的所有状态。
WDF_DISPATCH_IRP_TO_IO_QUEUE_FLAGS WDF_DISPATCH_IRP_TO_IO_QUEUE_FLAGS 枚举类型定义驱动程序在调用 WdfDeviceWdmDispatchIrpToIoQueue 时可以指定的标志。
WDF_EVENT_TYPE WDF_EVENT_TYPE枚举指定。
WDF_FILEOBJECT_CLASS WDF_FILEOBJECT_CLASS 枚举定义一些值，用于标识驱动程序是否需要框架文件对象来表示应用程序或其他驱动程序尝试创建或打开的文件。
WDF_POWER_DEVICE_STATE WDF_POWER_DEVICE_STATE枚举标识设备可能支持的设备电源状态。
WDF_POWER_POLICY_IDLE_TIMEOUT_CONSTANTS WDF_POWER_POLICY_IDLE_TIMEOUT_CONSTANTS枚举保留供内部使用。
WDF_POWER_POLICY_IDLE_TIMEOUT_TYPE WDF_POWER_POLICY_IDLE_TIMEOUT_TYPE枚举标识如何确定设备的空闲超时。
WDF_POWER_POLICY_S0_IDLE_CAPABILITIES WDF_POWER_POLICY_S0_IDLE_CAPABILITIES枚举标识设备在闲闲时进入低功耗状态时可以支持的功能。
WDF_POWER_POLICY_S0_IDLE_USER_CONTROL WDF_POWER_POLICY_S0_IDLE_USER_CONTROL枚举标识当设备处于空闲状态且系统处于工作 (S0) 状态时，用户是否可以控制设备的行为。
WDF_POWER_POLICY_SX_WAKE_USER_CONTROL WDF_POWER_POLICY_SX_WAKE_USER_CONTROL枚举标识用户是否可以控制设备将系统从低系统电源状态唤醒的能力。
WDF_RELEASE_HARDWARE_ORDER_ON_FAILURE WDF_RELEASE_HARDWARE_ORDER_ON_FAILURE 枚举指定框架何时调用驱动程序的 EvtDeviceReleaseHardware 回调函数。
WDF_REMOVE_LOCK_OPTIONS_FLAGS WDF_REMOVE_LOCK_OPTIONS_FLAGS 枚举类型定义在驱动程序WDF_REMOVE_LOCK_OPTIONS结构中使用的标志。
WDF_SPECIAL_FILE_TYPE WDF_SPECIAL_FILE_TYPE枚举标识设备可以支持的特殊文件类型。
WDF_STATE_NOTIFICATION_TYPE WDF_STATE_NOTIFICATION_TYPE枚举标识基于框架的驱动程序将接收的即插即用、电源或电源策略通知的类型。

通过

wdfdevice.h 标头

常规框架设备对象事件回调函数

常规框架设备对象初始化方法

常规框架设备对象方法

常规框架设备对象结构和枚举

设备对象结构的初始化函数

函数

回调函数

结构

枚举

反馈

其他资源