NDIS_PM_WAKE_PACKET 구조체(ntddndis.h)

아티클
08/07/2023

NDIS_PM_WAKE_PACKET 구조는 네트워크 어댑터가 절전 모드 해제 이벤트를 생성하게 한 네트워크 패킷(절전 모드 해제 패킷이라고 함)을 설명합니다.

구문

typedef struct _NDIS_PM_WAKE_PACKET {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  Flags;
  ULONG                  PatternId;
  NDIS_PM_COUNTED_STRING PatternFriendlyName;
  ULONG                  OriginalPacketSize;
  ULONG                  SavedPacketSize;
  ULONG                  SavedPacketOffset;
} NDIS_PM_WAKE_PACKET, *PNDIS_PM_WAKE_PACKET;

멤버

Header

NDIS_PM_WAKE_PACKET 구조체의 형식, 수정 버전 및 크기입니다. 이 멤버는 NDIS_OBJECT_HEADER 구조체로 형식이 지정됩니다.

미니포트 드라이버는 헤더의 Type 멤버를 NDIS_OBJECT_TYPE_DEFAULT 설정해야 합니다. NDIS_PM_WAKE_PACKET 구조체의 버전을 지정하려면 드라이버가 Header의 Revision 멤버를 다음 값으로 설정해야 합니다.

NDIS_SIZEOF_PM_WAKE_PACKET_REVISION_1

NDIS 6.30 이상에 대한 원래 버전입니다.

Size 멤버를 NDIS_SIZEOF_PM_WAKE_PACKET_REVISION_1 설정합니다.

Flags

플래그의 비트 OR을 포함하는 ULONG 값입니다. 이 멤버는 NDIS용으로 예약되어 있습니다.

PatternId

절전 모드 해제 패킷과 일치하는 WOL(Wake-On-LAN) 패턴의 식별자를 지정하는 ULONG 값입니다. 이 식별자는 OID_PM_ADD_WOL_PATTERN OID 집합 요청 중에 드라이버에 전달되는 NDIS_PM_WOL_PATTERN 구조체의 PatternId 멤버에 의해 지정됩니다.

PatternFriendlyName

PatternId 멤버가 지정한 절식 패턴에 대한 친숙한 설명을 포함하는 NDIS_PM_COUNTED_STRING 값입니다. 이 값은 OID_PM_ADD_WOL_PATTERN OID 요청 중에 드라이버에 전달되는 NDIS_PM_WOL_PATTERN 구조체의FriendlyName 멤버에 의해 지정됩니다.

참고 미니포트 드라이버는 이 멤버를 초기화할 필요가 없습니다. NDIS는 NDIS_PM_WAKE_PACKET 구조를 오버리딩 드라이버에 전달하기 전에 PatternFriendlyName 멤버를 올바른 값으로 설정합니다.

OriginalPacketSize

절전 모드 해제 패킷의 원래 길이(바이트 단위)를 지정하는 ULONG 값입니다.

SavedPacketSize

이 구조를 따르는 절전 모드 해제 패킷 데이터의 길이(바이트 단위)를 지정하는 ULONG 값입니다.

참고 이 멤버의 값은 바이트 이상 min(wake packet size, 128) 이어야 합니다.

SavedPacketOffset

이 구조 다음에 오는 절전 모드 해제 패킷 데이터에 대한 오프셋(바이트 단위)을 지정하는 ULONG 값입니다. 오프셋은 NDIS_PM_WAKE_PACKET 구조체의 시작부터 절삭 패킷을 포함하는 버퍼의 시작까지 측정됩니다.

참고 저장된 절식 패킷에 대한 오프셋은 64비트 경계에 맞춰야 합니다.