11.1 연결지향 미니포트를 위한 일반적인 연산 통계

다음의 차트는 연결지향 미니포트들과 그들의 NIC들에 대한 이더넷 연산적인 특성을 셋하거나 얻는데 사용된 OID들을 요약한다. 연결지향 미니포트가 MiniportCoRequest 함수에서 그런 요구들을 다루는 것을 주목해라.

Length Q S Name
Arr(4) M   OID_GEN_CO_SUPPORTED_LIST
지원되지 않는 OID들의 목록
4 M OID_GEN_CO_HARDWARE_STATUS
하드웨어 상태
Arr(4) M OID_GEN_CO_MEDIA_SUPPORTED
지원된는(인코드된) 미디어 타입들
Arr(4) M OID_GEN_CO_MEDIA_IN_USE
사용에 대한 미디어 타입입들(인코드된)
4 M OID_GEN_CO_LINK_SPEED
100 bps의 유닛들에서 전송과 수신 링크 속도들
4 M OID_GEN_CO_VENDOR_ID
벤더 NIC code
Var. M OID_GEN_CO_VENDOR_DESCRIPTION
벤더 네트워크 카드 설명
4 M OID_GEN_CO_VENDOR_DRIVER_VERSION
드라이버의 벤더-할당된 버전 넘버
2 M OID_GEN_CO_DRIVER_VERSION
드라이버에의해서 사용된 NDIS 버전 넘버
4   M OID_GEN_CO_PROTOCOL_OPTIONS
추가적인 프로토콜 플래그들(인코드된)
4 M   OID_GEN_CO_MAC_OPTIONS
이것은 예약되었다.
4 M OID_GEN_CO_MEDIA_CONNECT_STATUS
NIC이 네트워크에 연결되는지 안되는지
4 M OID_GEN_CO_MINIMUM_LINK_SPEED
링크에의해서 지원되는 최소 속도.
Arr O OID_GEN_CO_SUPPORTED_GUIDS
미니포트에의해서 지원되는 커스텀GUIDs(Globally Unique Identifiers)
8 O OID_GEN_CO_GET_TIME_CAPS
NIC의 로컬 시간을 보고하는 것에 대한 미니포트의 능력들
8 O OID_GEN_CO_GET_NETCARD_TIME
NIC의 로컬 시간

다음은 앞에 차트에서 전체적인 목록된 OID_XXX의 각각을 설명한다.

OID_GEN_CO_SUPPORTED_LIST

밑의 드라이버나 그것의 NIC이 지원하는 객체들의 배열을 상술한다. 객체들은 일반적으로 미디어-스펙과 수행-스펙 객체들을 포함한다.

밑의 드라이버는 증가하는 숫자 순으로 리턴하는 OID 목록을 순서화해야한다. NDIS는 이 질의를 만든 프로토콜에서 리턴된 목록의 서브셋을 보낸다. 즉, 프로토콜들이 그다음에 통계 질의를 만들지 않기때문에 NDIS는 목록의 밖의 지원되는 통계 OID들을 필터한다.

OID_GEN_CO_HARDWARE_STATUS

다음의 NDIS_HARDWARE_STATUS 값들의 하나로 밑의 NIC의 현재 하드웨어 상태를 상술한다.

NdisHardwareStatusReady
선에서 데이터를 수신하고 보낼 수 있는 능력

NdisHardwareStatusInitializing
초기화하는 것

NdisHardwareStatusReset
리셋팅하는 것

NdisHardwareStatusClosing
닫는것

NdisHardwareStatusNotReady
준비가 안되었다.

OID_GEN_CO_MEDIA_SUPPORTED

다음의 시스템-정의된 값들의 적당한 서브셋으로 NIC이 지원하는 미디어 타입들의 완전한 목록

NdisMedium802_3
Ethernet (802.3)

NdisMedium802_5
Token Ring (802.5)

NdisMediumFddi
FDDI

NdisMediumWan
WAN

NdisMediumLocalTalk
LocalTalk

NdisMediumDix
DEC/Intel/Xerox (DIX) Ethernet

NdisMediumArcnetRaw
ARCNET (raw)

NdisMediumArcnet878_2
ARCNET (878.2)

NdisMediumWirelessWan
Various types of NdisWirelessXxx media

NdisMediumAtm
ATM

NdisMediumIrda
윈도우 2000 플랫퐁에 미래 사용을위해 예약되었다.

ATM네트워크들을 위한 LAN 에뮬레이션 드라이버는 NdisMediumAtm보다 오히려 NdisMedium802_3 나 NdisMedium802_5로서 미디엄을 선언한다. 그런 드라이버는 상위 레벨 NDIS 드라이버들에게 이더넷이나 토큰링을 에뮬레이트하낟. ATM 포럼들의 LANE로 컴파일하고 UNI 시그널 지원을 제공한다.

무선-WAN NIC 드라이버는 NdisMediumWirelessWan로 그것의 미디엄 타입을 보고해야한다. 그러나, 그런 미니포트는 또한 이 포맷을 선택하는 바운드 프로토콜에서 NdisWWDIXEthernetFrames 헤더 포맷을 지원해야한다. 그리고 미니포토는 물론 NIC의 본래 헤더 포맷을 제공할 수 있다. 존재하는 LAN기반의 프로토콜들을 지원하기위해서, 드라이버 개발자는 존재하는 프로토콜들에의해서 이해되는 폼으로 무선 NIC 본래 헤더 포맷들과 미디엄-스펙 정보를 변환하기위해서 NDIS 인터미디엇 드라이버를 제공할 수 있다.

만약 밑의 미니포트가 이 질의에 대해서 NULL을 리턴하거나 실험적인 미디어 타입이 사용된다면, 드라이버는 NdisMCoIndicateReceivePacket로 수신들을 지시해야한다.

OID_GEN_CO_MEDIA_IN_USE

약간이나 아니거나(NULL 필터라 불린다.) 다음의 모든것과 같이 정의된 NIC이 현재 지원하는 미디어 타입들의 완전한 목록.

NdisMedium802_3
Ethernet (802.3)

NdisMedium802_5
Token Ring (802.5)

NdisMediumFddi
FDDI

NdisMediumWan
WAN

NdisMediumLocalTalk
LocalTalk

NdisMediumDix
DIX

NdisMediumArcnetRaw
ARCNET (raw)

NdisMediumArcnet878_2
ARCNET (878.2)

NdisMediumWirelessWan
Various types of NdisWirelessXxx media.

NdisMediumAtm
ATM

밑의 미니포트는 이 질의에 대해서 NULL을 리턴하거나 실험적인 미디어 타입이 사용된다면, 드라이버는 NdisMCoIndicateReceivePacket로 수신들을 지시해야한다.

OID_GEN_CO_LINK_SPEED

이 OID는 다음과 같이 정의된 NDIS_CO_LINK_SPEED 구조체로서 포맷된 현재 전송과 수신 속도들을 리턴하라고 미니포트에게 요구한다. 


typedef struct _NDIS_CO_LINK_SPEED {

    ULONG  Outbound;

    ULONG  Inbound;

} NDIS_CO_LINK_SPEED, *PNDIS_CO_LINK_SPEED;

이 구조체의 멤버들은 다음의 정보를 포함한다.

Outbound
NIC의 현재 전송 속도. 측정의 유닛은 100bps이다. 그래서 10,000의 값은 10 Mbps의 하드웨어 비트율을 설명한다.

Inbound
NIC의 현재 수신 속도. 측정의 유닛은 100bps이다. 그래서 10,000의 값은 10 Mbps의 하드웨어 비트율을 설명한다.

OID_GEN_CO_VENDOR_ID

벤더는 특별한 NIC을 식별하기위해서 할당하는 하나의 바이트에에의해서 따르는 3바이트 IEEE-등록된 벤더 코드

IEEE 코든 벤더를 유일하게 식별하고 NIC 하드웨어 주소의 시작에서 보이는 3바이트와 같다.

IEEE-등록된 코드없는 벤더들은 값 0xFFFFFF을 사용해야한다.

OID_GEN_CO_VENDOR_DESCRIPTION

널 종료된 NIC을 설명하는 카운트된 문자열에 대한 포인터.

OID_GEN_CO_VENDOR_DRIVER_VERSION

NIC 드라이버의 벤더-할당된 버전 넘버.

리턴값의 하위순서 반은 마이너 버전을 상술하고 상위 순서 반은 메이저 버전을 상술한다.

OID_GEN_CO_DRIVER_VERSION

NIC 드라이버에의해서 사용에서 NDIS 버전. 상위 바이트는 메이저 버전 넘버이다. 그리고 하위 바이트는 마이너 버전 넘버이다.

OID_GEN_CO_PROTOCOL_OPTIONS

프로토콜 드라이버의 추가적인 특성들을 정의하는 비트매스크. 프로토콜은 그것의 특성들을 NDIS에게 알려준다. 특성들은 추가적으로 이득을 가진다. 만약 프로토콜 드라이버가 바인딩에서 그것의 플래그들을 셋하지 않는다면, NDIS는 그들이 모두 클리어한다고 가정한다.

다음의 플래그들은 현재 정의된다.:

NDIS_PROT_OPTION_ESTIMATED_LENGTH
패킷들은 이 프로토콜에서 정확한 값들대신에 패킷 크기의 가장 나쁜 경우 평가에서 지시될 수 있는 것을 지시한다.

NDIS_PROT_OPTION_NO_LOOPBACK
프로토콜은 바인딩에서 루프백 지원을 요구하지 않는다.

NDIS_PROT_OPTION_NO_RSVD_ON_RCVPKT
프로토콜은 지시된 수신 패킷들의 ProtocolReserved 섹션을 사용하지 않는다. 이것은 NDIS가 수신 패킷을 하나이상 프로토콜을 지시하는 것을 허용한다.

OID_GEN_CO_MAC_OPTIONS

이것은 예약된다.

OID_GEN_CO_MEDIA_CONNECT_STATUS

이 OID는 다음의 시스템-정의된 값들의 하나로서 네트워크에서 NIC의 연결 상태를 리턴하라고 미니포트에게 요구한다.

NdisMediaStateConnected
NdisMediaStateDisconnected

NIC 미니포트가 네트워크 연결이 손실되었다는것을 감지할 때, 그것은 NDIS_STATUS_MEDIA_DISCONNECT로 NdisMCoIndicateStatus을 호출해야한다. 연결이 재설정될 때, 그것은 NDIS_STATUS_MEDIA_CONNECT로 NdisMCoIndicateStatus 을 호출해야한다.

OID_GEN_CO_MINIMUM_LINK_SPEED

이 OID는 다음에 정의된 NDIS_CO_LINK_SPEED 구조체로서 포맷된 그것의 최소 전송과 수신 속도들을 리턴하라고 미니포트에게 요구한다. 


typedef struct _NDIS_CO_LINK_SPEED {

    ULONG  Outbound;

    ULONG  Inbound;

} NDIS_CO_LINK_SPEED, *PNDIS_CO_LINK_SPEED;

이 구조체의 멤버들은 다음의 정보를 포함한다.

Outbound
NIC의 최소 전송 속도. 측정의 유닛은 100bps이다. 그래서 10,000의 값은 10 Mbps의 하드웨어 비트율을 설명한다.

Inbound
NIC의 최소 수신 속도. 측정의 유닛은 100bps이다. 그래서 10,000의 값은 10 Mbps의 하드웨어 비트율을 설명한다.

OID_GEN_CO_SUPPORTED_GUIDS

이 OID는 타입 NDIS_GUID의 구조체의 배열을 리턴하라고 미니포트에게 설명한다. 배열에서 각각의 구조체는 미니포트가 NdisMCoIndicateStatus을 통해서 보낸 NDIS_STATUS 에서나 커스텀 OID에서 커스텀 GUID의 맵핑을 상술한다.

NDIS_GUID 구조체는 다음과 같이 정의된다. 


typedef struct _NDIS_GUID {

    GUID             Guid;

    union {

        NDIS_OID     Oid;

        NDIS_STATUS  Status;

    };

    ULONG            Size;

    ULONG            Flags;

} NDIS_GUID, *PNDIS_GUID;

이 구조체의 멤버들은 다음의 정보를 포함한다.

Guid
미니포트에 대해서 정의된 커스텀 GUID

Oid
Guid가 맵한 커스텀 OID

Status
Guid가 맵한 NDIS_STATUS

Size
NDIS_GUID_ARRAY 플래그가 셋된다면, Size는 미니포트에의해서 리턴된 배열에서 각각의 데이터 아이템의 바이트 크기를 상술한다. 만약 NDIS_GUID_ANSI_STRING 나 NDIS_GUID_NDIS_STRING 플래그가 셋된다면, Size 는 -1로 셋된다. 그렇지 않다면, Size 는 GUID가 설명하는 데이터 아이템의 바이트 크기를 상술한다.

Flags
다음의 Flags 는 GUID가 OID로 맵할지 NDIS_STATUS 문자열로 맵할지를 지시하는데 서로 OR될 수 있다. 그리고 GUID에 대해서 제공된 데이터 타입을 지시하는데 서로 OR될 수 있다.:

NDIS_GUID_TO_OID
셋될 때, NDIS_GUID 구조체는 GUID를 OID로 맵하는 것을 지시한다.

NDIS_GUID_TO_STATUS
셋될 때, NDIS_GUID 구조체는 GUID를 NDIS_STATUS 문자열로 맵하는 것을 지시한다.

NDIS_GUID_ANSI_STRING
셋될 때, 0 종료 ANSI 문자열은 GUID에 대해서 제공된다.

NDIS_GUID_UNICODE_STRING
셋될 때, UNICODE 문자열은 GUID에 대해서 제공된다.

NDIS_GUID_ARRAY
셋될 때, 데이터 아이템들의 배열은 GUID에 대해서 제공되는 것을 지시한다. 상술된 크기는 배열에서 각각의 데이터 아이템의 길이를 지시한다.

다음의 예에서, NDIS_GUID 구조체는 GUID 을 OID_GEN_CO_RCV_PDUS_NO_BUFFER로 맵한다.: 


NDIS_GUID NdisGuid =    {{0x0a214809, 0xe35f, 0x11d0, 0x96, 0x92, 0x00,

                       0xc0, 0x4f, 0xc3, 0x35, 0x8c},

                       GUID_NDIS_GEN_CO_RCV_PDUS_NO_BUFFER,

                       OID_GEN_CO_RCV_PDUS_NO_BUFFER,

                       4,

                       fNDIS_GUID_TO_OID};

GUID는 정보를 셋하거나 얻기웅해서 WMI에의해서 사용된 식별자이다. NDIS는 NDIS 드라이버에서 WMI에의해서 보내진 GUID를 가로채고 GUID를 OID로 맵한다. 그리고 OID를 드라이버에게 보낸다. 드라이버는 NDIS에게 데이타 아이템들을 리턴한다. 그때 WMI에게 데이터를 리턴한다.

NDIS는 또한 WMI에의해서 인식된 GUID들에서 NIC 상태에서 변화들을 번역한다. 미니포트가 NdisMCoIndicateStatus로 NIC 상태에서 변화를 보고할 때, NDIS는 NDIS가 WMI에게 보낸 GUID에서 미니포트에의해서 지시된 NDIS_STATUS 을 번역한다.

연결-지향 미니포트가 커스텀 GUID들을 지원한다면, 그것은 OID_GEN_CO_SUPPORTED_GUIDS을 지원해야하고 OID_GEN_CO_SUPPORTED_GUIDS,은 커스텀 GUID들이 커스텀 OID들이나 NDIS_STATUS 문자열로 맵핑을 NDIS에게 리턴한다. OID_GEN_CO_SUPPORTED_GUIDS로 미니포트에게 질의한 후에, NDIS는 WMI로 미니포트의 커스텀 GUID들을 등록한다.

OID_GEN_CO_GET_TIME_CAPS

이 OID는 다음과 같이 정의된 GEN_GET_TIME_CAPS 구조체로서 포맷된 NIC의 로컬 시간을 보고하는 것에 대해서 그것의 능력을 리턴하라고 미니포트에게 요구한다. 


typedef struct _GEN_GET_TIME_CAPS {

    ULONG Flags;

    ULONG ClockPrecision;

} GEN_GET_TIME_CAPS, *PGEN_GET_TIME_CAPS;

이 구조체의 멤버들은 다음의 정보를 포함한다.

Flags
다음의 플래그들은 서로 OR 된다. 모든 상술되지 않은 플래그들은 0으로 셋되어야한다.

READABLE_LOCAL_CLOCK

셋될 때, NIC에서 읽을 수 있는 클럭의 시점을 지시한다. 그런 하드웨어 클럭없이, 미니포트는 ClockPrecision 멤버에서 올바른 정도를 보고하는 동안 NdisGetCurrentSystemTime을 호출함으로서 시스템 클럭을 사용할 수 있다.

CLOCK_NETWORK_DERIVED

셋될 때, NIC의 로컬 시간은 자유롭게 가동하는 온보드 클럭에 반대로 네트워크 연결로부터 상속된다는 것을 지시한다.

CLOCK_PRECISION
셋될 때, ClockPrecision 멤버는 유효한 정보를 포함한다는 것을 지시한다.

RECEIVE_TIME_INDICATION_CAPABLE

셋될 때, NIC 하드웨어는 수신된 PDU의 처음 셀을 받는 로컬 시간을 주목할 수 있고 미니포트는 패킷을 프로토콜에게 지시할 때 각각의 PDU에 대한 수신 시간을 전달하는 것을 지시한다.

TIMED_SEND_CAPABLE
셋될 때, NIC은 로컬 시간에 때라 전송에 대한 패킷을 스케쥴할 수 있다는 것을 지시한다. 프로토콜들은 패킷 설명자의 OOB 데이터 블럭에서 TimeToSend 타입스템프를 셋하기위해서 NDIS_SET_PACKET_TIME_TO_SEND 을 사용할 수 있다.

TIME_STAMP_CAPABLE
셋될 때, NIC은 패킷의 처음 바이트가 전송된 때를 (나가는 패킷의 적당한 필트에서) 스템프할 수 있고 NIC이 인바운드 패킷의 같은 필드로부터 시간을 가져올 수 있다는 것을 지시한다.

ClockPrecision
밀리어당 파트들에서 클럭 정도를 상술한다. 유효성르 고려되는 정보에 대해서, CLOCK_PRECISION 플래그가 셋되어야한다.

미니포트는 로컬이나 네트워크 클럭의 부재에서 어떤 타이밍 인자들에 대한 지원을 제공한다. 특별히, 미니포트는 수신 시간 지시들, 타임된 보내기, 타임 스템핑에 대해서 시스템 클럭을 사용할 수 있다. NIC 기반 클럭은 더 높은 정도를 제공하고 시스템 클럭보다 더 낮은 지연으로 접근할 수 있기때문에 더 좋다. 모든 경우에서, 미니포트는 그것이 사용한 클럭의 정도를 상술해야한다. 이것은 미니포트들의 타이밍 지원을 사용을 최대화하는 법을 결정하는 것을 프로토콜에게 허용한다.

만약 미니포트가 읽을 수 있는 클럭의 존재를 보고한다면, 그것은 OID_GEN_GET_NETCARD_TIME 질의의 응답으로 즉시 준비되어야 한다. 이호출에서 미니포트의 응답은 타임-크리티컥이고 그래서 동기화되어야한다.

OID_GEN_CO_GET_NETCARD_TIME

이 OID는 네트워크로부터나 NIC에서 클럭으로부터 상술된 것 같이 NIC의 로콜 시간을 리턴하라고 미니포트에게 요구한다. 이 시간은 다음에 정의된 것같이 GEN_GET_NETCARD_TIME 구조체로서 포맷된다. 


typedef struct _GEN_GET_NETCARD_TIME {

    ULONGLONG ReadTime;

} GEN_GET_NETCARD_TIME, *PGEN_GET_NETCARD_TIME;

이 구조체의 멤버는 다음의 정보를 포함한다.

ReadTime
NIC의 로컬 시간

미니포트가 전의 OID_GEN_CO_GET_TIME_CAPS 질의에 대한 응답을 리턴했던 GEN_GET_TIME_CAPS 구조체의 ClockPrecision 엘리먼트에서 그것의 로컬 시간에 대한 유닛들을 상술했다.

만약 미니포트가 OID_GEN_CO_GET_TIME_CAPS 질의 대한 응답으로 READABLE_LOCAL_CLOCK 플래그를 셋한다면, NIC은 온보드 클럭으로부터 그것의 로컬 시간을 상속한다. 만약 미니포트가 OID_GEN_CO_GET_TIME_CAPS 질의에 대한 응답에서 CLOCK_NETWORK_DERIVED 플래그를 셋한다면, NIC은 네트워크로부터 그것의 로컬 시간을 상속한다.

만약 로컬 시간이 온보드 클럭으로부터 상속된다면, 미니포트는 밀리언당 파트들에서 클럭 정도를 보고할 수 있어야한다. 일반적으로, 네트워크-상속된 클럭은 더 좋다. 이유는 그것은 더 정밀하고 같은 네트워크나 스위치에 접근된 많은 머신들을 동기화하는데 사용될 수 있다.

미니포트는 OID_GEN_CO_GET_NETCARD_TIME 질의에 대한 응답에서 동기적으로 로컬 시간을 리턴해얗나다. 이 질이는 NIC의 로컬 시간으로 프로토콜 드라이버들을 동기화한다. 프로토콜 드라이버들은 응답-시간 지연들을 필터하는데 성공에서 여러번 OID_GEN_CO_GET_NETCARD_TIME 질의를 보내야한다.