NetWakeSourceListGetElement 関数 (netwakesourcelist.h)

NetWakeSourceListGetElement 関数は、net アダプターのウェイク ソースの一覧からウェイク ソースを取得します。

構文

NETWAKESOURCE NetWakeSourceListGetElement(
  [_In_] const NET_WAKE_SOURCE_LIST *List,
  [_In_] SIZE_T                     Index
);

パラメーター

[_In_] List

ドライバーによって割り当てられ、初期化された NET_WAKE_SOURCE_LIST 構造体へのハンドル。

[_In_] Index

ターゲット NETWAKESOURCE オブジェクトのリスト内の 0 から始まるインデックス。 この関数は、NetWakeSourceListGetCountによって返される値より小さくする必要があります。

戻り値

リスト内の指定したインデックス位置にあるウェイク ソースを表す NETWAKESOURCE オブジェクトを返します。

備考

NetWakeSourceListGetCount呼び出して、この関数を呼び出す前にウェイク ソースの数を取得します。

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

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

必要条件

要件	価値
サポートされる最小クライアント	Windows 10 バージョン 2004
ターゲット プラットフォーム の	万国
UMDF の最小バージョン を する	2.33
ヘッダー	netwakesourcelist.h (netadaptercx.h を含む)
ライブラリ	netadaptercxstub.lib
IRQL	PASSIVE_LEVEL

関連項目

電源管理 の構成

NET_WAKE_SOURCE_LIST

NetWakeSourceListGetCount