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 を呼び出します。

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

詳細については、「 Power Management の構成」を参照してください。

要件

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