NetPowerOffloadListGetElement 함수(netpoweroffloadlist.h)
NetPowerOffloadListGetElement 함수는 오프로드 목록에서 net 어댑터로 저전력 프로토콜 오프로드를 가져옵니다.
구문
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 |
대상 플랫폼 | 유니버설 |
최소 UMDF 버전 | 2.33 |
머리글 | netpoweroffloadlist.h(netadaptercx.h 포함) |
IRQL | PASSIVE_LEVEL |