NdisMCmDeleteVc

NDIS_STATUS NdisMCmDeleteVc( IN NDIS_HANDLE NdisVcHandle );

NdisMCmDeleteVc함수는 호출자가 생성한 VC를 파괴한다.

매개변수

NdisVcHandle

지워질 VC를 확인하는 핸들을 지정한다. 호출자는 처음에 NdisMCmCreateVc함수로부터 이핸들을 얻는다.

리턴값

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

NDIS_STATUS_SUCCESS

NDIS는 VC를 지웠다.

NDIS_STATUS_NOT_ACCEPTED

VC는 여전히 활성화이어서 지워 질수 없다.

주석

MCM드라이버가 NdisMCmDeleteVc함수를 호출할때, 주어진 VC에대한 미해결의 호출은 없어야만 하고 VC가 비활성화 되어있어야만 한다. 이러한 요구들이 있을때, MCM드라이버가 주어진 NdisVcHandle로 성공적으로 이미 NdisMCmDeactivateVc함수를 호출한다는 것을 암시한다.

단지 지정한 VC를 생성하는 드라이버만이 VC를 지울수 있다. NdisMCmDeleteVc함수에대한 호출은 NDIS로하여금 호출자가 NdisVcHandle을 공유하는것으로 클라이언트의 ProtocolCoDeleteVc함수를 호출하도록 한다.

NdisMCmDeleteVc함수가 컨추럴을 리턴할때, NdisVcHandle은 더이상 유효하지 않는다. MCM드라이버는 지원진 VC에대한 상태를 유지하기위해 할당한리소스혹은 NdisMCmCreateVc함수의 호출후 순차적인 들어오는 호출의 알림에서 재사용하기위한 그들을 준비하는 리소스들을 해제할수 있다.

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

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

NdisMCmDeleteVc함수의 호출은 IRQL <= DISPATCH_LEVEL에서 동작할수 있다.