NdisMCoIndicateStatus

VOID 

  NdisMCoIndicateStatus(

    IN NDIS_HANDLE  MiniportAdapterHandle,

    IN NDIS_HANDLE  NdisVcHandle  OPTIONAL,

    IN NDIS_STATUS  GeneralStatus,

    IN PVOID  StatusBuffer  OPTIONAL,

    IN ULONG  StatusBufferSize

    );

NdisMCoIndicateStatus는 바인드된 프로토콜들에게 연결 지향 NIC의 상태내에서 변화를 인디케이트하거나 혹은 NIC에서 활성화된 특정 VC의 상태를 변화한다.

매개변수

MiniportAdapterHandle
MiniportInitialize에 대한 원래 입력으로 NDIS 제공 핸들을 지정한다.

NdisVcHandle
VC 특정 상태가 인디케이트되기 위해 VC에 대한 핸들을 지정한다. 미니포트는 원래 MiniportCoCreateVc 함수에 대한 입력 매개변수로서 이 핸들을 얻는다. NIC에서 일반적인 상태 변화를 모든 바인드된 프로토콜들에게 알리기 위해 이 핸들은 NULL이 될 것이다.

GeneralStatus
상태에서 변화를 설명하는 NDIS_STATUS_XXX 값을 지정한다.

StatusBuffer
GeneralStatus값에 추가적으로 미디엄 그리고 상태 특정 정보를 포함하는 호출자 할당 버퍼를 가리킨다.

StatusBufferSize
만약 StatusBuffer이 NULL이면은 0이고, StatusBuffer에서 버퍼의 바이트 크기를 지정한다.

주석

NULL NdisVcHandle를 가지는 NdisMCoIndicateStatus에 대한 호출은 NDIS가 차례로 각 바인드된 프로토콜의 ProtocolCoStatus 함수를 호출함으로써 미니포트의 상태 변화 주지를 모든 바인드된 프로토콜들에게 포워드한다. 외연적인 NdisVcHandle를 가지는 호출은 미니포트가 이러한 VC 핸들을 공유하는 클라이언트 혹은 그리고 가능하면은 콜 매니저에게 그러한 주지들을 제한한다.

이러한 경우 그러한 주지는 프로토콜들이 상태 변화를 로그하는 것을 가능하게 하거나 바른 행동을 하게 한다. 예를 들어, 프로토콜은 아랫 NIC 드라이버에 의해 인디케이트된 NDIS_STATUS_XXX에 의존하면서 NdisReset를 호출할 것이다.

미니포트가 네트워크 연결이 잃었다는 것을 감지할 때, NDIS_STATUS_MEDIA_DISCONNECT로 NdisMCoIndicateStatus를 호출해야 한다. 연결이 회복되었을 때, 미니포트는 NDIS_STATUS_MEDIA_CONNECT로 호출해야 한다. 미니포트가 NIC에서 연산 문제들을 보고하기 위해 NdisMCoIndicateStatus를 호출할 때, NDIS 그 자체는 작업 조건으로 NIC을 회복하려고 하기 위해 MiniportReset함수를 호출할 수 있다. 이러한 환경에서, NDIS는 단지 NDIS_STATUS_RESET_START로 바인드된 프로토콜들을 호출하고 나중에는 NDIS_STATUS_RESET_END로 호출한다. 미니포트가 NdisMCoIndicateStatus로 전달하는 GeneralStatus로 포워딩하는 것보다 오히려.

미니포트는 MiniportInitialize, MiniportISR, MiniportHalt 혹은 MiniportShutdown 함수의 컨텍스트내에서 NdisMCoIndicateStatus를 호출할 수 없다.

NdisMCoIndicateStatus의 호출자들은 IRQL <= DISPATCH_LEVEL에서 호출할 수 있다.

WAN Miniport Calls to NdisMCoIndicateStatus

CoNDIS WAN 미니포트 드라이버는 특정 상태 코드들과 버퍼 내용들로 VC 상태를 인디케이트한다. 이러한 상태 인디케이션들은 CoNDIS WAN NIC 미니포트 드라이버에 의해 발생되어진다. 그러한 미니포트에서 VC를 공유하는 연결 지향 클라이언트(프로토콜)는 이러한 인디케이션들을 무시할 수 있다. 그러나 이러한 인디케이션들을 처리하는 것은 전형적으로 프로토콜과 미니포트를 위해 향상된 퍼포먼스를 낳는다.

다음 타입의 CoNDIS-WAN 특정 인디케이션들은 NdisMCoIndicateStatus로 연결 지향 클라이언트들로 보내어질 수 있다.

  1. Link 매개변수들

  2. 프래그먼트

NDIS_STATUS_WAN_CO_LINKPARAMS

CoNDIS WAN 미니포트는 NIC에서 활성화된 특정 VC를 위한 매개변수들이 변화할때마다 링크 매개변수들 인디케이션을 한다.

링크 매개변수 인디케이션을 위한 상태 코드는 NDIS_STATUS_WAN_CO_LINKPARAMS이다. StatusBuffer의 버퍼는 WAN_CO_LINKPARAMS 구조체로서 포맷되어진다.

NDIS_STATUS_WAN_CO_FRAGMENT

CoNDIS WAN 미니포트는 가상 연결으 엔드포인트로부터 부분적인 패킷을 수신할 때마다 프래그먼트 인디케이션을 한다. 이러한 인디케이션이 일어난 후, 연결 지향 클라이언트는 프레임들을 VC의 다른 끝에 연결 지향 클라이언트에 보내야 한다. 이러한 프레임들은 바댄 엔드포이트에 이러한 부분적인 패킷 상황을 알릴 것이다. 타임아웃이 일어나기를 기다리는 것보다.

프래그먼트 인디케이션을 위한 상태 코드는 NDIS_STATUS_WAN_CO_FRAGMENT이다. StatusBuffer 버퍼는 NDIS_WAN_CO_FRAGMENT 구조체로 포맷되어진다.

NDISWAN은 각 링크에서 프래그먼트 인디케이션들의 수를 카운트함으로써 드랍된 패킷들을 모니터한다.