8.2 CoNDIS WAN Objects

다음의 차트는 CoNDIS WAN 미니포트 드라이버들을 위해 사용되는 특성들을 설정하거나 얻는데 사용되는 OID들을 요약한 것이다.

Length	Q	S	Name
16	M		OID_WAN_CO_GET_INFO 가상 연결들(VCs)에 대한 정보를 얻는다.
32	M		OID_WAN_CO_GET_LINK_INFO VC에 대한 정보를 얻는다.
32		M	OID_WAN_CO_SET_LINK_INFO VC에 대한 정보를 설정한다.
80 to 88	O		OID_WAN_CO_GET_COMP_INFO VC에 대한 압축 정보를 얻는다.
80 to 88		O	OID_WAN_CO_SET_COMP_INFO VC에 대한 압축 정보를 설정한다.
56	O		OID_WAN_CO_GET_STATS_INFO VC에 대한 통계 정보를 얻는다.

다음의 주제들은 CoNDIS WAN 미니포트 드라이버들을 위해 사용되는 특성들을 설정하거나 얻는데 사용되는 OID들을 설명한다.

OID_WAN_CO_GET_INFO

이 OID는 미니포트 드라이버에게 그것의 NIC에서 모든 가상 연결들(VCs)에 적용되는 정보를 리턴할 것을 요구한다. 이 정보는 NDIS_WAN_CO_INFO 구조체로 리턴되고, 다음과 같이 정의된다.

typedef struct _NDIS_WAN_CO_INFO { OUT ULONG MaxFrameSize; OUT ULONG MaxSendWindow; OUT ULONG FramingBits; OUT ULONG DesiredACCM; } NDIS_WAN_CO_INFO, *PNDIS_WAN_CO_INFO;

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

MaxFrameSize

NIC 미니포트 드라이버가 보내거나 받을 수 있는 어떤 망 패킷에 대한 최대 프래임 크기를 나타낸다. 이 값은 드라이버의 독자적인 프레이밍 오버헤드 그리고/또는 PPP HDLC 오버헤드는 제외되어야 한다. 전형적으로 이 값은 약 1500 이다.

그러나, 모든 CoNDIS WAN 미니포트 드라이버들은 이 OID를 위해 리턴한 값보다 32 바이트가 더 큰 내부 MaxFrameSize를 사용해야 한다. 예를 들어, 이 OID를 위해 1500을 리턴한 CoNDIS WAN 미니포트 드라이버는 내부적으로 1532를 보내거나 받아야 한다. 이런 미니포트 드라이버는 미래의 브리지되고 추가된 프로토콜들을 곧바로 지원할 수 있다.

MaxSendWindow

CoNDIS WAN 미니포트 드라이버가 VC에서 다룰 수 있는 처리되지 않은 패킷들의 최대 갯수를 나타낸다.

NDISWAN 드라이버는 이 멤버의 값을 NDISWAN이 전송 패킷들을 수용하기 전에 얼마나 많은 send 요청을 그 미니포드 드라이버의 MiniportCoSendPackets 함수에게 전달할지를 결정하는 제한하는 값으로 사용한다. 이러한 패킷들은 미니포트 드라이버가 처리되지 않은 전송을 완전히 처리할 때까지 큐에 저장된다. 미니포트 드라이버는 이 값을 동적으로 조절할 수 있고 NdisMCoIndicateStatus에게 전달하는 WAN_CO_LINKPARAMS 구조체에서 VC 당 SendWindow 멤버가 사용하는 기준을 조절할 수 있다. NDISWAN은 현재의 SendWindow 값을 처리되지 않은 send들에서 그것의 제한 값으로 사용된다. 만약 미니포트 드라이버가 SendWindow를 0으로 설정했다면, NDISWAN은 개별적인 VC를 위한 패킷 전송을 중단해야 한다. 그것은 미니포트 드라이버가 전송 윈도우가 닫혔음을 나타내는 것이고, 결과적으로, NDISWAN으로부터 어떠한 패킷들도 받을 수 없음을 나타낸다.

CoNDIS WAN 미니포트 드라이버는 내부적으로 패킷들을 저장해야 하기때문에, MaxSendWindow의 값은 이론적으로 max(ULONG)이다. 그러나, 이 드라이버가 결정한 값은 링크 속도와 NIC의 하드웨어 능력들을 반영해야 한다. 예를 들어, 미니포트 드라이버의 NIC이 항상 적어도 네개의 패킷을 위한 공간을 가지고 있다면, 미니포트 드라이버는 MaxSendWindow를 4로 설정하여 MiniportCoSendPackets에게 들어오는 어떤 패킷이 즉시 하드웨어에 위치하도록 할 수 있다.

FramingBits

미니포트 드라이버가 지원하는 프레이밍의 타입들을 나타내는 비트마스크를 나타내는 32-비트 값. 미니포트 드라이버는 다음의 값들을 조합하여 나타낼 수 있는데, 2진 OR 연산자를 사용한다.

RAS_FRAMING

만약 미니포트 드라이버가 더 오래된 RAS 프레이밍을 발견할 수 있을 때에만 설정한다. 단지 초기의 RAS 프레이밍을 지원했던 과거의 드라이버들만이 이 플래그를 설정한다.

RAS_COMPRESSION

만약 미니포트 드라이버가 더 오래된 RAS 압축 체계를 지원할 때에만 설정한다.

PPP_FRAMING

항상 설정되어었어야 한다. 미니포트 드라이버가 그것의 미디엄 타입을 위해 PPP 프레이밍을 지원하거나 발견할 수 있음을 지시한다. 만약 미니포트 드라이버가 PPP 주소와 제어-영역 압축을 지원한다면 설정한다.

NdiSWAN은 만약 이 LCP 옵션이 결정된다면 그 주소와 제어 영역을 제거할 것이다. X.25와 같은 어떤 WAN 미디엄 타입들은 이 옵션을 지원하지 않는다.

PPP_COMPRESS_PROTOCOL_FIELD

만약 미니포트 드라이버가 PPP 프로토콜 영역 압축을 지원한다면 설정한다.

NDISWAN은 이 LCP 옵션이 결정된다면, 적절한 시기에 프로토콜 영역에서 한 바이트를 제거할 것이다.

PPP_ACCM_SUPPORTED

만약 미니포트 드라이버가 비동기 제어 특성 맵핑을 지원한다면 설정한다. 이 비트는 단지 모뎀과 같은 비동기 매체에 대해서만 유효하다. 만약 이 비트가 설정된다면 DesiredACCM 멤버는 유효하다.

PPP_MULTILINK_FRAMING

만약 미니포트 드라이버가 IETF RFC 1717에 설명된 다중링크 프레이밍을 지원한다면 설정한다.

PPP_SHORT_SEQUENCE_HDR_FORMAT

만약 미니포트 드라이버가 IETF RFC 1717에 설명된 다중링크 프레이밍을 위한 헤더 포멧을 지원한다면 설정한다.

SLIP_FRAMING

만약 미니포트 드라이버가 SLIP 프레이밍(비동기 미니포트 드라이버들에서만)을 발견할 수 있거나 지원할 수 있다면 설정한다.

SLIP_VJ_COMPRESSION

만약 미니포트 드라이버가 SLIP를 위해 Van Jacobsen TCP/IP 헤더 압축을 지원할 수 있다면 설정한다. NDISWAN은 SLIP_VJ_COMPRESSION( 16 슬롯을 가지고 )을 지원한다. SLIP 프레이밍을 지원하는 비동기 매체( 직렬 미니포트 드라이버들)는 이 비트를 설정한다.

비동기 매체는 VJ 헤더 압축을 지원하기 위해 어떤 코드를 쓸 필요가 없다. NDISWAN이 그것을 맡아 처리할 것이다.

SLIP_VJ_AUTODETECT

만약 미니포트 드라이버가 SLIP를 위해 Van Jacobsen TCP/IP 헤더 압축을 자동 검출할 수 있다면 설정한다. NDISWAN은 VJ 헤더 압축을 자동 검출할 것이다. 비동기 매체( 직렬 미니포트 드라이버들 )가 SLIP 프레이밍을 지원한다면 이 비트를 설정한다.

TAPI_PROVIDER

만약 미니포트 드라이버가 TAPI 서비스 공급자 OID들을 지원한다면 설정한다. 만약 이 비트가 설정되지 않았다면, TAPI OID 호출들은 미니포트 드라이버에 의해 만들어지지 않을 것이다.

MEDIA_NRZ_ENCODING

만약 미니포트 드라이버가 ISDN과 같은 어떤 매체 타입을 위한 PPP 디폴트, NRZ 부호화를 지원한다면 설정한다. 이 값은 미래의 사용을 위해 예약되었다.

MEDIA_NRZI_ENCODING

만약 미니포트 드라이버가 NRZI 부호화를 지원한다면 설정한다. 이 값은 미래의 사용을 위해 예약되었다.

MEDIA_NLPID

만약 미니포트 드라이버가 그것의 프레임에서 NLPID를 가지고 있고 설정할 수 있다면 설정한다. 이 값은 미래의 사용을 위해 예약되었다.

RFC_1356_FRAMING

만약 미니포트 드라이버가 IETF RFC 1356 X.25와 ISDN 프레이밍을 지원한다면 설정한다. 이 값은 미래의 사용을 위해 예약되었다.

RFC_1483_FRAMING

만약 미니포트 드라이버가 IETF RFC 1483 ATM adaption layer-5 캡슐화를 지원한다면 설정한다. 이 값은 미래의 사용을 위해 예약되었다.

RFC_1490_FRAMING

만약 미니포트 드라이버가 IETF RFC 1490 프레임 지연 프레이밍을 지원한다면 설정한다. 이 값은 미래의 사용을 위해 예약되었다.

NBF_PRESERVE_MAC_ADDRESS

만약 미니포트 드라이버가 "The PPP NETBIOS Frames Contol Protocol (NBFCP)" 초안에 설명된 IETF 프레이밍을 지원한다면 설정한다.

SHIVA_FRAMING

NBF_PRESERVE_MAC_ADDRESS에 의해 대체되었다.

PASS_THROUGH_MODE

만약 미니포트 드라이버가 자기 소유의 프레이밍을 수행하면 설정한다. 만약 이 플레그가 설정되면, NDISWAN은 프레임들을 해석하거나 수정하지 않고 통과시킨다.

NIC 미니포트 드라이버들은 각 미니포트 드라이버가 OID_WAN_CO_SET_LINK_INFO 요구를 받을때까지 디폴트 PPP 프레이밍 모드에 있어야 한다. 그 NIC 미니포트 드라이버는 지원할 것을 요구하는 어떤 프레이밍을 자동 검출해야 한다.

예를 들어, 예전 RAS 프레이밍을 지원하는 미니포트 드라이버들은 PPP 프레이밍으로부터 RAS 프레이밍을 자동 검출해야 한다. 만약 미니포트 드라이버가 디폴트보다 다른 프레이밍 체계를 검출했다면, 그 미니포트 드라이버는 자동적으로 자신의 프레이밍에서 새롭게 검출된 프레이밍으로 변경한다.

OID_WAN_CO_GET_LINK_INFO를 가진 다음에 이어지는 요구는 검출된 프레이밍을 지시한다. 만약 프레이밍이 아직 발견되지 않았다면, FramingBits는 리턴된 NDIS_WAN_CO_GET_LINK_INFO 정보에서 0으로 설정된다.

만약 WAN 미니포트 드라이버가 FramingBits 멤버가 0으로 설정된 OID_WAN_CO_SET_LINK_INFO를 가지고 다음에 호출된다면, 미니포트 드라이버는 각 프레임의 수용에서 그 프레이밍을 자동으로 검출하기 위한 시도를 할 것이다.

DesiredACCM

비동기 제어 특성 맵이 결정된다. 이 멤버는 단지 비동기 매체 타입들과 관련이 있다.

OID_WAN_CO_GET_LINK_INFO

이 OID는 미니포트 드라이버에게 가상 연결(VC)의 현재 상태에 대한 PPP 프레이밍 정보를 리턴할 것을 요구한다.

이 정보는 NDIS_WAN_CO_GET_LINK_INFO 구조체로 리턴되는데, 그 구조체는 다음과 같이 정의된다.

typedef struct _NDIS_WAN_CO_GET_LINK_INFO { OUT ULONG MaxSendFrameSize; OUT ULONG MaxRecvFrameSize; OUT ULONG SendFramingBits; OUT ULONG RecvFramingBits; OUT ULONG SendCompressionBits; OUT ULONG RecvCompressionBits; OUT ULONG SendACCM; OUT ULONG RecvACCM; } NDIS_WAN_CO_GET_LINK_INFO, *PNDIS_WAN_CO_GET_LINK_INFO;

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

MaxSendFrameSize

미니포트 드라이버가 이 VC에서 전송을 위해 받을 수 있는 바이트 단위의 최대 버퍼 크기를 나타낸다. 미니포트 드라이버의 MiniportCoSendPackets 함수는 이 크기보다 더 큰 어떤 들어오는 전송 패킷을 거절할 수 있다.

MaxRecvFrameSize

네트워크로부터 받게 될 가장 큰 패킷을 나타낸다. 미니포트 드라이버는 이보다 더 큰 패킷들을 버릴 수 있다.

SendFramingBits

보내져야 할 프레이밍의 타입을 지시하는 송신-프레이밍 비트들을 나타낸다. 만약 미니포트 드라이버가 SendFramingBits와 RecvFramingBits 사이에서 비호환성을 발견했다면, 그것은 NDIS_STATUS_INVALID_WAN_SETTINGS을 리턴한다.

프레이밍 비트가 적당한 어떤 경우에 대해서 적절한 NLPID와 프레이밍 포맷 사용된다.

RecvFramingBits

수신되어야 할 프레임의 타입을 지시하는 수신-프레이밍 비트들을 나타낸다.

SendCompressionBits

예약됨.

RecvCompressionBits

예약됨.

SendACCM

비동기 매체 타입들에 대해서, 논리 비트 0-31은 각각의 바이트가 채워져야 함을 지시한다. 그것은, 만약 비트 0이 1로 설정되었다면, 그때 ASCII 문자 0x00은 채워진 바이트가 되어야 한다, 기타 등등.

RecvACCM

SendACCM에 대해 설명한 것과 같다.

SendFramingBits와 RecvFramingBits를 위한 가능한 값들은 OID_WAN_CO_GET_INFO 요구에 대한 응답으로 리턴된 어떤 드라이버를 포함한다.

OID_WAN_CO_SET_LINK_INFO

이 OID는 미니포트 드라이버에게 정해진 가상 연결(VC)에 대한 PPP 프레이밍 정보를 설정할 것을 요구한다. 프로토콜은 이 PPP 프레이밍 정보를 지시하기 위해 NDIS_WAN_CO_SET_LINK_INFO 구조체를 사용하는데, 그 구조체는 다음과 같이 정의된다:

typedef struct _NDIS_WAN_CO_SET_LINK_INFO { IN ULONG MaxSendFrameSize; IN ULONG MaxRecvFrameSize; IN ULONG SendFramingBits; IN ULONG RecvFramingBits; IN ULONG SendCompressionBits; IN ULONG RecvCompressionBits; IN ULONG SendACCM; IN ULONG RecvACCM; } NDIS_WAN_CO_SET_LINK_INFO, *PNDIS_WAN_CO_SET_LINK_INFO;

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

MaxSendFrameSize

프로토콜이 이 VC를 위하여 보낼 바이트 단위의 가장 큰 버퍼를 나타낸다. 이 값은 OID_WAN_CO_GET_LINK_INFO 요구에 대해서 미니포트 드라이버가 리턴하는 값과 같거나 작아야 한다.

미니포트 드라이버의 MiniportCoSendPackets 함수는 이 값보다 더 크고 이 링크에 종속된 어떤 전송 패킷들을 거절할 수 있다.

MaxRecvFrameSize

프로토콜이 다음에 이어서 수신할 가장 큰 네트워크 패킷을 나타낸다. 이 값은 OID_WAN_CO_GET_LINK_INFO 요구에 대해서 미니포트 드라이버가 리턴하는 값과 같거나 작아야 한다. 미니포트 드라이버는 이 값보다 크고 이 VC를 위한 수신된 어떤 패킷들을 버릴 수 있다.

SendFramingBits

전송되어야 할 프레이밍의 타입을 지시하는 전송-프레이밍 비트들을 나타낸다. 만약 미니포트 드라이버가 SendFramingBits와 RecvFramingBits 사이에서 비호환성을 발견하면, NDIS_STATUS_INVALID_WAN_SETTINGS를 리턴한다.

프레이밍 비트가 적당한 어떤 경우에 대해서 적절한 NLPID와 프레이밍 포맷 사용된다.

RecvFramingBits

수신되어야 할 프레임의 타입을 지시하는 수신-프레이밍 비트들을 나타낸다.

SendCompressionBits

예약됨.

RecvCompressionBits

예약됨.

SendACCM

비동기 매체 타입들에 대해서, 논리 비트 0-31은 각각의 바이트가 채워져야 함을 지시한다. 그것은, 만약 비트 0이 1로 설정되었다면, 그때 ASCII 문자 0x00은 채워진 바이트가 되어야 한다, 기타 등등.

RecvACCM

SendACCM에 대해 설명한 것과 같다.

SendFramingBits와 RecvFramingBits를 위한 가능한 값들은 OID_WAN_CO_GET_INFO 요구에 대한 응답으로 리턴된 어떤 하위 드라이버를 포함한다.

OID_WAN_CO_GET_COMP_INFO

이 OID는 미니포트 드라이버에게 NIC이나 그것의 드라이버의 능력에 대한 정보를 리턴할 것을 요구하는데, 특히 압축을 지원하는지에 대한 정보를 요구한다. 만약 그렇게 된다면, 리턴된 그 값들은 점대점 프로토콜(PPP) 압축 제어 프로토콜과 압축에 대해 협상을 하는데 사용된다. 그 프로토콜은 다음으로 OID_WAN_CO_SET_COMP_INFO 요구에 대해 PPP 압축 체계를 협상한다. 이 압축 정보는 가상 연결(VC)에 대해 정해진 것이다.

압축 정보는 NDIS_WAN_CO_GET_COMP_INFO 구조체로 리턴되는데, 다음과 같이 정의된다.

typedef struct _NDIS_WAN_CO_GET_COMP_INFO { OUT NDIS_WAN_COMPRESS_INFO SendCapabilities; OUT NDIS_WAN_COMPRESS_INFO RecvCapabilities; } NDIS_WAN_CO_GET_COMP_INFO, *PNDIS_WAN_CO_GET_COMP_INFO;

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

SendCapabilities

데이터를 전송하는 동안 압축 능력들에서 정보를 포함하는 구조체를 나타낸다.

RecvCapabilities

데이터를 수신하는 동안 압축 능력들에서 정보를 포함하는 구조체를 나타낸다.

NDIS_WAN_COMPRESS_INFO 구조체 확인을 위해서는 OID_WAN_GET_COMP_INFO를 봐라.

OID_WAN_CO_SET_COMP_INFO

이 OID는 미니포트 드라이버에게 PPP 압축 체계를 알리는데 이 압축 체계는 미니포트 드리이버가 OID_WAN_CO_GET_COMP_INFO 요구에 대한 응답으로 이미 정보를 리턴해 주었던 프로토콜에 의해서 선택된 것이다. 이 PPP 압축 체계는 가성 연결(VC)에 대해 정해진 것이다.

프로토콜은 PPP 압축 체계에 대한 스팩(specification)를 공급하는데 그것은 NDIS_WAN_CO_SET_COMP_INFO 구조체에서 선택된 것으로, 다음과 같이 정의된다.

typedef struct _NDIS_WAN_CO_SET_COMP_INFO { IN NDIS_WAN_COMPRESS_INFO SendCapabilities; IN NDIS_WAN_COMPRESS_INFO RecvCapabilities; } NDIS_WAN_CO_SET_COMP_INFO, *PNDIS_WAN_CO_SET_COMP_INFO;

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

SendCapabilities

데이터를 전송하는 동안 압축 능력들에서 정보를 포함하는 구조체를 나타낸다.

RecvCapabilities

데이터를 수신하는 동안 압축 능력들에서 정보를 포함하는 구조체를 나타낸다.

NDIS_WAN_COMPRESS_INFO 구조체 확인을 위해서는 OID_WAN_GET_COMP_INFO를 봐라.

OID_WAN_CO_GET_STATS_INFO

이 OID는 미니포트 드라이버에게 가상 연결(VC)에 대해 정해진 통계 정보를 리턴할 것을 요구한다. WAN NIC 미니포트 드라이버는 NDIS_WAN_CO_GET_STATS_INFO 구조체에서 이 OID를 위한 이러한 통계를 리턴하고 유지하는 것이 요구되는데, 그 구조체는 다음과 같이 정의된다:

typedef struct _NDIS_WAN_CO_GET_STATS_INFO { OUT ULONG BytesSent; OUT ULONG BytesRcvd; OUT ULONG FramesSent; OUT ULONG FramesRcvd; OUT ULONG CRCErrors; OUT ULONG TimeoutErrors; OUT ULONG AlignmentErrors; OUT ULONG SerialOverrunErrors; OUT ULONG FramingErrors; OUT ULONG BufferOverrunErrors; OUT ULONG BytesTransmittedUncompressed; OUT ULONG BytesReceivedUncompressed; OUT ULONG BytesTransmittedCompressed; OUT ULONG BytesReceivedCompressed; } NDIS_WAN_CO_GET_STATS_INFO, *PNDIS_WAN_CO_GET_STATS_INFO;

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

BytesSent

전송된 바이트 수를 나타낸다.

BytesRcvd

수신된 바이트 수를 나타낸다.

FramesSent

보내진 프레임(WAN 패킷) 갯수를 나타낸다.

FramesRcvd

받은 프레임 갯수를 나타낸다.

CRCErrors

이 VC에 대해 직면한 CRC 에러 갯수를 나타낸다. CRC 에러들은 주기적 여분 체크의 실패에 의해 발생되는 것이다. CRC 에러는 수신된 프레임내에 있는 하나 혹은 그 이상의 바이트들이 도착에서 변경되었음을 지시한다.

TimeoutErrors

이 VC에 대해 직면한 타임아웃 에러 갯수를 나타낸다. 타임아웃 에러는 예상한 바이트가 제시간에 수신되지 않았을때 발생한다.

AlignmentErrors

이 VC에 대해 직면한 정렬 에러 갯수를 나타낸다. 정렬 에러는 수신된 바이트가 예상한 바이트와 차이가 있을때 발생한다. 이것은 일반적으로 바이트가 손실되거나 타임아웃 에러가 발생했을때 나타난다.

SerialOverrunErrors

이 VC에 대해 직면한 직렬 초과 갯수를 나타낸다. 직렬 초과는 WAN NIC이 데이터가 수신될 때 그 수신률을 조정할 수 없을 때 발생한다.

FramingErrors

이 VC에 대해 직면한 프레이밍 에러 갯수를 나타낸다. 프레이밍 에러는 비동기 바이트가 유효하지 않은 시작 비트 또는 끝 비트를 가지고 도착했을때 발생한다.

BufferOverrunErrors

이 VC에 대해 직면한 버퍼 초과 갯수를 나타낸다. 버퍼 초과는 WAN NIC 미니포트 드라이버가 데이터가 수신될 때 그 수신률을 조정할 수 없을 때 발생한다.

BytesTransmittedUncompressed

압축이 안되어 전송된 데이터의 바이트 수를 나타낸다. 미니포트 드라이버는 만약 압축을 지원한다면 0이 아닌 값을 리턴한다.

BytesReceivedUncompressed

압축이 안되어 수신된 데이터의 바이트 수를 나타낸다. 미니포트 드라이버는 만약 압축을 지원한다면 0이 아닌 값을 리턴한다.

BytesTransmittedCompressed

압축되어 전송된 데이터의 바이트 수를 나타낸다. 미니포트 드라이버는 만약 압축을 지원한다면 0이 아닌 값을 리턴한다.

BytesReceivedCompressed

압축되어 수신된 데이터의 바이트 수를 나타낸다. 미니포트 드라이버는 만약 압축을 지원한다면 0이 아닌 값을 리턴한다.

만약 하위 드라이버나 그것의 NIC이 압축을 지원하지 않는다면, 그 드라이버는 그 바이트들에 대하여 0을 리턴한다..압축된/압축하지 않은 멤버들.