NDIS_MAC_LINE_UP

typedef struct _NDIS_MAC_LINE_UP {

    IN ULONG            LinkSpeed;

    IN NDIS_WAN_QUALITY Quality;

    IN USHORT           SendWindow;

    IN NDIS_HANDLE      ConnectionWrapperID;

    IN NDIS_HANDLE      NdisLinkHandle;

    IN OUT NDIS_HANDLE  NdisLinkContext;

} NDIS_MAC_LINE_UP, *PNDIS_MAC_LINE_UP;

NDIS_MAC_LINE_UP 구조체는 WAN NIC 미니포트에 의해 만들어진 line-up 인디케이션과 관련된 정보를 포함한다.

멤버

LinkSpeed
100bps의 유닛들에서 링크의 속도를 지정한다.

0은 미니포트가 원래 OID_GEN_LINK_SPEED 쿼리를 위해 리턴하는 속도로부터 어떤 변화도 없다는 것을 가리킨다.

Quality
프로토콜이 OID_WAN_QUALITY_OF_SERVICE로 NdisRequest 함수를 호출할 때 리턴되는 새로운 라인의 서비스 질(QoS)을 지정한다.

SendWindow
WAN NIC 드라이버가 내부적으로 큐에 저장하는 얼마나 많은 NDIS_WAN_PACKET_ 타입 보내기 패킷들을 효율적으로 동시에 미니포트가(혹은 NIC) 수락할 수 있는 보내기 패킷들의 수를 지정한다. 0은 NDISWAN이 OID_WAN_GET_INFO 쿼리로 응답하는 MaxTransmit을 위해 리턴된 값을 사용해야 하는 것을 가리킨다.

ConnectionWrapperID
이러한 링크가(혹은 링크에서 데이터 채널) TAPI 클라이언트로 알려질 핸들을 지정한다. 이 핸들은 유일해야 하고 그래서 미니포트는 NDISTAPI에 의해 제공된 htCall 핸들을 사용한다. 미니포트가 그러한 링크(혹은 데이터 채널)를 설립하는 초기 line-up 인디케이션을 하기 전에, 이미 다음과 같은 방법의 하나로 NDISTAPI-할당 htCall 핸들을 얻는다:

  • 나가는 호출을 위해, 드라이버의 MiniportQueryInformation 함수는 NDISTAPI가 선행 OID_TAPI_MAKE_CALL 요구로 제공한 htCall 핸들을 저장한다.

  • 들어오는 호출을 위해, 미니포트는 NDISTAPI가 미니포트가 LINE_NEWCALL로 설정된 ulMsg로 NdisMIndicateStatus 함수에 전달한 NDIS_TAPI_EVENT 구조체의 ulParam2로 리턴한 htCall 핸들을 저장한다.

NdisLinkHandle
하나의 데이터 스트림이상을 다루는 능력을 가진 링크로 특정 채널를 지정하거나 특정 링크를 지정하기 위해 MiniportWanSend 함수와 같은 계속적인 호출로 전달되어지는 원래 NIC 드라이버에 의해 제공된 핸들을 지정한다.

NdisLinkContext
WAN NIC 드라이버가 링크를 설립하기 위해 이러한 구조체로 NdisMIndicateStatus 함수를 호출할 때 0을 지정한다. NdisMIndicateStatus 함수로부터 리턴하자 마자, 이러한 멤버는 설립된 링크를 위해 수신들을 인디케이트하는 것과 같은 미래의 호출에서 사용된 NDISWAN에 의해 제공된 핸들을 포함한다.

주석

WAN NIC 드라이버는 다음과 같은 조건들 중에서 이러한 타입의 인디케이션으로 NdisMIndicateStatus 함수를 호출한다.

  • wide area network에서 로컬 노드와 리모트 노드 사이의 링크가 새로운 링크를 설립하는 과정에서 활성화될 때, MiniportQueryInformation 함수는 ulSelect는 LINECALLSELECT_CALL로 설정되기 위해 OID_TAPI_GET_ID 요구의 컨텍스트내에서 이러한 인디케이션을 한다.

    NdisMIndicateStatus 함수를 리턴할 때, 미니포트는 막 설립된 링크에 영향을 주는 NdisMIndicateStatus 함수와 NdisWanXxx 함수들로 계속적인 호출들을 위해 NDISWAN에 의해 제공된 NdisLinkContext 핸들을 저장해야 한다.

    MiniportQueryInformation 함수는 또한 NDIS_TAPI_GET_ID 구조체내 DeviceID인 NDISTAPI로 리턴된 값으로 리턴된 NdisLinkContext 핸들을 사용해야 한다.

    만약 링크에서 하나의 데이터 채널 이상을 다룰 수 있다면, WAN NIC 드라이버의 MiniportQueryInformation 함수는 링크에서 각 그러한 채널이 열린 것처럼 OID_TAPI_GET_ID로 한번은 호출된다. 그러한 링크에서, NdisLinkContext는 링크 특정보다 오히려 채널 특정이다.

  • 그러한 링크가 설립된 후, NIC 드라이버는 만약 라인 특성들이 변화하면 혹은 NIC 드라이버가 내부 큐를 위해 수락하는 나가는 보내기들의 수를 지정하는 SendWindow의 값을 동적으로 변화하기 위해 주어진 NdisLinkContext 핸들로 이러한 인디케이션을 한다. 예를 들어, 미니포트는 만약 원래 라인의 지정된 Quality가 변하면 계속적인 line-up 인디케이션을 할 수 있다.

전형적으로, WAN NIC 드라이버는 NdisLinkHandle과 같은 각 링크를 위해 드라이버 할당 제어 블럭에 대한 포인터를 제공한다. 이러한 핸들은 링크 특정이거나 혹은 만약 드라이버가 링크당 하나의 데이터 스트림 이상을 관리한다면, 데이터 채널 특정이다. 어떠한 경우에도, WAN NIC 미니포트는 미니포트가 각 링크 혹은 데이터 채널을 위해 만드는 첫 NDIS_MAC_LINE_UP 인디케이션으로 NdisLinkHandle을 설정해야 한다.

NDISWAN이 MiniportWanSend 함수로 SendWindow에 지정된 많은 수들의 패킷들을 제출한 후, NDISWAN은 미니포트가 완성된 보내기 패킷을 리턴할 때까지 큐에 저장된 들어오는 보내기 패킷들을 유지하거나 전에 처음 발생한 NDIS_STATUS_PENDING으로 리턴된 패킷을 위해 NdisMWanSendComplete 함수를 호출한다. 연속적인 NDIS_MAC_LINE_UP들은 만약 NIC 드라이버가 동적을 SendWindow 값을 바꿀 필요가 있다면 인디케이트될 수 있다.

SendWindow값이 바뀌거나 혹은 라인 특성들에 변화가 있든지 간에 계속적인 NDIS_MAC_LINE_UP 인디케이션들이 만들어질 때마다, NdisLinkHandle 멤버는 같은 링크를 위해 NdisMIndicateStatus 함수로 드라이버의 초기 라인 업 호출로 설정된 값으로 채워질 것이다.

NDIS_WAN은 새로운 링크 혹은 채널을 설립한 모든 초기 NDIS_MAC_LINE_UP 인디케이션을 위해 NdisLinkContext로 유일로 핸들을 제공한다. 미니포트는 같은 링크 혹은 채널을 위해 어떤 계속적인 NDIS_MAC_LINE_UP, NDIS_MAC_LINE_DOWN, NDIS_MAC_FRAGMENT 인디케이션들을 할 때 주어진 NdisLinkContext 핸들을 제공해야 한다.

WAN 과 TAPI OID들에 대한 더 많은 정보에 대해 Part 2를 봐라.