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)
目標平台	Universal
最低UMDF版本	2.33
標頭	netdevice.h (包含 netadaptercx.h)
IRQL	PASSIVE_LEVEL