NDIS_PM_PARAMETERS 구조체(ntddndis.h)

아티클
02/27/2024

NDIS_PM_PARAMETERS 구조는 네트워크 어댑터에 대해 사용하도록 설정된 현재 또는 새로운 전원 관리 하드웨어 기능을 지정합니다.

구문

typedef struct _NDIS_PM_PARAMETERS {
  NDIS_OBJECT_HEADER Header;
  ULONG              EnabledWoLPacketPatterns;
  ULONG              EnabledProtocolOffloads;
  ULONG              WakeUpFlags;
  ULONG              MediaSpecificWakeUpEvents;
} NDIS_PM_PARAMETERS, *PNDIS_PM_PARAMETERS;

멤버

Header

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

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

NDIS_PM_PARAMETERS_REVISION_2

NDIS 6.30에 대한 다양한 변경 내용이 추가되었습니다.

Size 멤버를 NDIS_SIZEOF_NDIS_PM_PARAMETERS_REVISION_2 설정합니다.

NDIS_PM_PARAMETERS_REVISION_1

NDIS 6.20의 원래 버전입니다.

Size 멤버를 NDIS_SIZEOF_NDIS_PM_PARAMETERS_REVISION_1 설정합니다.

EnabledWoLPacketPatterns

미니포트 드라이버가 NDIS_PM_CAPABILITIES 구조체의 SupportedWoLPacketPatterns 멤버에서 보고한 기능에 해당하는 플래그의 비트 OR을 포함하는 ULONG 값입니다. NDIS는 이러한 플래그를 사용하여 네트워크 어댑터가 로컬 컴퓨터를 저전력 상태에서 절전 모드 해제하는 데 사용하는 WOL(Wake-On-LAN) 패턴을 사용하도록 설정합니다. WOL 패턴에 대한 자세한 내용은 NDIS_PM_WOL_PATTERN 참조하세요.

다음 플래그가 사용됩니다.

NDIS_PM_WOL_BITMAP_PATTERN_ENABLED

이 플래그가 설정되면 네트워크 어댑터가 구성된 비트맵 패턴과 일치하는 패킷을 수신할 때 절전 모드 해제 이벤트를 생성할 수 있습니다.

NDIS_PM_WOL_MAGIC_PACKET_ENABLED

이 플래그가 설정되면 네트워크 어댑터가 WOL 매직 패킷을 받으면 절전 모드 해제 이벤트를 생성할 수 있습니다. 매직 패킷은 페이로드 내에 값이 0xFF 6바이트의 문자열을 포함하고 수신 네트워크 어댑터의 MAC(미디어 액세스 제어) 주소의 연속 복사본 16개를 즉시 포함합니다.

NDIS_PM_WOL_EAPOL_REQUEST_ID_MESSAGE_ENABLED

이 플래그를 설정하면 네트워크 어댑터가 EAPOL 요청 식별자 메시지를 받을 때 절전 모드 해제 이벤트를 생성할 수 있습니다.

NDIS_PM_WOL_IPV4_TCP_SYN_ENABLED

이 플래그가 설정되면 네트워크 어댑터가 IPv4 TCP SYN 패킷을 수신할 때 절전 모드 해제 이벤트를 생성할 수 있습니다. 원격 호스트는 TCP SYN 패킷을 보내 로컬 컴퓨터에 대한 TCP 연결을 시작합니다.

NDIS_PM_WOL_IPV6_TCP_SYN_ENABLED

이 플래그가 설정되면 네트워크 어댑터가 IPv6 TCP SYN 패킷을 수신할 때 절전 모드 해제 이벤트를 생성할 수 있습니다.

NDIS_PM_WOL_IPV4_DEST_ADDR_WILDCARD_ENABLED

이 플래그가 설정된 경우 네트워크 어댑터는 IPv4 주소 및 TCP/UDP 포트에 대해 0으로 채워지거나 지정되지 않은 값을 WOL 패턴으로 와일드카드 값으로 처리해야 합니다. 이러한 방식으로 와일드카드 값은 모든 IPv4 주소와 WOL 패턴으로 지정된 위치에 있는 들어오는 패킷의 포트 값과 일치합니다.

이 플래그를 설정하면 다음 패턴 일치 조건이 true인 경우 네트워크 어댑터가 절전 모드 해제 이벤트를 생성할 수 있습니다.

해당 위치의 WOL 패턴에 와일드카드 값이 포함된 경우 WOL 패턴으로 지정된 위치에 있는 들어오는 패킷의 모든 값이 일치합니다.
해당 위치의 WOL 패턴에 패킷 값과 같은 0이 아닌 값이 포함된 경우 WOL 패턴으로 지정된 위치에 있는 들어오는 패킷의 값이 일치합니다.

참고

이 플래그에서 사용하도록 설정된 와일드카드 값에는 지정되지 않은 IPv4 원본 및 대상 주소와 지정되지 않은 원본 및 대상 포트가 포함될 수 있습니다.

NDIS_PM_WOL_IPV6_DEST_ADDR_WILDCARD_ENABLED

이 플래그가 설정된 경우 네트워크 어댑터는 IPv6 주소 및 TCP/UDP 포트에 대해 0으로 채워지거나 지정되지 않은 값을 WOL 패턴으로 와일드카드 값으로 처리해야 합니다. 이러한 방식으로 와일드카드 값은 WOL 패턴으로 지정된 위치에 있는 들어오는 패킷의 모든 IPv6 주소 및 포트 값과 일치합니다.

이 플래그를 설정하면 다음 패턴 일치 조건이 true인 경우 네트워크 어댑터가 절전 모드 해제 이벤트를 생성할 수 있습니다.

해당 위치의 WOL 패턴에 와일드카드 값이 포함된 경우 WOL 패턴으로 지정된 위치에 있는 들어오는 패킷의 모든 값이 일치합니다.
해당 위치의 WOL 패턴에 패킷 값과 같은 0이 아닌 값이 포함된 경우 WOL 패턴으로 지정된 위치에 있는 들어오는 패킷의 값이 일치합니다.

참고

이 플래그에서 사용하도록 설정된 와일드카드 값에는 지정되지 않은 IPv6 원본 및 대상 주소와 지정되지 않은 원본 및 대상 포트가 포함될 수 있습니다.

EnabledProtocolOffloads

미니포트 드라이버가 NDIS_PM_CAPABILITIES 구조체의 SupportedProtocolOffloads 멤버에서 보고한 기능에 해당하는 플래그의 비트 OR을 포함하는 ULONG 값입니다. NDIS는 이러한 플래그를 사용하여 네트워크 어댑터에서 저전력 프로토콜 오프로드 기능을 사용하도록 설정합니다. 다음 플래그가 사용됩니다.

NDIS_PM_PROTOCOL_OFFLOAD_ARP_ENABLED

이 비트가 설정된 경우 오버리싱 드라이버는 네트워크 어댑터에 ARP 프로토콜 오프로드 기능을 사용하도록 요청합니다. 이 프로토콜 오프로드가 OID_PM_ADD_PROTOCOL_OFFLOAD 설정된 요청에 의해 구성되는 즉시 드라이버는 네트워크 어댑터가 저전력 상태인 동안 IPv4 ARP 패킷에 응답할 수 있도록 설정해야 합니다.

NDIS_PM_PROTOCOL_OFFLOAD_NS_ENABLED

이 비트가 설정된 경우 오버리딩 드라이버는 네트워크 어댑터에 IPv6 NS(Neighbor Solicitation) 프로토콜 오프로드 기능을 사용하도록 요청합니다. 이 프로토콜 오프로드가 OID_PM_ADD_PROTOCOL_OFFLOAD 설정된 요청에 의해 구성되는 즉시 드라이버는 네트워크 어댑터가 저전력 상태인 동안 NS 패킷에 응답할 수 있도록 설정해야 합니다.

NDIS_PM_PROTOCOL_OFFLOAD_80211_RSN_REKEY_ENABLED

이 비트가 설정된 경우 오버레이 드라이버는 네트워크 어댑터에 IEEE 802.11i RSN(강력한 보안 네트워크) 프로토콜 오프로드 기능을 사용하도록 요청합니다. 이 프로토콜 오프로드가 OID_PM_ADD_PROTOCOL_OFFLOAD 설정된 요청에 의해 구성되는 즉시 드라이버는 네트워크 어댑터가 전원이 부족한 상태에서 RSN 다시 키 요청 패킷에 응답할 수 있도록 해야 합니다.

WakeUpFlags

NDIS_PM_WAKE_ON_ Xxx 플래그의 비트 OR을 포함하는 ULONG 값입니다. NDIS는 이러한 플래그를 사용하여 네트워크 어댑터에서 절전 모드 해제 기능을 사용하도록 설정합니다. 이 멤버는 다음 플래그를 사용합니다.

NDIS_PM_WAKE_ON_LINK_CHANGE_ENABLED

이 플래그를 설정하면 연결 상태가 미디어 연결이 끊긴 미디어에서 연결된 미디어로 변경될 때 네트워크 어댑터가 절전 모드 해제 이벤트를 생성할 수 있습니다.

이 WOL 기능에 대한 자세한 내용은 미디어 연결 끊기에서 저전력을 참조하세요.

NDIS_PM_WAKE_ON_MEDIA_DISCONNECT_ENABLED

이 플래그를 설정하면 연결 상태가 미디어 연결이 끊긴 미디어에서 연결이 끊어지면 네트워크 어댑터가 절전 모드 해제 이벤트를 생성할 수 있습니다.

NDIS_PM_SELECTIVE_SUSPEND_ENABLED

이 플래그가 설정된 경우 네트워크 어댑터는 다음 이벤트 중 하나가 발생할 때마다 절전 모드 해제 이벤트를 생성할 수 있습니다.

네트워크 어댑터는 수신 패킷 필터와 일치하는 패킷을 받습니다. 어댑터는 OID_GEN_CURRENT_PACKET_FILTER OID 집합 요청을 통해 이러한 필터로 구성됩니다.
네트워크 어댑터는 연결 상태가 미디어 연결 끊기 또는 미디어 연결 끊김으로 변경되는 경우와 같이 네트워킹 드라이버 스택에서 처리해야 하는 다른 외부 이벤트를 검색합니다.

참고

NDIS_PM_SELECTIVE_SUSPEND_ENABLED 플래그는 NDIS 6.30 이상에서 사용할 수 있습니다.

이 플래그를 설정하면 WakeUpFlags 멤버에서 다른 전원 관리 플래그를 설정할 수 없으며 EnabledWoLPacketPatterns 멤버를 0으로 설정해야 합니다.

NDIS가 NDIS_PM_SELECTIVE_SUSPEND_ENABLED 플래그를 설정하는 경우 OID_PM_PARAMETERS OID 집합 요청을 미니포트 드라이버에 직접 발급합니다. 이를 통해 NDIS는 네트워킹 드라이버 스택의 필터 드라이버에 의한 처리를 바이패스할 수 있습니다.

선택적 일시 중단 전원 관리 기능에 대한 자세한 내용은 NDIS 선택적 일시 중단을 참조하세요.

MediaSpecificWakeUpEvents

플래그의 비트 OR을 포함하는 ULONG 값입니다. 이러한 플래그는 네트워크 어댑터가 지원하는 미디어별 절식 이벤트를 지정합니다.

NDIS 6.30부터 다음 플래그가 정의됩니다.

NDIS_WLAN_WAKE_ON_NLO_DISCOVERY_ENABLED

이 플래그가 설정되면 NLO(네트워크 오프로드)를 통해 지정된 SSID(서비스 집합 식별자)를 검색하면 802.11 네트워크 어댑터가 절전 모드 해제 이벤트를 생성할 수 있습니다.

NLO에 대한 자세한 내용은 Wi-Fi 네트워크 목록 오프로드를 참조하세요.

NDIS_WLAN_WAKE_ON_AP_ASSOCIATION_LOST_ENABLED

이 플래그가 설정되면 802.11 네트워크 어댑터가 AP(액세스 지점)와 연결 해제될 때 절전 모드 해제 이벤트를 생성할 수 있습니다.

NDIS_WLAN_WAKE_ON_GTK_HANDSHAKE_ERROR_ENABLED

이 플래그를 설정하면 IEEE 802.11i RSN GTK(그룹 일시적 키) 핸드셰이크 중에 오류가 발생하면 802.11 네트워크 어댑터가 절전 모드 해제 이벤트를 생성할 수 있습니다.

NDIS_WLAN_WAKE_ON_4WAY_HANDSHAKE_REQUEST_ENABLED

이 플래그를 설정하면 IEEE 802.11i RSN 4방향 핸드셰이크를 AP와 함께 받을 때 802.11 네트워크 어댑터가 절전 모드 해제 이벤트를 생성할 수 있습니다. 이 핸드셰이크는 어댑터가 AP를 사용하여 인증할 때 수행됩니다.

NDIS_WWAN_WAKE_ON_REGISTER_STATE_ENABLED

이 플래그를 설정하면 MB 서비스에 대한 등록 상태가 변경되면 MB(모바일 광대역) 네트워크 어댑터가 절전 모드 해제 이벤트를 생성할 수 있습니다.

NDIS_WWAN_WAKE_ON_SMS_RECEIVE_ENABLED

이 플래그를 설정하면 MB 서비스에 SMS(짧은 메시지 서비스) 메시지 수신에 대한 알림을 수신해야 하는 경우 MB 네트워크 어댑터가 절전 모드 해제 이벤트를 생성할 수 있습니다. 어댑터는 이전에 발급된 OID_WWAN_SMS_READ 쿼리 요청이 완료된 후 또는 이벤트 알림으로 네트워크 공급자로부터 새 클래스 0(플래시/경고) 메시지가 도착한 후 이 절전 모드 해제 이벤트를 생성합니다.

NDIS_WWAN_WAKE_ON_USSD_RECEIVE_ENABLED

이 플래그를 설정하면 MB 네트워크 어댑터가 USSD(비정형 보조 서비스 데이터) 메시지를 받을 때 절전 모드 해제 이벤트를 생성할 수 있습니다.

NDIS_WWAN_WAKE_ON_PACKET_STATE_ENABLED

이 플래그를 설정하면 셀룰러 패킷 데이터의 가용성이 변경될 때 MB 네트워크 어댑터가 절전 모드 해제 이벤트를 생성할 수 있습니다. 이 플래그는 Windows 10 새로운 기능입니다.

NDIS_WWAN_WAKE_ON_UICC_CHANGE_ENABLED

이 플래그가 설정된 경우 MB 네트워크 어댑터는 UICC(SIM) 카드 삽입, 제거 또는 오류 상태가 될 때 절전 모드 해제 이벤트를 생성할 수 있습니다. 이 플래그는 Windows 10 새로운 기능입니다.

설명

NDIS_PM_PARAMETERS 구조는 OID_PM_PARAMETERS OID에 대해 사용하도록 설정된 전원 관리 하드웨어 기능을 지정합니다. OID_PM_PARAMETERS OID가 쿼리되면 이 구조는 현재 전원 관리 구성을 제공합니다. OID_PM_PARAMETERS OID가 설정되면 이 구조는 네트워크 어댑터에서 사용해야 하는 새 전원 관리 구성을 지정합니다.

지나치게 많은 드라이버는 네트워크 어댑터가 지원하지 않는 기능을 사용하도록 설정하려고 하면 안 됩니다. 지나치게 많은 드라이버가 네트워크 어댑터가 제공하는 기능을 확인할 수 있도록 NDIS는 NDIS_BIND_PARAMETERS 구조의 PowerManagementCapabilitiesEx 멤버에 기능을 제공합니다.

참고

NDIS 6.20 이상 드라이버는 PowerManagementCapabilities 멤버 대신 NDIS_BIND_PARAMETERS 구조체의 PowerManagementCapabilitiesEx 멤버를 사용해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	NDIS 6.20 이상에서 지원됩니다.
머리글	ntddndis.h(Ntddndis.h 포함)

추가 정보

OID_GEN_CURRENT_PACKET_FILTER

OID_PM_PARAMETERS

Share via