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返します。

備考

NetAdapterCx は既にドライバーの NET_ADAPTER_WAKE_BITMAP_CAPABILITIESと互換性のないウェイク ソースをブロックするため、ドライバーは EvtNetDevicePreviewWakeSource 実装する必要はありません。 ただし、ハードウェアにビットマップ機能構造で表現できない追加の制限がある場合は、EvtNetDevicePreviewWakeSource を指定して、これらの追加の制限を適用できます。

このコールバック関数の実装を登録するには、NET_DEVICE_POWER_POLICY_EVENT_CALLBACKSの適切なメンバーを設定し、NetDeviceInitSetPowerPolicyEventCallbacksを呼び出します。

クライアント ドライバーは、通常、WdfDeviceCreate呼び出す前に、デバイス オブジェクトを作成するときに NetDeviceInitSetPowerPolicyEventCallbacks 呼び出します。

このコールバックでは、クライアント ドライバーは、ウェイク ソースを拒否する機会を取得します。 たとえば、デバイス の現在のウェイク ソース 一覧の電源フィルターの数が、ハードウェアでサポートされている電源フィルターの数に既に達しているか、それを超えている場合、ドライバーはこのウェイク ソースを拒否できます。

詳細については、「電源管理の構成」を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Windows 10 バージョン 2004
ターゲット プラットフォーム の	万国
UMDF の最小バージョン を する	2.33
ヘッダー	netdevice.h (netadaptercx.h を含む)
IRQL	PASSIVE_LEVEL