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

注釈

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

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

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

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

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

要件

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