NdisMIndicateStatus

VOID 

  NdisMIndicateStatus(

    IN NDIS_HANDLE  MiniportAdapterHandle,

    IN NDIS_STATUS  GeneralStatus,

    IN PVOID  StatusBuffer,

    IN UINT  StatusBufferSize

    );

NdisMIndicateStatus 함수는 상위 레벨 NDIS 드라이버로 NIC의 상태 변화를 알린다.

매개변수

MiniportAdapterHandle
MiniportInitialize 함수로 입력되는 원래의 핸들을 서술한다.

GeneralStatus
NIC에 대한 일반적인 상태 변화를 알리는 NDIS_STATUS_XXX 값을 서술한다.

StatusBuffer
미디엄 특정이고 GeneralStatus에 값에 의존하는 데이타를 포함하는 호출자 할당 버퍼를 가리킨다. 그것은 상태 변화의 세부사항을 알린다.

StatusBufferSize
StatusBuffer에 버퍼의 바이트 사이즈를 서술한다.

주석

미니포트가 NdisMIndicateStatus 함수를 호출할 때 NDIS는 각각의 바인딩된 프로토콜의 ProtocolStatus 함수를 호출한다. 이것은 바인딩된 프로토콜 드라이버나 가능하다면 구성 매니저로 하여금 하부 NIC의 상태 변화를 저장하게하고 교정하는 작동을 하도록한다. 예를들어 프로토콜은 인디케이트된 NDIS_STATUS_XXX에 의존하여 NdisReset 함수를 호출한다.

NIC의 상태 변화를 보고하기 위해서 미니포트가 NdisMIndicateStatus 함수를 호출할 때 NDIS는 NIC을 작업중인 상태로 화복시키기 위해서 MiniportReset 함수를 호출할 수 있다. 이러한 상황에서 NDIS는 미니포트에 의해서 인디케이트된 GeneralStatus 보다는 오히려 NDIS_STATUS_RESET_START를 가지고 후에 NDIS_STATUS_RESET_END를 가지고 바인딩된 프로토콜을 호출할 수 있다.

NdisMIndicateStatus 함수는 두 가지의 정보를 제공한다:

  • 일반적인 상태 변화를 알리는 전체 상태 값.

  • 네트웍 특정일 수 있는 일반적인 변화를 위한 특정 이유. 예를들어 연결삽입 실패는 이더넷(802.3) NIC과 그 드라이버와는 무관하지만 토큰링(802.5) 네트웍에 특정이다.

또한 미니포트는 우연하게 제거되거나 다시 입력된 케이블 혹은 일시적으로 실패한 연결같은 문제를 알리기 위해서 NdisMIndicateStatus 함수를 호출할 수 있다. 예를들어 다음의 상황이 발생했다고 가정하자:

  • 미니포트가 NDIS_STATUS_RING_STATUS를 가지고 NdisMIndicateStatus 함수를 호출한다.

  • StatusBuffer는 다음의 상태 값중 하나를 갖는다:
    NDIS_RING_LOBE_WIRE_FAULT
    NDIS_RING_HARD_ERROR
    NDIS_RING_SIGNAL_LOSS

그러한 상태 변화가 인디케이션을 가지고 시스널된 후에 관계된 threshold나 통계 카운트는 변화되지 않은 상태로 남는다.

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

NdisMIndicateStatus 함수의 직렬화된 호출자는 IRQL DISPATCH_LEVEL에서 실행한다. NdisMIndicateStatus 함수의 비직렬화된 호출자는 IRQL DISPATCH_LEVEL 이하에서 실행할 수 있다.

네트웍 연결의 손실과 저장을 알리기

네트웍 연결이 손실된다는 것을 미니포트가 감지했을 때 미니포트는 NDIS_STATUS_MEDIA_DISCONNECT를 가지고 NdisMIndicateStatus 함수를 호출해야한다. 연결이 회복될 때 미니포트는 NDIS_STATUS_MEDIA_CONNECT를 가지고 NdisMIndicateStatus 함수를 호출해야한다.

NdisMIndicateStatus 함수로의 WAN 미니포트 호출

대부분의 WAN NIC 드라이버는 몇몇 특별한 상태 코드와 버퍼 내용을 가지고 상태를 알린다. 이 상태 인디케이션은 WANNIC 드라이버에 의해서 발생하고 그러한 미니포트와 바인딩된 NDIS 프로토콜 드라이버는 이 인디케이션을 무시할 수 있다. 그러나 이 인디케이션을 정확하게 처리하는 것은 대개 프로토콜과 WAN NIC 드라이버에 대한 향상된 퍼포먼스의 결과이다.

다음 네가지의 WAN 특정 인디케이션은 NdisMIndicateStatus 함수를 가지고 바인딩된 프로토콜 드라이버로 보내질 수 있다:

  1. Line up

  2. Line down

  3. Fragment

  4. TAPI line event

NDIS_STATUS_WAN_LINE_UP

언제든지 새로운 연결이 활성화되면 WAN 미니포트는 라인업 인디케니션을 한다. 이것이 발생할 때까지 NIC은 프레임을 받아들이고 그들을 성공시키거나 실패시킨다. 하지만 그들이 원격지에 의해서 실제 리시브된다는 것은 아니다. 이것이 발생할 때까지 프로토콜은 그들의 타이머를 줄이고 카운트를 다시 시도한다. 따라서 나가는 연결시도는 빨리 실패한다.

WAN 미니포트는 OID_TAPI_GET_ID 리퀘스트로부터 리턴하기 전에 NdisMIndicateStatus 함수를 가지고 이 인디케이션을 한다.

라인업 인디케이션을 위한 상태 코드는 NDIS_STATUS_WAN_LINE_UP이다. StatusBuffer에 버퍼는 NDIS_MAC_LINE_UP 구조체로 포맷된다.

NDIS_STATUS_WAN_LINE_DOWN

WAN 미니포트는 연결이 다운될 때면 언제든지 라인다운 인디케이션을 한다. 이것이 발생했을 때 바인딩된 프로토콜은 그들의 타이머를 줄이고 다음 라인업 인디케이션 때까지 카운트를 다시 시도한다.

라인다운 인디케이션을 위한 상태 코드는 NDIS_STATUS_WAN_LINE_DOWN이다. StatusBuffer에 버퍼는 NDIS_MAC_LINE_DOWN 구조체로 포맷된다.

NDIS_STATUS_WAN_FRAGMENT

WAN 미니포트는 원격지로부터 부분적인 패킷을 받을 때면 언제든지 단편 인디케이션을 한다. 이것이 발생했을 때 바인딩된 프로토콜은 타임아웃의 발생을 기다리기 보다는 이 상황을 알리는 원격지로 프레임을 보내야한다.

단편 인디케이션을 위한 상태 코드는 NDIS_STATUS_WAN_FRAGMENT이다. StatusBuffer에 버퍼는 NDIS_MAC_FRAGMENT 구조체로 포맷된다.

NDISWAN 모니터는 각각의 연결에서 단편 인디케이션의 수를 셈으로써 패킷을 드랍한다.

NDIS_TAPI_EVENT

WAN 미니포트는 TAPI 상태 인디케이션을 위해서 NDIS_STATUS_TAPI_INDICATION의 GeneralStatus 값을 사용해야한다. StatusBuffer에 버퍼는 NDIS_TAPI_EVENT 구조체로 포맷된다.