NDIS_PM_CAPABILITIES 구조체(ntddndis.h)
NDIS_PM_CAPABILITIES 구조는 네트워크 어댑터의 전원 관리 기능을 지정합니다.
구문
typedef struct _NDIS_PM_CAPABILITIES {
NDIS_OBJECT_HEADER Header;
ULONG Flags;
ULONG SupportedWoLPacketPatterns;
ULONG NumTotalWoLPatterns;
ULONG MaxWoLPatternSize;
ULONG MaxWoLPatternOffset;
ULONG MaxWoLPacketSaveBuffer;
ULONG SupportedProtocolOffloads;
ULONG NumArpOffloadIPv4Addresses;
ULONG NumNSOffloadIPv6Addresses;
NDIS_DEVICE_POWER_STATE MinMagicPacketWakeUp;
NDIS_DEVICE_POWER_STATE MinPatternWakeUp;
NDIS_DEVICE_POWER_STATE MinLinkChangeWakeUp;
ULONG SupportedWakeUpEvents;
ULONG MediaSpecificWakeUpEvents;
} NDIS_PM_CAPABILITIES, *PNDIS_PM_CAPABILITIES;
멤버
Header
NDIS_PM_CAPABILITIES 구조체의 형식, 수정 버전 및 크기입니다. 이 멤버는 NDIS_OBJECT_HEADER 구조체로 형식이 지정됩니다.
미니포트 드라이버는 헤더의 Type 멤버를 NDIS_OBJECT_TYPE_DEFAULT 설정해야 합니다. NDIS_PM_CAPABILITIES 구조체의 버전을 지정하려면 드라이버가 Header의 Revision 멤버를 다음 값으로 설정해야 합니다.
NDIS_PM_CAPABILITIES_REVISION_2
NDIS 6.30에 대한 다양한 변경 내용이 추가되었습니다.
Size 멤버를 NDIS_SIZEOF_NDIS_PM_CAPABILITIES_REVISION_2 설정합니다.
NDIS_PM_CAPABILITIES_REVISION_1
NDIS 6.20의 원래 버전입니다.
Size 멤버를 NDIS_SIZEOF_NDIS_PM_CAPABILITIES_REVISION_1 설정합니다.
Flags
플래그의 비트 OR을 포함하는 ULONG 값입니다. NDIS 6.20의 경우 이 멤버는 NDIS용으로 예약되어 있습니다.
NDIS 6.30부터 다음 플래그가 정의됩니다.
NDIS_PM_WAKE_PACKET_INDICATION_SUPPORTED
이 플래그가 설정된 경우 네트워크 어댑터는 어댑터에서 절전 모드 해제 이벤트를 발생시킨 수신된 패킷을 저장할 수 있어야 합니다.
이 플래그가 설정된 경우 네트워크 어댑터가 전체 전원 상태로 전환된 후 미니포트 드라이버는 이 패킷으로 다음을 수행할 수 있어야 합니다.
- 미니포트 드라이버는 NdisMIndicateReceiveNetBufferLists를 호출하여 패킷을 나타낼 수 있어야 합니다.
- 미니포트 드라이버는 NDIS_STATUS_PM_WAKE_REASON 상태 표시를 실행할 수 있어야 하며 표시와 함께 패킷을 전달해야 합니다.
NDIS_PM_SELECTIVE_SUSPEND_SUPPORTED
이 플래그가 설정되면 미니포트 드라이버는 네트워크 어댑터에 대한 NDIS 선택적 일시 중단을 지원합니다.
이 전원 관리 기능에 대한 자세한 내용은 NDIS 선택적 일시 중단을 참조하세요.
SupportedWoLPacketPatterns
네트워크 어댑터가 지원하는 WOL(Wake-On-LAN) 패턴을 지정하는 플래그의 비트 OR을 포함하는 ULONG 값입니다. 미니포트 드라이버는 이러한 플래그를 사용하여 네트워크 어댑터가 지원하는 패킷 기반 WOL 패턴을 보급합니다.
이 멤버에 대한 자세한 내용은 설명 섹션을 참조하세요. WOL 패턴에 대한 자세한 내용은 NDIS_PM_WOL_PATTERN 참조하세요.
NDIS_PM_WOL_BITMAP_PATTERN_SUPPORTED
네트워크 어댑터는 구성된 비트맵 패턴과 일치하는 패킷을 수신할 때 절전 모드 해제 이벤트를 생성할 수 있습니다.
NDIS_PM_WOL_MAGIC_PACKET_SUPPORTED
네트워크 어댑터는 WOL 매직 패킷을 받으면 절전 모드 해제 이벤트를 생성할 수 있습니다. 매직 패킷은 페이로드 내에 값이 0xFF 6바이트의 문자열을 포함하고 수신 네트워크 어댑터의 이더넷 주소의 연속 복사본 16개를 즉시 포함합니다.
NDIS_PM_WOL_IPV4_TCP_SYN_SUPPORTED
네트워크 어댑터는 IPv4 TCP SYN 패킷을 받으면 절전 모드 해제 이벤트를 생성할 수 있습니다. 원격 호스트는 TCP SYN 패킷을 보내 로컬 컴퓨터에 대한 TCP 연결을 시작합니다.
NDIS_PM_WOL_IPV6_TCP_SYN_SUPPORTED
네트워크 어댑터는 IPv6 TCP SYN 패킷을 수신할 때 절전 모드 해제 이벤트를 생성할 수 있습니다.
NDIS_PM_WOL_IPV4_DEST_ADDR_WILDCARD_SUPPORTED
이 플래그가 설정되면 네트워크 어댑터는 IPv4 주소 및 TCP/UDP 포트에 대해 0으로 채워지거나 지정되지 않은 값을 WOL 패턴의 와일드카드 값으로 지원합니다. 이러한 방식으로 와일드카드 값은 WOL 패턴으로 지정된 위치에 있는 들어오는 패킷의 모든 IPv4 주소 및 포트 값과 일치합니다.
네트워크 어댑터가 IPv4 TCP SYN 패턴과 같은 LAN 패킷 패턴에 기반한 IPv4 기반 절전 모드 해제를 지원하는 경우 들어오는 패킷의 IPv4 주소 및 포트 값이 절전 모드 해제 패턴에 지정된 값과 일치하는 경우 절전 모드 해제 이벤트 생성을 지원해야 합니다.
그러나 NDIS_PM_WOL_IPV4_DEST_ADDR_WILDCARD_SUPPORTED 플래그가 설정된 경우 다음 패턴 일치 조건이 true인 경우 네트워크 어댑터에서 절전 모드 해제 이벤트를 생성할 수도 있습니다.
- 해당 위치의 WOL 패턴에 와일드카드 값이 포함된 경우 WOL 패턴으로 지정된 위치에 있는 들어오는 패킷의 모든 값이 일치합니다.
- 해당 위치의 WOL 패턴에 패킷 값과 동일한 0이 아닌 값이 포함된 경우 WOL 패턴으로 지정된 위치에 있는 들어오는 패킷의 값이 일치합니다.
NDIS_PM_WOL_IPV6_DEST_ADDR_WILDCARD_SUPPORTED
이 플래그가 설정되면 네트워크 어댑터는 IPv6 주소 및 TCP/UDP 포트에 대해 0으로 채워지거나 지정되지 않은 값을 WOL 패턴의 와일드카드 값으로 지원합니다. 이러한 방식으로 와일드카드 값은 WOL 패턴으로 지정된 위치에 있는 들어오는 패킷의 모든 IPv6 주소 및 포트 값과 일치합니다.
네트워크 어댑터가 IPv6 TCP SYN 패턴과 같은 LAN 패킷 패턴의 IPv6 기반 절전 모드 해제를 지원하는 경우 들어오는 패킷의 IPv6 주소 및 포트 값이 절전 모드 해제 패턴에 지정된 값과 일치하는 경우 절전 모드 해제 이벤트 생성을 지원해야 합니다.
그러나 NDIS_PM_WOL_IPV6_DEST_ADDR_WILDCARD_SUPPORTED 플래그가 설정된 경우 다음 패턴 일치 조건이 true인 경우 네트워크 어댑터에서 절전 모드 해제 이벤트를 생성할 수도 있습니다.
- 해당 위치의 WOL 패턴에 와일드카드 값이 포함된 경우 WOL 패턴으로 지정된 위치에 있는 들어오는 패킷의 모든 값이 일치합니다.
- 해당 위치의 WOL 패턴에 패킷 값과 동일한 0이 아닌 값이 포함된 경우 WOL 패턴으로 지정된 위치에 있는 들어오는 패킷의 값이 일치합니다.
NDIS_PM_WOL_EAPOL_REQUEST_ID_MESSAGE_SUPPORTED
네트워크 어댑터는 EAPOL 요청 식별자 메시지를 받으면 절전 모드 해제 이벤트를 생성할 수 있습니다.
NumTotalWoLPatterns
네트워크 어댑터가 지원하는 총 WOL 패턴 수를 포함하는 ULONG 값입니다. 이는 "지원되는 WOL 프로토콜 패턴 수" 및 "지원되는 WOL 비트맵 패턴 수"의 합계입니다.
예를 들어 드라이버가 8개의 유연한 비트맵 패턴, IPv4 TCP SYN(사전 설정 필터를 통해) 및 매직 패킷을 지원하는 경우 NumTotalWoLPatterns에서 9를 보고합니다. (8비트맵 + 1 IPv4 TCP SYN = 9)
MaxWoLPatternSize
패턴과 비교할 수 있는 최대 바이트 수를 포함하는 ULONG 값입니다.
MaxWoLPatternOffset
MAC 헤더의 시작 부분에서 시작하여 검사할 수 있는 패킷의 바이트 수를 포함하는 ULONG 값입니다.
MaxWoLPacketSaveBuffer
미니포트 드라이버가 버퍼에 저장하고 드라이버 스택을 나타낼 수 있는 WOL 패킷의 바이트 수를 포함하는 ULONG 값입니다. 이 값은 네트워크 미디어에 대한 MTU(최대 전송 단위)의 크기(바이트)보다 작거나 같아야 합니다. 드라이버는 OID_GEN_MAXIMUM_FRAME_SIZE OID 쿼리 요청을 통해 MTU 크기를 보고합니다.
SupportedProtocolOffloads
네트워크 어댑터가 지원하는 프로토콜 오프로드 기능을 지정하는 플래그의 비트 OR을 포함하는 ULONG 값입니다. 미니포트 드라이버는 이러한 플래그를 사용하여 네트워크 어댑터의 저전력 프로토콜 오프로드 기능을 보고합니다.
NDIS_PM_PROTOCOL_OFFLOAD_ARP_SUPPORTED
이 비트가 설정되면 네트워크 어댑터가 저전력 상태인 동안 IPv4 ARP 패킷에 응답할 수 있습니다.
ARP 프로토콜에 대한 자세한 내용은 RFC 826을 참조하세요.
NDIS_PM_PROTOCOL_OFFLOAD_NS_SUPPORTED
이 비트가 설정된 경우 네트워크 어댑터는 저전력 상태인 동안 IPv6 NS(인접 요청) 패킷에 응답할 수 있습니다.
IPv6 NS 메시지에 대한 자세한 내용은 RFC 4861을 참조하세요.
NDIS_PM_PROTOCOL_OFFLOAD_80211_RSN_REKEY_SUPPORTED
네트워크 어댑터는 전원이 부족한 상태에서 IEEE 802.11i RSN(강력한 보안 네트워크) 다시 키 요청에 응답할 수 있습니다.
NumArpOffloadIPv4Addresses
어댑터가 ARP 오프로드에 대해 지원하는 IPv4 주소 수를 포함하는 ULONG 값입니다.
NumNSOffloadIPv6Addresses
어댑터가 지원하는 IPv6 NS 오프로드 요청 수를 포함하는 ULONG 값입니다. 2 이상이어야 합니다.
MinMagicPacketWakeUp
네트워크 어댑터가 매직 패킷을 수신할 때 절전 모드 해제 이벤트에 신호를 보낼 수 있는 가장 낮은 디바이스 전원 상태를 지정합니다. 매직 패킷은 페이로드 내에 값이 0xFF 6바이트의 문자열을 포함하고 수신 네트워크 어댑터의 MAC 주소는 16개의 연속 복사본을 포함합니다.
NdisDeviceStateUnspecified
네트워크 어댑터는 매직 패킷 절식 기능을 지원하지 않습니다.
NdisDeviceStateD0
네트워크 어댑터는 디바이스 전원 상태 D0에서 매직 패킷 절전 모드 해제 신호를 보낼 수 있습니다. D0은 완전히 전원이 공급되는 상태이므로 절전 모드 해제가 발생하지는 않지만 런타임 이벤트로 사용할 수 있습니다.
NdisDeviceStateD1
네트워크 어댑터는 디바이스 전원 상태 D1에서 매직 패킷 절전 모드 해제를 알릴 수 있습니다.
NdisDeviceStateD2
네트워크 어댑터는 디바이스 상태 D2에서 매직 패킷 절동을 신호로 표시할 수 있습니다.
NdisDeviceStateD3
네트워크 어댑터는 디바이스 전원 상태 D3에서 매직 패킷 절전 모드 해제를 알릴 수 있습니다.
MinPatternWakeUp
네트워크 어댑터가 프로토콜 드라이버에서 지정한 패턴을 포함하는 네트워크 프레임 수신 시 절전 모드 해제 이벤트를 신호로 보낼 수 있는 가장 낮은 디바이스 전원 상태를 지정합니다. 전원 상태는 다음 NDIS_DEVICE_POWER_STATE 값 중 하나로 지정됩니다.
NdisDeviceStateUnspecified
네트워크 어댑터는 패턴 일치 절전 모드 해제를 지원하지 않습니다.
NdisDeviceStateD0
네트워크 어댑터는 디바이스 전원 상태 D0에서 패턴 일치 절전 모드 해제를 알릴 수 있습니다. D0은 완전히 전원이 공급되는 상태이므로 절전 모드 해제가 발생하지는 않지만 런타임 이벤트로 사용할 수 있습니다.
NdisDeviceStateD1
네트워크 어댑터는 D1 디바이스 전원 상태에서 패턴 일치 절전 모드 해제를 알릴 수 있습니다.
NdisDeviceStateD2
네트워크 어댑터는 D2 디바이스 전원 상태에서 패턴 일치 절전 모드 해제를 알릴 수 있습니다.
NdisDeviceStateD3
네트워크 어댑터는 D3 디바이스 전원 상태에서 패턴 일치 절전 모드 해제를 알릴 수 있습니다.
MinLinkChangeWakeUp
NDIS 6.20부터 이 멤버는 연결 상태가 미디어 연결이 끊어진 미디어에서 연결된 미디어로 변경될 때 네트워크 어댑터가 절전 모드 해제 이벤트를 신호로 표시할 수 있는 가장 낮은 디바이스 전원 상태를 지정합니다.
NDIS 6.30부터 이 멤버는 네트워크 어댑터가 절전 모드 해제 이벤트를 신호로 표시할 수 있는 가장 낮은 디바이스 전원 상태를 지정합니다. 이러한 이벤트는 SupportedWakeUpEvents 멤버에 지정됩니다.
전원 상태는 다음 NDIS_DEVICE_POWER_STATE 값 중 하나로 지정됩니다.
NdisDeviceStateUnspecified
네트워크 어댑터는 링크 변경 절 해제를 지원하지 않습니다.
NdisDeviceStateD0
네트워크 어댑터는 디바이스 전원 상태 D0에서 링크 변경 절전 모드 해제를 알릴 수 있습니다. D0은 완전히 전원이 공급되는 상태이므로 절전 모드 해제가 발생하지는 않지만 런타임 이벤트로 사용할 수 있습니다.
NdisDeviceStateD1
네트워크 어댑터는 D1 디바이스 전원 상태에서 링크 변경 절전 모드 해제를 알릴 수 있습니다.
NdisDeviceStateD2
네트워크 어댑터는 D2 디바이스 전원 상태에서 링크 변경 절전 모드 해제를 알릴 수 있습니다.
NdisDeviceStateD3
네트워크 어댑터는 D3 디바이스 전원 상태에서 링크 변경 절전 모드 해제를 알릴 수 있습니다.
SupportedWakeUpEvents
플래그의 비트 OR을 포함하는 ULONG 값입니다. 이러한 플래그는 네트워크 어댑터가 지원하는 미디어 독립적 절 해제 이벤트를 지정합니다. 이러한 이벤트는 미디어 유형에만 해당되지 않습니다.
NDIS 6.30부터 다음 플래그가 정의됩니다.
NDIS_PM_WAKE_ON_MEDIA_CONNECT_SUPPORTED
이 플래그를 설정하면 네트워크 어댑터가 네트워킹 인터페이스에 연결될 때 절전 모드 해제 이벤트를 생성할 수 있습니다.
NDIS_PM_WAKE_ON_MEDIA_DISCONNECT_SUPPORTED
이 플래그를 설정하면 네트워크 어댑터가 네트워킹 인터페이스에 연결이 끊어지면 절전 모드 해제 이벤트를 생성할 수 있습니다.
MediaSpecificWakeUpEvents
플래그의 비트 OR을 포함하는 ULONG 값입니다. 이러한 플래그는 네트워크 어댑터가 지원하는 미디어별 절식 이벤트를 지정합니다.
NDIS 6.30부터 다음 플래그가 정의됩니다.
NDIS_WLAN_WAKE_ON_NLO_DISCOVERY_SUPPORTED
이 플래그가 설정된 경우 802.11 네트워크 어댑터는 NLO(네트워크 목록 오프로드)를 통해 지정된 SSID(서비스 집합 식별자)를 검색하는 경우 절전 모드 해제 이벤트를 생성할 수 있습니다.
NLO에 대한 자세한 내용은 Wi-Fi 네트워크 목록 오프로드를 참조하세요.
NDIS_WLAN_WAKE_ON_AP_ASSOCIATION_LOST_SUPPORTED
이 플래그가 설정되면 802.11 네트워크 어댑터가 AP(액세스 지점)와 연결되지 않은 경우 절전 모드 해제 이벤트를 생성할 수 있습니다.
NDIS_WLAN_WAKE_ON_GTK_HANDSHAKE_ERROR_SUPPORTED
이 플래그를 설정하면 IEEE 802.11i RSN GTK(그룹 일시적 키) 핸드셰이크 중에 오류가 발생하는 경우 802.11 네트워크 어댑터가 절전 모드 해제 이벤트를 생성할 수 있습니다.
NDIS_WLAN_WAKE_ON_4WAY_HANDSHAKE_REQUEST_SUPPORTED
이 플래그를 설정하면 802.11 네트워크 어댑터가 AP와 IEEE 802.11i RSN 4방향 핸드셰이크의 첫 번째 프레임을 수신하는 경우 절전 모드 해제 이벤트를 생성할 수 있습니다. 이 핸드셰이크는 어댑터가 AP를 사용하여 인증할 때 수행됩니다.
NDIS_WWAN_WAKE_ON_REGISTER_STATE_SUPPORTED
이 플래그를 설정하면 MB 서비스에 대한 등록 상태가 변경된 경우 모바일 광대역(MB) 네트워크 어댑터가 절전 모드 해제 이벤트를 생성할 수 있습니다.
NDIS_WWAN_WAKE_ON_SMS_RECEIVE_SUPPORTED
이 플래그를 설정하면 MB 서비스에 SMS(짧은 메시지 서비스) 메시지 수신에 대한 알림을 수신해야 하는 경우 MB 네트워크 어댑터가 절전 모드 해제 이벤트를 생성할 수 있습니다. 어댑터는 이전에 발급된 OID_WWAN_SMS_READ 쿼리 요청이 완료되거나 네트워크 공급자로부터 이벤트 알림으로 새 클래스 0(플래시/경고) 메시지가 도착한 후 이 절전 모드 해제 이벤트를 생성합니다.
NDIS_WWAN_WAKE_ON_USSD_RECEIVE_SUPPORTED
이 플래그를 설정하면 MB 네트워크 어댑터가 USSD(비정형 보조 서비스 데이터) 메시지를 받으면 절전 모드 해제 이벤트를 생성할 수 있습니다.
설명
NDIS_PM_CAPABILITIES 구조체는 의 PowerManagementCapabilitiesEx 멤버에 사용됩니다. NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES 및 NDIS_BIND_PARAMETERS 구조체 및 상태 표시를 NDIS_STATUS_PM_CAPABILITIES_CHANGE.
미니포트 초기화 중에 미니포트 드라이버는 네트워크 어댑터 하드웨어의 전원 관리 기능을 사용하여 NDIS_PM_CAPABILITIES 구조를 초기화합니다. 그런 다음 미니포트 드라이버는 초기화된 NDIS_PM_CAPABILITIES 구조를 가리키도록 NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES 구조체의 PowerManagementCapabilitiesEx 멤버를 설정합니다.
오버리싱 드라이버는 네트워크 어댑터가 지원하지 않는 기능을 사용하도록 설정하려고 하면 안 됩니다. 오버리싱 드라이버가 네트워크 어댑터에서 제공하는 기능을 확인할 수 있도록 NDIS는 NDIS_BIND_PARAMETERS 구조체의 PowerManagementCapabilitiesEx 멤버에 기능을 제공합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | NDIS 6.20 이상에서 지원됩니다. |
| 머리글 | ntddndis.h(Ntddndis.h 포함) |
추가 정보
NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES NDIS_STATUS_PM_CAPABILITIES_CHANGE피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기