NET_POWER_OFFLOAD_LIST 구조체(netpoweroffloadlist.h)

아티클
02/29/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 개체를 사용하는 코드 샘플은 전원 관리 구성을 참조하세요.