ProtocolStatus

VOID

  ProtocolStatus(

      IN NDIS_HANDLE  ProtocolBindingContext,

      IN NDIS_STATUS  GeneralStatus,

      IN PVOID  StatusBuffer,

      IN UINT  StatusBufferSize

      );

ProtocolStatus함수는 아래단 비연결 지향 NIC드라이버 또는 NDIS에 의해 제기된 바뀌는 상태 알림을 다루는 필수 드라이버 함수이다.

배타적인 연결지항 프로토콜은 ProtocolStatus 함수보다 목적에 꼭 맞은 ProtocolCoStatus 함수를 가져야 한다.

매개변수

ProtocolBindingContext
프로토콜 드라이버가 바인드 당 런타임 상태를 유지하는 프로토콜 할당 컨텍스트 영역의 핸들을 명시한다. NdisOpenAdapter함수가 호출 됐을 때 드라이버가 이 핸들을 제공 한다.

GeneralStatus
NDIS에 의해 제기되거나 아래단 드라이버의 NdisMIndicateStatus함수 호출로 부터 전해진 일반적인 상태 코드를 가리킨다.

StatusBuffer
GeneralStats값에 의존하는 미디엄 특정 데이터를 포함하는 버퍼를 가리킨다.

예를 들어, GeneralStatus 인자가 NDIS_STATUS_RING_STATUS이면, 이 파라미터는 ULONG 크기의 비트마스크를 가리키고 StatusBufferSize는 4이다. 예 하나 더, GeneralStatus가 NDIS_STATUS_WAN_LINE_UP이면, 이 파라미터는 NDIS_WAN_LINE_UP구조체를 가리키고 StatusBufferSize는 sizeof(NDIS_STATUS_WAN_LINE_UP)이다.

For some NDIS_STATUS_XXX values, this pointer is NULL and StatusBufferSize is set to zero.

StatusBufferSize
StatusBuffer의 바이트 수를 명시한다.

주석

ProtocolStatus함수 호출은 프로토콜이 아래단 NIC이나 이 드라이버의 상태변화를 알린다.

ProtocolStatus함수는 두가지의 기본적인 정보를 밝힌다:

  1. 일반적인 상태 코드,NDIS_STATUS_XXX값으로 NDIS에 의해 정의된,는 NIC이나 아래단 드라이버에서의 변화를 나타낸다.

    만약 NDIS가 아래단 드라이버의 NIC 연산 상태를 되돌리는 시도를 하는 MiniportReset함수를 호출 했었다면, NDIS는 GeneralStatus가 미니포트의 NdisMIndicateStatus함수 호출에서 가리켰던 것에 대해 NDIS_STATUS_RESET_START로 대신 할 수 있다.

  2. GenetalStatus에서 상태에 의존하는 것,상태 변화에 대해 특정한 원인에 대한 추가적인 정보,은 미디엄 특정일 수 있다.

    예를 들어, ring-insert 실패는 토큰링 네트웍에서는 특별하고 이더넷 네트웍에서는 영향이 없다.

아래단 드라이버가 NIC을 리셋할 때 NDIS는 처음은 NDIS_STATUS_RESET_START 그리고 이후, 리셋 연산이 끝나면, NDIS_STATUS_RESET_END와 함께ProtocolStatus함수를 호출 함으로서 모든 바인드된 프로토콜에게 알린다.

그 이후 리셋이 진행 되는 동안 NDIS는 프로토콜 초기화 보내기와 미니포트로의 요고를 받아들아면 안된다. NDIS_STATUS_RESET_START 알림은 NDIS_STATUS_RESET_END 알림을 받을 때 까지 ProtocolStatus함수에게 주었던 각각의 ProtocolBindingContext에 의해 지명된 바인딩에서 NdisSendPackets, NdisSend, NdisRequest함수 호출이 일어나지 않음을 바인드된 프로토콜에게 경고한다.

만약 프로토콜이 NdisReset함수를 호출하므로써 리셋연산을 스스로 초기화 하면, ProtocolStarus 함수는 다른 모든 같은 아래단 드라이버에 프로토콜이 바인드하던 것 처럼 NDIS_STATUS_RESET_START와 NDIS_STATUS_RESET_END알림을 받는다. 어째든, Ndisreset 함수가 NDIS_STATUS_PENDING을 리턴 하면 단지 드라이버의 ProtocolStatusComplete 함수만이 리셋 연산ㅇ 호출되는 것을 초기화 한다.

따라서, 모든 프로토콜의 ProtocolStatus 함수는 어떤 액션이 프로토콜이 보내기를 제시받고 ProtocolStatus 함수가 NDIS_STATUS_RESET_START알림을 받자 마자 요구하고 다음 차례의 보내기가 다시 인에이블 되고 ProtocolStatus 함수가 NDIS_STATUS_RESET_END알림을 받았 을 때의 요구를 방해 받더라도 취해야 한다.

예 하나 더,NDISWANrhk 바이드한 모든 므로토콜의 ProtocolStatus 함수는 아래단 WAN NIC 미니포트가 새로운 링크가 생기면 언제라도 line-up 알림을 받는다. 그런 프로토콜이 NDISWAN의 링크-특정 컨텍스트 핸들 교환했었던 후, ProtocolStatus 함수는 프로토콜이 이 링크에서 최상의 효율과(또는) 성능을 사용할 수 있는추가적인 링크-특정 라인 업, 라인-다운, 그리고 fragment indications을 받을 수 있다.

아래단 NIC 드라이버가 상태 변화를 신호로 알릴 때, 연결된 이벤트 카운터와 thresholds는 변하지 않는다.

디폴트로, ProtocolStatus 함수는 임의의 스레드 컨텍스트에서 IRQL DISPATCH_LEVEL에서 실행한다.