MIB_IFROW 구조체(ifmib.h)

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

구문

typedef struct _MIB_IFROW {
  WCHAR                   wszName[MAX_INTERFACE_NAME_LEN];
  IF_INDEX                dwIndex;
  IFTYPE                  dwType;
  DWORD                   dwMtu;
  DWORD                   dwSpeed;
  DWORD                   dwPhysAddrLen;
  UCHAR                   bPhysAddr[MAXLEN_PHYSADDR];
  DWORD                   dwAdminStatus;
  INTERNAL_IF_OPER_STATUS dwOperStatus;
  DWORD                   dwLastChange;
  DWORD                   dwInOctets;
  DWORD                   dwInUcastPkts;
  DWORD                   dwInNUcastPkts;
  DWORD                   dwInDiscards;
  DWORD                   dwInErrors;
  DWORD                   dwInUnknownProtos;
  DWORD                   dwOutOctets;
  DWORD                   dwOutUcastPkts;
  DWORD                   dwOutNUcastPkts;
  DWORD                   dwOutDiscards;
  DWORD                   dwOutErrors;
  DWORD                   dwOutQLen;
  DWORD                   dwDescrLen;
  UCHAR                   bDescr[MAXLEN_IFDESCR];
} MIB_IFROW, *PMIB_IFROW;

멤버

wszName[MAX_INTERFACE_NAME_LEN]

형식: WCHAR[MAX_INTERFACE_NAME_LEN]

인터페이스 이름을 포함하는 유니코드 문자열에 대한 포인터입니다.

dwIndex

형식:DWORD

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

dwType

형식:DWORD

IANA(Internet Assigned Names Authority)에서 정의한 인터페이스 형식입니다. 자세한 내용은 http://www.iana.org/assignments/ianaiftype-mib를 참조하세요. 인터페이스 형식에 대한 가능한 값은 Ipifcons.h 헤더 파일에 나열됩니다.

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

dwMtu

형식:DWORD

MTU(최대 전송 단위) 크기(바이트)입니다.

dwSpeed

형식:DWORD

인터페이스의 속도(초당 비트)입니다.

dwPhysAddrLen

형식:DWORD

bPhysAddr 멤버가 지정한 실제 주소의 길이(바이트)입니다.

bPhysAddr[MAXLEN_PHYSADDR]

형식: BYTE[MAXLEN_PHYSADDR]

이 인터페이스에 대한 어댑터의 실제 주소입니다.

dwAdminStatus

형식:DWORD

인터페이스는 관리적으로 사용하거나 사용하지 않도록 설정됩니다.

dwOperStatus

형식:DWORD

인터페이스의 작동 상태. 이 멤버는 Ipifcons.h 헤더 파일에 정의된 INTERNAL_IF_OPER_STATUS 열거형에 정의된 다음 값 중 하나일 수 있습니다.

dwLastChange

형식:DWORD

인터페이스가 현재 작동 상태로 진입한 마지막 컴퓨터 다시 시작부터 시작하여 수백 초(10^-2초)의 시간입니다. 이 값은 2^3200초 후에 롤오버됩니다.

dwLastChange 멤버는 현재 NDIS에서 지원되지 않습니다. Windows Vista 이상에서 NDIS는 이 멤버에 대해 0을 반환합니다. 이전 버전의 Windows에서는 NDIS에서 지원하는 인터페이스에 대해 이 멤버에 임의의 값이 반환됩니다. 다른 인터페이스 공급자가 지원하는 인터페이스의 경우 적절한 값을 반환할 수 있습니다.

dwInOctets

형식:DWORD

이 인터페이스를 통해 수신된 데이터의 8진수입니다.

dwInUcastPkts

형식:DWORD

이 인터페이스를 통해 수신된 유니캐스트 패킷의 수입니다.

dwInNUcastPkts

형식:DWORD

이 인터페이스를 통해 수신된 유니캐스트가 아닌 패킷의 수입니다. 브로드캐스트 및 멀티캐스트 패킷이 포함됩니다.

dwInDiscards

형식:DWORD

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

dwInErrors

형식:DWORD

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

dwInUnknownProtos

형식:DWORD

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

dwOutOctets

형식:DWORD

이 인터페이스를 통해 전송된 데이터의 8진수입니다.

dwOutUcastPkts

형식:DWORD

이 인터페이스를 통해 전송된 유니캐스트 패킷의 수입니다.

dwOutNUcastPkts

형식:DWORD

이 인터페이스를 통해 전송된 유니캐스트가 아닌 패킷의 수입니다. 브로드캐스트 및 멀티캐스트 패킷이 포함됩니다.

dwOutDiscards

형식:DWORD

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

dwOutErrors

형식:DWORD

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

dwOutQLen

형식:DWORD

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

dwDescrLen

형식:DWORD

bDescr 멤버의 길이(바이트)입니다.

bDescr[MAXLEN_IFDESCR]

형식: BYTE[MAXLEN_IFDESCR]

인터페이스에 대한 설명입니다.

설명

DWORD에 저장할 수 있는 최대값은 4,294,967,295이므로 MIB_IFROW 구조의 dwSpeed 멤버는 고속 네트워크 인터페이스(예: 10Gbit/s 네트워크 어댑터)에 대해 올바르지 않습니다. 애플리케이션은 GetIfEntry2 및 GetIfTable2 함수에서 반환하는 MIB_IF_ROW2 구조 또는GetAdaptersAddresses 함수에서 반환된 IP_ADAPTER_ADDRESSES 구조를 사용하여 고속 네트워크 인터페이스의 속도를 결정해야 합니다.

Windows Vista 이상용으로 릴리스된 Microsoft SDK(Windows SDK(소프트웨어 개발 키트))에서 헤더 파일의 organization 변경되었으며 MIB_IFROW 구조는 Iprtrmib.h 헤더 파일이 아닌 Ifmib.h 헤더 파일에 정의되어 있습니다. Ifmib.h 헤더 파일은 Iphlpapi.h 헤더 파일에 자동으로 포함되는 Iprtrmib.h에 자동으로 포함됩니다. Ifmib.h 및 Iprtrmib.h 헤더 파일은 직접 사용하면 안 됩니다.

요구 사항

추가 정보

GetAdaptersAddresses

GetIfEntry

GetIfEntry2

IP_ADAPTER_ADDRESSES

MIB_IFSTATUS

MIB_IFTABLE

MIB_IF_TABLE2

MPR_INTERFACE_0