ProtocolCoStatus

VOID

  ProtocolCoStatus(

      IN NDIS_HANDLE  ProtocolBindingContext,

      IN NDIS_HANDLE  ProtocolVcContext  OPTIONAL,

      IN NDIS_STATUS  GeneralStatus,

      IN PVOID  StatusBuffer,

      IN UINT  StatusBufferSize

      );

ProtocolCoStatus 함수는 아래 드라이버 혹은 NDIS에 의해 올려지는 상태 변화 주지들을 다루는 연결 지향 프로토콜 드라이버들에서 필요한 드라이버 함수이다.

매개변수

ProtocolBindingContext
프로토콜 드라이버는 바인딩 당 런타임 상태를 유지하는 프로토콜 할당 컨테그슽 영역에 대한 핸들을 지정한다. 드라이버는 NdisOpenAdapter 함수를 호출할 때 이 핸들을 제공한다.

ProtocolVcContext
프로토콜 드라이버는 VC당 런타임 상태를 유지하는 프로토콜 할당 컨텍스트 영역에 대한 핸들을 지정한다. 이 매개변수는 ProtocolCoStatus 함수가 만약 상태 변화 인디케이션이 원래 VC 특정이 아니면 호출될 때 NULL이다. 그렇지 않으면, 프로토콜은 원래 NdisCoCreateVc 함수를 호출할 때 ProtocolCoCreateVc 함수로부터 이 핸들을 제공한다.

GeneralStatus
NDIS에 의해 상승된 혹은 NdisMCoIndicateStatus 함수에 대한 아래 드라이버의 호출로부터 전달되는 일반적인 상태 코드를가리킨다.

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

몇몇 NDIS_STATUS_XXX 값들을 위해, 이러한 포인터는 NULL이고 StatusBufferSize는 0으로 설정된다.

StatusBufferSize
StatusBuffer인 버퍼 수를 지정한다.

주석

ProtocolCoStatus함수에 대한 호출은 활성화 VC의, 아래 연결지향 NIC의, 혹은 드라이버의 상태에 대한 변화들을 프로토콜에게 알린다.

ProtocolCoStatus 함수는 두개의 기본 정보를 해석한다. :

  1. NDIS에 의해 NDIS_STATUS_XXX 값으로 정의된, VC, NIC, 아래 드라이버의 변화를 가리키는 일발적인 상태 코드.

    만약 NDIS가 NIC에 연산 상태를 회복하려는 시도로 아래 드라이버의 MiniportReset 함수를 호출한다면, NDIS는 NdisMCoIndicateStatus 함수에 대한 미니포트의 호출로 가리키는 GeneralStatus를 위해 NDIS_STATUS_RESET_START를 대체할 수 있다.

  2. 미디어 특정일 수 있는 상태 변화를 위한 특정 이유에 대한 추가적이 정보인, GeneralStatus인 상태에 의존한다.

NDIS는 항상 아래 연결 지향 드라이버가 처음 NDIS_STATUS_RESET_END 로 그들의 ProtocolCoStatus 함수들을 호출함으써 NIC을 리셋할 때 나중에 리셋 과정이 완료할 때 NDIS_STATUS_RESET_END로 모든 바인드된 프로토콜들에 알린다. ProtocolCoStatus 함수에 대한 각 그러한 호출 후, NDIS는 또한 드라이버의 ProtocolStatusComplete 함수를 호출한다.

NDIS는 프로토콜 초기화된 보내기들과 리셋 과정이 진행중인 동안 미니포트에 대한 요구를 수락하지 않기 때문에, NDIS_STATUS_RESET_START 주지는 그들이 응답하는 NDIS_STATUS_RESET_END 주지를 수신할 때까지 그들의 ProtocolCoStatus 함수들에 주어진 각 ProtocolBindingContext에 의해 지정된(designated) 바인딩에 대한 NdisCoSendPackets 함수와 NdisCoRequest 함수들에 대한 그들의 호출들을 하지 말도록 바인드된 프로토콜들에게 경고한다.

만약 프로토콜이 NdisReset 함수에 대한 호출로 리셋 연산을 초기화한다면, ProtocolCoStatus 함수는 같은 아래 드라이버에 바인드된 어떤 다른 프로토콜과 같이 NDIS_STATUS_RESET_START 와 NDIS_STATUS_RESET_END 주지들을 수신한다. 그러나, 만약 NdisReset 함수가 NDIS__STATUS_PENDING을 리턴한다면, 단지 리셋 연산을 초기화한 드라이버의 ProtocolStatusComplete 함수가 호출되어진다.

결과적으로, 모든 프로토콜의 ProtocolCoStatus 함수는 ProtocolCoStatus 함수가 NDIS_STATUS_RESET_START 주지를 수신하자 마자 프로토콜이 보내기들과 요구들을 제출하는 것을 막는데 필요한 행동들을 취해야 하고 ProtocolCoStatus 함수가 NDIS_STATUS_RESET_END 주지를 받을 때 계속해서 보내기들을 요구들을 다시 할 수 있게 해야 한다. 항상, ProtocolCoStatus 함수는 간단히 다른 드라이버 함수들이 그들이 바인딩 한 곳에서 보내기들 혹은 요구들을 초기화하기 전에 체크하는 ProtocolBindingContext 영여에 ResetInProgress 플래를 설정하고 클리어한다.

아래 NIC 드라이버는 상태 변화를 신호화할 때, 관련된 이벤트 카운터들과 임계값(thresholds)은 바꾸지 않는다.

ProtocolCoStatus 함수는 IRQL DISPATCH_LEVEL에서 실행할 수 있도록 쓰여져야 한다.