EVT_NET_DEVICE_PREVIEW_WAKE_SOURCE 回调函数 (netdevice.h)

实现此可选回调以拒绝与硬件不兼容的唤醒模式。

语法

EVT_NET_DEVICE_PREVIEW_WAKE_SOURCE EvtNetDevicePreviewWakeSource;

NTSTATUS EvtNetDevicePreviewWakeSource(
  [_In_] WDFDEVICE Device,
  [_In_] NETWAKESOURCE WakeSource
)
{...}

参数

[_In_] Device

客户端驱动程序先前通过调用 WdfDeviceCreate 获取的 WDFDEVICE 对象。

[_In_] WakeSource

表示要检查的唤醒源的 NETWAKESOURCE 对象。

返回值

若要接受该模式，回调函数必须返回STATUS_SUCCESS。

若要拒绝模式，请返回STATUS_NDIS_PM_WOL_PATTERN_LIST_FULL。

注解

实现 EvtNetDevicePreviewWakeSource 不需要驱动程序，因为 NetAdapterCx 已阻止与驱动程序 NET_ADAPTER_WAKE_BITMAP_CAPABILITIES不兼容的唤醒源。 但是，如果硬件具有无法在位图功能结构中表示的其他限制，则可以提供 EvtNetDevicePreviewWakeSource 来强制实施这些附加限制。

通过设置 NET_DEVICE_POWER_POLICY_EVENT_CALLBACKS的相应成员，然后调用 NetDeviceInitSetPowerPolicyEventCallbacks 来注册此回调函数的实现。

客户端驱动程序通常在创建设备对象时调用 NetDeviceInitSetPowerPolicyEventCallbacks ，然后再调用 WdfDeviceCreate。

在此回调中，客户端驱动程序有机会拒绝唤醒源。 例如，如果 设备 当前唤醒源列表中的电源筛选器数量已达到或超过硬件支持的电源筛选器数，驱动程序可以拒绝此唤醒源。

有关详细信息，请参阅 配置电源管理。

要求

要求	值
最低受支持的客户端	Windows 10 版本 2004
目标平台	通用
最低 UMDF 版本	2.33
标头	netdevice.h (包括 netadaptercx.h)
IRQL	PASSIVE_LEVEL