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
Header	netdevice.h (netadaptercx.h を含む)
IRQL	PASSIVE_LEVEL