NET_WAKE_SOURCE_LIST 구조체(netwakesourcelist.h)

아티클
08/07/2023

NET_WAKE_SOURCE_LIST 구조체는 Net 어댑터에 대한 WoL(Wake-on-LAN) 원본 목록을 나타냅니다.

구문

typedef struct _NET_WAKE_SOURCE_LIST {
  ULONG Size;
  void  *Reserved[4];
} NET_WAKE_SOURCE_LIST;

멤버

Size

이 구조체의 크기(바이트)입니다.

Reserved[4]

예약되어 있습니다. 클라이언트 드라이버는 이 값을 직접 읽거나 쓸 수 없습니다.

설명

NET_WAKE_SOURCE_LIST_INIT 호출하여 이 구조를 초기화한 다음 NetDeviceGetWakeSourceList를 호출하여 이 net 어댑터에서 절전 모드 해제 원본 목록을 가져옵니다. 목록을 가져온 후 이 구조로 NetWakeSourceListGetCount 를 호출하여 절전 모드 해제 원본을 나타내는 NETWAKESOURCE 개체 수를 가져온 다음, 개체를 반복하고 NetWakeSourceListGetElement 를 호출하여 각 개체를 검색합니다. NETWAKESOURCE 개체를 가져온 후에는 NetWakeSourceGetType 을 호출하여 해당 절전 모드 해제 원본의 형식을 가져오므로 적절한 함수를 호출하여 절전 모드 해제 원본의 매개 변수를 가져올 수 있습니다.

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

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