EVT_NET_DEVICE_PREVIEW_POWER_OFFLOADコールバック関数 (netdevice.h)

ハードウェアと互換性のないプロトコル オフロードを拒否するには、この省略可能なコールバックを実装します。

構文

EVT_NET_DEVICE_PREVIEW_POWER_OFFLOAD EvtNetDevicePreviewPowerOffload;

NTSTATUS EvtNetDevicePreviewPowerOffload(
  [_In_] WDFDEVICE Device,
  [_In_] NETPOWEROFFLOAD PowerOffload
)
{...}

パラメーター

[_In_] Device

WdfDeviceCreateの呼び出しでクライアント ドライバーが以前に取得した WDFDEVICE オブジェクト。

[_In_] PowerOffload

調べる低電力プロトコル オフロードを表す NETPOWEROFFLOAD オブジェクト。

戻り値

プロトコル オフロードを受け入れるには、コールバック関数はSTATUS_SUCCESSを返す必要があります。

プロトコル オフロードを拒否するには、STATUS_NDIS_PM_PROTOCOL_OFFLOAD_LIST_FULL返します。

備考

NetAdapterCx は既にドライバーのパワー オフロード機能 (NET_ADAPTER_POWER_OFFLOAD_ARP_CAPABILITIES と NET_ADAPTER_POWER_OFFLOAD_NS_CAPABILITIES) と互換性のないプロトコル オフロードをブロックするため、ドライバーは EvtNetDevicePreviewPowerOffloadを実装する必要はありません。 ただし、ハードウェアにこれらの機能構造で表現できない追加の制限がある場合は、EvtNetDevicePreviewPowerOffload 指定して、これらの追加の制限を適用できます。

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

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

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

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

必要条件

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