다음을 통해 공유


MIB_IF_ROW2 구조체

MIB_IF_ROW2 구조체는 특정 인터페이스에 대한 정보를 저장합니다.

구문

typedef struct _MIB_IF_ROW2 {
  NET_LUID                   InterfaceLuid;
  NET_IFINDEX                InterfaceIndex;
  GUID                       InterfaceGuid;
  WCHAR                      Alias[IF_MAX_STRING_SIZE + 1];
  WCHAR                      Description[IF_MAX_STRING_SIZE + 1];
  ULONG                      PhysicalAddressLength;
  UCHAR                      PhysicalAddress[IF_MAX_PHYS_ADDRESS_LENGTH];
  UCHAR                      PermanentPhysicalAddress[IF_MAX_PHYS_ADDRESS_LENGTH];
  ULONG                      Mtu;
  IFTYPE                     Type;
  TUNNEL_TYPE                TunnelType;
  NDIS_MEDIUM                MediaType;
  NDIS_PHYSICAL_MEDIUM       PhysicalMediumType;
  NET_IF_ACCESS_TYPE         AccessType;
  NET_IF_DIRECTION_TYPE      DirectionType;
  struct {
    BOOLEAN HardwareInterface  :1;
    BOOLEAN FilterInterface  :1;
    BOOLEAN ConnectorPresent  :1;
    BOOLEAN NotAuthenticated  :1;
    BOOLEAN NotMediaConnected  :1;
    BOOLEAN Paused  :1;
    BOOLEAN LowPower  :1;
    BOOLEAN EndPointInterface  :1;
  } InterfaceAndOperStatusFlags;
  IF_OPER_STATUS             OperStatus;
  NET_IF_ADMIN_STATUS        AdminStatus;
  NET_IF_MEDIA_CONNECT_STATE MediaConnectState;
  NET_IF_NETWORK_GUID        NetworkGuid;
  NET_IF_CONNECTION_TYPE     ConnectionType;
  ULONG64                    TransmitLinkSpeed;
  ULONG64                    ReceiveLinkSpeed;
  ULONG64                    InOctets;
  ULONG64                    InUcastPkts;
  ULONG64                    InNUcastPkts;
  ULONG64                    InDiscards;
  ULONG64                    InErrors;
  ULONG64                    InUnknownProtos;
  ULONG64                    InUcastOctets;
  ULONG64                    InMulticastOctets;
  ULONG64                    InBroadcastOctets;
  ULONG64                    OutOctets;
  ULONG64                    OutUcastPkts;
  ULONG64                    OutNUcastPkts;
  ULONG64                    OutDiscards;
  ULONG64                    OutErrors;
  ULONG64                    OutUcastOctets;
  ULONG64                    OutMulticastOctets;
  ULONG64                    OutBroadcastOctets;
  ULONG64                    OutQLen;
} MIB_IF_ROW2, *PMIB_IF_ROW2;

멤버

  • InterfaceLuid
    네트워크 인터페이스에 대한 LUID(로컬 고유 식별자)입니다.

  • InterfaceIndex
    네트워크 인터페이스를 식별하는 인덱스입니다. 네트워크 어댑터를 사용하지 않도록 설정한 다음 사용하도록 설정하면 이 인덱스 값이 변경될 수 있으며 영구로 간주해서는 안 됩니다.

  • InterfaceGuid
    네트워크 인터페이스의 GUID입니다.

  • 별칭
    네트워크 인터페이스의 별칭 이름을 포함하는 NULL로 종료된 유니코드 문자열입니다.

  • 설명
    네트워크 인터페이스에 대한 설명을 포함하는 NULL로 종료된 유니코드 문자열입니다.

  • PhysicalAddressLength
    PhysicalAddress 멤버가 지정하는 실제 하드웨어 주소의 길이(바이트)입니다.

  • PhysicalAddress
    이 네트워크 인터페이스에 대한 어댑터의 물리적 하드웨어 주소입니다.

  • PermanentPhysicalAddress
    이 네트워크 인터페이스에 대한 어댑터의 영구 물리적 하드웨어 주소입니다.

  • Mtu
    이 네트워크 인터페이스에 대한 MTU(최대 전송 단위) 크기(바이트)입니다.

  • 형식
    IANA(Internet Assigned Names Authority)에서 정의한 인터페이스 형식입니다. 자세한 내용은 IANAifType-MIB 정의를 참조하세요. 인터페이스 형식에 대한 가능한 값은 Ipifcons.h 헤더 파일에 나열됩니다.

    다음 표에는 인터페이스 형식에 대한 공통 값이 나와 있지만 다른 많은 값이 가능합니다.

    의미

    IF_TYPE_OTHER

    1

    다른 유형의 네트워크 인터페이스

    IF_TYPE_ETHERNET_CSMACD

    6

    이더넷 네트워크 인터페이스

    IF_TYPE_ISO88025_TOKENRING

    9

    토큰 링 네트워크 인터페이스

    IF_TYPE_PPP

    23

    PPP 네트워크 인터페이스

    IF_TYPE_SOFTWARE_LOOPBACK

    24

    소프트웨어 루프백 네트워크 인터페이스

    IF_TYPE_ATM

    37

    ATM 네트워크 인터페이스

    IF_TYPE_IEEE80211

    71

    IEEE 802.11 무선 네트워크 인터페이스

    IF_TYPE_TUNNEL

    131

    터널 형식 캡슐화 네트워크 인터페이스

    IF_TYPE_IEEE1394

    144

    IEEE 1394(Firewire) 고성능 직렬 버스 네트워크 인터페이스

  • TunnelType
    Type 멤버가 IF_TYPE_TUNNEL 경우 터널에서 사용하는 캡슐화 메서드를 정의하는 TUNNEL_TYPE 형식입니다.

  • MediaType
    인터페이스에 대한 NDIS 미디어 형식입니다. 이 멤버는 Ntddndis.h 헤더 파일에 정의된 NDIS_MEDIUM 열거형 형식의 다음 값 중 하나일 수 있습니다.

    의미

    NdisMedium802_3

    0

    이더넷(802.3) 네트워크.

    NdisMedium802_5

    1

    토큰 링(802.5) 네트워크.

    NdisMediumFddi

    2

    FDDI(파이버 분산 데이터 인터페이스) 네트워크.

    NdisMediumWan

    3

    WAN(광역 네트워크). 이 형식은 바인딩이 설정된 후 프로토콜 드라이버와 기본 드라이버 간에 협상해야 하는 다양한 형태의 지점 및 WAN NIC 및 변형 주소/헤더 형식을 다룹니다.

    NdisMediumLocalTalk

    4

    LocalTalk 네트워크.

    NdisMediumDix

    5

    드라이버가 DIX 이더넷 헤더 형식을 사용하는 이더넷 네트워크입니다.

    NdisMediumArcnetRaw

    6

    ARCNET 네트워크.

    NdisMediumArcnet878_2

    7

    ARCNET(878.2) 네트워크.

    NdisMediumAtm

    8

    ATM 네트워크. 연결 지향 클라이언트 프로토콜 드라이버는 이 값을 반환하는 기본 미니포트 드라이버에 자신을 바인딩할 수 있습니다. 그렇지 않으면 레거시 프로토콜 드라이버는 네트워크 관리자가 LanE 드라이버를 구성하는 방법에 따라 중간 형식을 NdisMedium802_3 또는 NdisMedium802_5 보고하는 시스템 제공 LanE 중간 드라이버에 바인딩됩니다.

    NdisMediumWirelessWan

    9

    무선 네트워크. NDIS 5. WLAN(무선 LAN) 또는 WWAN(무선 WAN) 패킷을 지원하는 x 미니포트 드라이버는 해당 매체를 NdisMedium802_3 선언하고 이더넷을 상위 수준 NDIS 드라이버에 에뮬레이트합니다.

    참고 이 미디어 유형은 Windows Vista 이상 버전의 Windows에서 사용할 수 없습니다.

    NdisMediumIrda

    10

    IrDA(적외선) 네트워크.

    NdisMediumBpc

    11

    브로드캐스트 컴퓨터 네트워크.

    NdisMediumCoWan

    12

    연결 지향 환경의 광역 네트워크입니다.

    NdisMedium1394

    13

    IEEE 1394(방화선) 네트워크.

    NdisMediumInfiniBand

    14

    InfiniBand 네트워크입니다.

    NdisMediumTunnel

    15

    터널 네트워크.

    NdisMediumNative802_11

    16

    네이티브 IEEE 802.11 네트워크.

    NdisMediumLoopback

    17

    NDIS 루프백 네트워크.

  • PhysicalMediumType
    NDIS 물리적 중간 형식입니다. 이 멤버는 Ntddndis.h 헤더 파일에 정의된 NDIS_PHYSICAL_MEDIUM 열거형 형식의 다음 값 중 하나일 수 있습니다.

    의미

    NdisPhysicalMediumUnspecified

    0

    실제 매체는 다음 값이 없습니다. 예를 들어 단방향 위성 피드는 지정되지 않은 물리적 매체입니다.

    NdisPhysicalMediumWirelessLan

    1

    패킷은 802.11 인터페이스를 준수하는 미니포트 드라이버를 통해 무선 LAN 네트워크를 통해 전송됩니다.

    NdisPhysicalMediumCableModem

    2

    패킷은 DOCSIS 기반 케이블 네트워크를 통해 전송됩니다.

    NdisPhysicalMediumPhoneLine

    3

    패킷은 표준 전화선을 통해 전송됩니다. 이 형식에는 HomePNA 미디어가 포함됩니다.

    NdisPhysicalMediumPowerLine

    4

    패킷은 배전 시스템에 연결된 배선을 통해 전송됩니다.

    NdisPhysicalMediumDSL

    5

    패킷은 DSL(디지털 구독자 회선) 네트워크를 통해 전송됩니다. 이 형식에는 ADSL, UADSL(G.Lite) 및 SDSL이 포함됩니다.

    NdisPhysicalMediumFibreChannel

    6

    패킷은 파이버 채널 상호 연결을 통해 전송됩니다.

    NdisPhysicalMedium1394

    7

    패킷은 IEEE 1394 버스를 통해 전송됩니다.

    NdisPhysicalMediumWirelessWan

    8

    패킷은 무선 WAN 링크를 통해 전송됩니다. 이 형식에는 CDPD, CDMA 및 GPRS가 포함됩니다.

    NdisPhysicalMediumNative802_11

    9

    패킷은 네이티브 802.11 인터페이스를 준수하는 미니포트 드라이버를 통해 무선 LAN 네트워크를 통해 전송됩니다.

    참고 Native 802.11 인터페이스는 NDIS 6.0 이상 버전에서 지원됩니다.

    NdisPhysicalMediumBluetooth

    10

    패킷은 Bluetooth 네트워크를 통해 전송됩니다. Bluetooth는 2.4GHz 스펙트럼을 사용하는 단거리 무선 기술입니다.

    NdisPhysicalMediumInfiniband

    11

    패킷은 InfiniBand 상호 연결을 통해 전송됩니다.

    NdisPhysicalMediumUWB

    13

    패킷은 울트라 와이드 밴드 네트워크를 통해 전송됩니다.

    NdisPhysicalMedium802_3

    14

    패킷은 이더넷(802.3) 네트워크를 통해 전송됩니다.

    NdisPhysicalMedium802_5

    15

    패킷은 토큰 링(802.5) 네트워크를 통해 전송됩니다.

    NdisPhysicalMediumIrda

    16

    패킷은 IrDA(적외선) 네트워크를 통해 전송됩니다.

    NdisPhysicalMediumWiredWAN

    17

    패킷은 유선 WAN 네트워크를 통해 전송됩니다.

    NdisPhysicalMediumWiredCoWan

    18

    패킷은 연결 지향 환경에서 광역 네트워크를 통해 전송됩니다.

    NdisPhysicalMediumOther

    19

    패킷은 다른 가능한 값으로 설명되지 않은 네트워크를 통해 전송됩니다.

  • AccessType
    NET_IF_ACCESS_TYPE NDIS 네트워크 인터페이스 액세스 유형입니다.

  • DirectionType
    NET_IF_DIRECTION_TYPE NDIS 네트워크 인터페이스 방향 유형입니다.

  • InterfaceAndOperStatusFlags
    인터페이스에 대한 정보를 제공하는 다음 플래그 집합입니다. 이러한 플래그는 비트 OR 연산과 결합됩니다. 플래그가 적용되지 않으면 이 멤버는 0으로 설정됩니다.

    • HardwareInterface
      네트워크 인터페이스는 하드웨어용입니다.

    • FilterInterface
      네트워크 인터페이스는 필터 모듈용입니다.

    • ConnectorPresent
      네트워크 인터페이스에 커넥터가 있습니다. 이 값은 실제 네트워크 어댑터가 있는 경우 설정됩니다.

    • NotAuthenticated
      네트워크 인터페이스의 기본 포트는 인증되지 않습니다. 네트워크 인터페이스가 대상에 의해 인증되지 않은 경우 네트워크 인터페이스는 작동 모드가 아닙니다. 이 상황은 유선 및 무선 네트워크 연결 모두에 적용되지만 무선 네트워크 연결에 대해 인증이 더 일반적입니다.

    • NotMediaConnected
      네트워크 인터페이스가 미디어에 연결된 상태가 아닙니다. 유선 네트워크에 대해 네트워크 케이블을 분리하면 이 값이 설정됩니다. 무선 네트워크의 경우 이 값은 네트워크에 연결되지 않은 네트워크 어댑터에 대해 설정됩니다.

    • 일시 중지됨
      네트워크 인터페이스의 네트워크 스택이 일시 중지되거나 일시 중지된 상태입니다. 이 값이 컴퓨터가 최대 절전 모드 상태임을 의미하지는 않습니다.

    • LowPower
      네트워크 인터페이스가 저전력 상태입니다.

    • EndPointInterface
      네트워크 인터페이스는 네트워크에 연결하는 실제 네트워크 인터페이스가 아닌 엔드포인트 디바이스입니다. 이 값은 네트워킹 인프라를 사용하여 컴퓨터와 통신하지만 외부 네트워크에 대한 연결을 제공하지 않는 스마트폰과 같은 디바이스에서 설정할 수 있습니다. 이러한 유형의 디바이스는 이 플래그를 설정해야 합니다.

  • OperStatus
    IF_OPER_STATUS NDIS 네트워크 인터페이스 운영 상태 유형입니다.

  • AdminStatus
    NET_IF_ADMIN_STATUS 관리 상태 유형입니다.

  • MediaConnectState
    NET_IF_MEDIA_CONNECT_STATE 연결 상태 유형입니다.

  • NetworkGuid
    인터페이스가 속한 네트워크와 연결된 GUID입니다.

  • ConnectionType
    NET_IF_CONNECTION_TYPE NDIS 네트워크 인터페이스 연결 형식입니다.

  • TransmitLinkSpeed
    전송 링크의 속도(초당 비트)입니다.

  • ReceiveLinkSpeed
    수신 링크의 속도(초당 비트)입니다.

  • InOctets
    이 인터페이스를 통해 오류 없이 수신되는 데이터의 8진수입니다. 이 값에는 유니캐스트, 브로드캐스트 및 멀티캐스트 패킷의 옥텟이 포함됩니다.

  • InUcastPkts
    이 인터페이스를 통해 오류 없이 수신되는 유니캐스트 패킷 수입니다.

  • InNUcastPkts
    이 인터페이스를 통해 오류 없이 수신되는 유니캐스트가 아닌 패킷의 수입니다. 이 값에는 브로드캐스트 및 멀티캐스트 패킷이 포함됩니다.

  • InDiscards
    오류가 없는 경우에도 삭제된 들어오는 패킷의 수입니다.

  • InErrors
    오류로 인해 삭제된 들어오는 패킷의 수입니다.

  • InUnknownProtos
    프로토콜을 알 수 없어 삭제된 들어오는 패킷의 수입니다.

  • InUcastOctets
    이 인터페이스를 통해 유니캐스트 패킷에서 오류 없이 수신되는 데이터의 8진수입니다.

  • InMulticastOctets
    이 인터페이스를 통해 멀티캐스트 패킷에서 오류 없이 수신되는 데이터의 8진수입니다.

  • InBroadcastOctets
    이 인터페이스를 통해 브로드캐스트 패킷에서 오류 없이 수신되는 데이터의 8진수입니다.

  • OutOctets
    이 인터페이스를 통해 오류 없이 전송되는 데이터의 8진수입니다. 이 값에는 유니캐스트, 브로드캐스트 및 멀티캐스트 패킷의 옥텟이 포함됩니다.

  • OutUcastPkts
    이 인터페이스를 통해 오류 없이 전송되는 유니캐스트 패킷의 수입니다.

  • OutNUcastPkts
    이 인터페이스를 통해 오류 없이 전송되는 유니캐스트가 아닌 패킷의 수입니다. 이 값에는 브로드캐스트 및 멀티캐스트 패킷이 포함됩니다.

  • OutDiscards
    오류가 없는 경우에도 삭제된 나가는 패킷의 수입니다.

  • OutErrors
    오류로 인해 삭제된 나가는 패킷의 수입니다.

  • OutUcastOctets
    이 인터페이스를 통해 유니캐스트 패킷에서 오류 없이 전송되는 데이터의 8진수입니다.

  • OutMulticastOctets
    이 인터페이스를 통해 멀티캐스트 패킷에서 오류 없이 전송되는 데이터의 8진수입니다.

  • OutBroadcastOctets
    이 인터페이스를 통해 브로드캐스트 패킷에서 오류 없이 전송되는 데이터의 8진수입니다.

  • OutQLen
    전송 큐 길이입니다. 이 필드는 현재 사용되지 않습니다.

설명

형식 필드의 값은 Ipifcons.h 헤더 파일에 정의됩니다. Type 멤버의 설명에 나열된 가능한 값만 현재 지원됩니다.

요구 사항

Version

Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.

헤더

Netioapi.h(Netioapi.h 포함)

추가 정보

GetIfEntry2

GetIfTable2

MIB_IF_TABLE2

NET_IF_ACCESS_TYPE

NET_IF_ADMIN_STATUS

NET_IF_CONNECTION_TYPE

NET_IF_DIRECTION_TYPE

NET_IF_MEDIA_CONNECT_STATE

NET_LUID

TUNNEL_TYPE