NdisMCmDeactivateVc

NDIS_STATUS

  NdisMCmDeactivateVc(

    IN NDIS_HANDLE  NdisVcHandle

    );

NdisMCmDeactivateVc함수는 NDIS에게 더이상 지정한 할성화VC로 전송을 하지 못할것이라는 것을 알린다.

매개변수

NdisVcHandle
VC를 확인하는 핸들을 지정한다. 이 핸들은 들어오는 호출에대해 NdisMCmCreateVc함수를 호출하거나 클라이언트가 처음에 나가는 호출을 할때 ProtocolCoCreateVc함수로 설정하는 VC할때 MCM미니포트에게 NDIS에의해 제공된다.

리턴값

NdisMCmDeactivateVc함수는 다음중 하나를 리턴할수 있다.:

NDIS_STATUS_SUCCESS
NDIS가 비활성화로써 VC를 설정한다.

NDIS_STATUS_NOT_ACCEPTED
VC는 이미 비활성화되었고 그래서 이 호출은 예비이다.

주석

MCM드라이버는 호출을 닫는 필수 적인 단계로써 NdisMCmDeactivateVc함수를 호출한다. 일반적으로, 연결을 해제하는 네트웍 컴포넌트들로 패킷 교환을 한후.

NdisMCmDeactivateVc함수의 성공적인 호출은 MCM드라이버로하여금 그 VC에서의 전송에대한 현재 콜 파리미터들을 버리도록 한다. 가능하면 미니포트 의존 디폴트 값으로 그것들을 재초기화한다. 그러나, 만약 VC가 다른 호출에대해 순차적으로 재 활성화한다면, 클라이언트는 새로운 콜 파라미터들을 미니포트에게 제공할 것이다.

NdisMCmDeactivateVc에게 넘겨지는 NdisVcHandle은 VC비활성화가 완료된후 유효하게 남아있다. 어떤 VC의 비활성화는 생성자로하여금 재사용을 위해 VC를 재초기하거나 혹은 파괴하는 것을 허용한다.:

  • 이어지는 VC비활성화와 콜을 닫기위해, 클라이언트는 NdisClMakeCall함수로 다른 호출을 만들기위해 처음에 생성한 VC를 재사용 할수 있고, NdisCoDeleteVc함수를 호출할 수 있다. 그러므로, MCM의 ProtocolCoDeleteVc함수의 호출을 야기한다.

  • 이어지는 VC비활성화와 콜을 닫기위해, MCM드라이버는 다른 들어오는 호출을 NdisMCmDispatchIncomingCall함수로 같은 클라이언트에게 인디케이트하기위해 처음에 생성한 VC를 재사용할 수 있고, NdisMCmDeleteVc함수를 호출한다.

드라이버 개발자는 MCM미니포트가 (내부적으로) 그 드라이버가 나가거나 들어오는 호출들에대한 연결을 해제하기위한 컨텍스트내에서 호출하는 MiniportCoDeactivateVc함수를 가지고 있다.

통합 호출 매니지먼트를 제공하는 연결지향 닉 미니포트만이 NdisMCmDeactivateVc함수를 호출할수 있다. 스스로를 NDIS에게 프로토콜로써 등록하는 독립적인 콜 매니저들은 대신 NdisCmDeactivateVc함수를 호출한다.

NdisCmDeactivateVc함수의 호출자는 IRQL <= DISPATCH_LEVEL에서 동작될 수 있다.