NDIS_WAN_LINE_UP

typedef struct _NDIS_WAN_LINE_UP {

    IN ULONG             LinkSpeed;

    IN ULONG             MaximumTotalSize;

    IN NDIS_WAN_QUALITY  Quality;

    IN USHORT            SendWindow;

    IN UCHAR             RemoteAddress[6];

    IN OUT UCHAR         LocalAddress[6];

    IN ULONG             ProtocolBufferLength;

    IN PUCHAR            ProtocolBuffer;

    IN USHORT            ProtocolType;

    IN OUT NDIS_STRING   DeviceName;

} NDIS_WAN_LINE_UP, *PNDIS_WAN_LINE_UP;

NDIS_WAN_LINE_UP 구조체는 line-up 인디케이션과 관련된 정보를 포함한다.

멤버

LinkSpeed
100bps 단위로 링크의 속도를 지정한다. 0은 프로토콜이 OID_GEN_LINK_SPEED로 NdisRequest 함수를 호출할 때 리턴된 속도로부터 변화가 없다는 것을 가리킨다.

MaximumTotalSize
프로토콜이 네트워크을 통해 보낼 수 있는 패킷 당 최대 바이트 수를 지정한다. 0은 프로토콜이 OID_GEN_MAXIMUM_TOTAL_SIZE로 NdisRequest 함수를 호출할 때 리턴된 값으로부터 변화가 없다는 것을 가리킨다.

Quality
새로운 라인의 QoS(Quality of Service)를 지정한다.

SendWindow
이러한 링크를 위해 다루는 발생한 보내기 패킷들에 대한 효율적인 제한인 아래 WAN NIC 드라이버의 보내기 윈도우를 지정한다. MiniportWanSend 함수에 이러한 이러한 수의 패킷들을 제출한 후, NDISWAN은 드라이버는 발생한 보내가 완성될 때까지 들어오는 보내기들을 큐에 저장해서 유지할 것이다.

RemoteAddress
Ethernet 포맷에서 링크에서 리모트 노드의 주소를 표현한다. NDISWAN은 이러한 값을 제공한다.

LocalAddress
Ethernet 스타일 포맷에서 이러한 링크에서 인디케이션들을 위한 프로토콜 결정 컨텍스트를 표현한다. NDISWAN은 자기 자신을 위해 두개의 상위 순서 바이트를 보존한다.(reserves) 프로토콜은 그후 ProtocolReceive와 ProtocolStatus 함수들에서 이러한 링크를 위해 입력 매개변수가 되어야 하는 것에 대한 나머지를 설정해야 한다.

ProtocolBufferLength
ProtocolBuffer에서 Buffer에 대한 바이트 수를 지정한다.

ProtocolBuffer
NDISWAN에서 적당한 프로토콜들로의 연결들을 하는 상위 레벨 컴포넌트에 의해 제공된 프로토콜 특정 정보를 포함하는 NDISWAN에 의해 할당된 버퍼를 가리킨다. 예를 들어, 이러한 버퍼는 만약 목적지 프로토콜이 만약 타켓 프로토콜이 IPX이면 IP 혹은 IPX 네트워크 수이면 IP 주소를 포함할 것이다. NDISWAN은 타켓 프로토콜이 line-up 인디케이션으로부터 제어를 리턴할 때 이러한 버퍼를 해제한다.

ProtocolType
프로토콜의 할당된 ether 타입을 지정한다.

DeviceName
시스템 디폴트 문자 설정에서 카운트된 문자열로서 바인딩의 이름을 지정한다. 윈도우즈 이천 드라이버에서, 이러한 문자열은 Unicode 문자들을 포함한다. 이러한 문자열은 거의 64문자들이 될 수 있다.

주석

WAN 미니포트가 line-up 인디케이션으로 NdisMIndicateStatus 함수를 호출할 때, NDISWAN은 이러한 구조체로 포맷화된 관심 있는 프로토콜들에게 인디케이션을 포워드한다. 주어진 링크에서 초기의 line-up 인디케이션에서, 프로토콜은 line-up, line-down, fragment 인디케이션들을 포함하는 링크에서 연속적인 통신들을 위한 어떤 필요한 상태를 저장해야 한다.

연속적으로, 프로토콜은 프로토콜이 아래 WAN NIC 드라이버로 보내는 적어도 패킷들 중 하나의 소유권을 다시 얻기 전에 이러한 링크를 위해 NdisSend 함수로 호출하는 수만큼 상위 바인드할 때 SendWindow 값을 사용할 수 있다. (애매한 문장) 몇몇 NIC들은 만약 그들이 즉시 보내기를 위한 몇몇 패킷들을 가진다면 더 높은 throughput를 성취한다. 다른 것들은 만약 그들의 드라이버들이 보내기 패킷들로 넘친다면 신뢰할 수 없게 될 수 있다. NDISWAN은 또한 이러한 식으로 미니포트 설정 SendWindow를 사용한다.

NDISWAN은 프로토콜들과 통신하기 위해 Ethernet 스타일 주소 포맷을 사용하고 그래서 이러한 구조체의 XxxAddress 멤버들 쌍이 다음과 같이 사용된 6바이트 주소들이다:

  • NDISWAN은 특정 링크 프로토콜 컨텍스트를 지정하기 위해 RemoteAddress를 사용한다. 링크를 위한 초기 line-up 인디케이션에서 프로토콜이 NDISWAN에 의해 제공된 RemoteAddress를 저장해야 한다. 계속적으로, 프로토콜은 이러한 링크에서 전송들을 위해 NdisSend 함수에 대한 호출로 NDISWAN에게 RemoteAddress 값을 전달한다.

  • 프로토콜은 만들어진 링크를 위해 초기 line-up 인디케이션을 수신할 때 그 자체로 낮은 4바이트로(&LocalAddress[2]) 컨텍스트를 설정하기 위해 LocalAddress를 사용한다. 계속적으로, NDISWAN은 수신과 상태 인디케이션들에서 프로토콜에 대한 LocalAddress를 전달한다. 결과적으로, NDISWAN은 그 후에 링크에서 들어오는 수신들과 상태 인디케이션들을 위한 목적지로서 주어진 LocalAddress를 사용한다.

DeviceName 멤버는 낮은 레벨 프로토콜이 NDISWAN에 대해 하나의 바인딩을 가지지만 스택에서 그 자체와 상위 레벨 프로토콜 사이에 몇몇 바인딩들을 가지는 스택들로서 사용되고 이러한 멤버는 미래 PnP 시나리오들을 지원하기 위해 사용될 것이다. (애매) 즉, DeviceName은 다음과 같은 것들을 위해 사용될 것이다.

  • 아래 프로토콜이 NDISWAN에 의해 주어진 line-up 인디케이션를 전달해야 하는 바인딩(IN)을 지정하기 위해.

  • PnP 환경에서, line-ip 인디케이션에서 낮은 프로토콜에 의해 설정된 새롭게 만들어진 바인딩의 이름을 다시 NDISWAN에게 보고하기 위해.

NdisRequest에 대한 호출들로 전달되는 OID_XXX 코드들에 대한 많은 정보를 위해, Part 2를 봐라.