NET_POWER_OFFLOAD_LIST 構造体 (netpoweroffloadlist.h)

[アーティクル]
02/26/2024

NET_POWER_OFFLOAD_LIST構造体は、ネットアダプターへの低電力プロトコルオフロードの一覧を表します。

構文

typedef struct _NET_POWER_OFFLOAD_LIST {
  ULONG Size;
  void  *Reserved[4];
} NET_POWER_OFFLOAD_LIST;

メンバー

Size

この構造体のサイズ (バイト単位)。

Reserved[4]

予約済み。クライアントドライバーは、この値を直接読み取ったり書き込んだりすることはできません。

注釈

NET_POWER_OFFLOAD_LIST_INITを呼び出してこの構造体を初期化し、NetDeviceGetPowerOffloadList を呼び出して、この net アダプターへの低電力オフロードの一覧を取得します。リストを取得した後、この構造体を使用して NetPowerOffloadListGetCount を呼び出してオフロードを表す NETPOWEROFFLOAD オブジェクトの数を取得し、オブジェクトをループ処理して NetPowerOffloadListGetElement を呼び出して、それぞれを取得します。 NETPOWEROFFLOAD オブジェクトを取得したら、 NetPowerOffloadGetType を呼び出してオフロードの型を取得し、適切な関数を呼び出してオフロードのパラメーターを取得できるようにします。

クライアントドライバーは、通常、そのEVT_WDF_DEVICE_ARM_WAKE_FROM_SX、EVT_WDF_DEVICE_ARM_WAKE_FROM_S0、またはEVT_NET_DEVICE_PREVIEW_POWER_OFFLOADコールバック関数から、電源移行中にのみ電源オフロード関連の関数を呼び出す必要があります。それ以外の場合、呼び出しによってシステムバグチェックが行われます。

NETPOWEROFFLOAD オブジェクトの操作のコードサンプルについては、「電源管理の構成」を参照してください。