Share via

NetPowerOffloadListGetElement 함수(netpoweroffloadlist.h)

  • 아티클

NetPowerOffloadListGetElement 함수는 오프로드 목록에서 넷 어댑터로의 저전력 프로토콜 오프로드를 가져옵니다.

구문

NETPOWEROFFLOAD NetPowerOffloadListGetElement(
  [_In_] const NET_POWER_OFFLOAD_LIST *List,
  [_In_] SIZE_T                       Index
);

매개 변수

[_In_] List

드라이버 할당 및 초기화된 NET_POWER_OFFLOAD_LIST 구조체에 대한 포인터입니다.

[_In_] Index

대상 NETPOWEROFFLOAD 개체에 대한 목록의 인덱스(0부터 시작)입니다. 이 함수는 NetPowerOffloadListGetCount에서 반환하는 값보다 작아야 합니다.

반환 값

목록의 지정된 인덱스에서 저전력 프로토콜 오프로드를 나타내는 NETPOWEROFFLOAD 개체를 반환합니다.

설명

이 함수를 호출하기 전에 NetPowerOffloadListGetCount 를 호출하여 저전력 프로토콜 오프로드 수를 가져옵니다.

클라이언트 드라이버는 일반적으로 EVT_WDF_DEVICE_ARM_WAKE_FROM_SX, EVT_WDF_DEVICE_ARM_WAKE_FROM_S0 또는EVT_NET_DEVICE_PREVIEW_POWER_OFFLOAD 콜백 함수에서 전원 전환 중에 NetPowerOffloadListGetElement만 호출해야 합니다. 그렇지 않으면 호출로 인해 시스템 버그 검사가 발생합니다.

NETPOWEROFFLOAD 개체를 사용하는 코드 샘플은 전원 관리 구성을 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 10, 버전 2004
대상 플랫폼 유니버설
헤더 netpoweroffloadlist.h(netadaptercx.h 포함)
IRQL PASSIVE_LEVEL

추가 정보

전원 관리 구성

NET_POWER_OFFLOAD_LIST

NetPowerOffloadListGetCount