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