NdisCoDeleteVc
NDIS_STATUS
NdisCoDeleteVc(
IN NDIS_HANDLE NdisVcHandle
);
|
NdisCoDeleteVc함수는 호출자가 만든 VC를 소멸한다.
매개변수
- NdisVcHandle
- 지원진 VC를 확인하는 핸들을 지정한다. 호출자는 처음에 NdisCoCreateVc함수로 부터 이 핸들을 얻는다.
리턴값
NdisCoDeleteVc함수는 다음중 하나를 리턴할수 있다.
- NDIS_STATUS_SUCCESS
- NDIS는 VC를 지운다.
- NDIS_STATUS_NOT_ACCEPTED
- VC는 여전히 활성이어서 지워질수 없다.
- NDIS_STATUS_CLOSING
- 이 호출은 여분의 것이다. 그렇지만 주어진 VC에대한 비활성화는 여전히 팬딩이다.
주석
프로토콜이 NdisCoDeleteVc함수를 호출할때, 주어진 VC에대한 나가는 호출이 없어야만 한다. 그리고 그 VC는 이미 비 활성화 됐다. 이를위한 필요 조건은 다음 조건하에서 수행된다.:
- 만약 호출 해제가 로컬 클라이언트에의해 초기화 되면, 그 클라이언트는 이미 주어진 NdisVcHandle 로 NdisClCloseCall 을 호출했고, 그 종료-호출 요청은 성공적으로 완료됐다.
- 만약 콜 해제가 리모트 클라이언트에의해 초기화 된다면, 독립적인 콜 매니저는 이미 주어진 NdisVcHandle 로 NdisCmDeactivateVc 함수를 이미 호출했고, 비활성화 요청은 이미 완료됐다.
지정된 VC를 생성하는 프로토콜만이 그 VC를 지울수 있다. NdisCoDeleteVc함수의 호출은 NDIS로 하여금 두 하위 닉 드라이버의 MiniportCoDeleteVc함수와 호출자가 NdisVcHandle을 공유한다는 클라이언트 혹은 콜 매니저 ProtocolCoDeleteVc함수를 호출하도록 한다.
NdisCoDeleteVc함수가 컨추럴을 리턴할때, NdisVcHandle은 더이상 유효하지 않다.
스스로를 NDIS로 프로토콜로써 등록하는 독립적인 콜 매니저들은 NdisCoDeleteVc를 호출할수있다. 통합 콜 매니지먼트를 지원하는 연결지향 닉 미니포트들은 대신 NdisMCmDeleteVc함수를 호출한다.
NdisCoDeleteVc 함수의 호출자는 IRQL <= DISPATCH_LEVEL에서 동작될수 있다.
|