ProtocolCoDeleteVc

NDIS_STATUS ProtocolCoDeleteVc( IN NDIS_HANDLE ProtocolVcContext );

ProtocolCoDeleteVc 함수는 원래 그러한 VC의 창조자에 의해 닫힐 설립된 가상 연결을 위한 클라이언트 혹은 콜 매니저의 상태를 끊는 필요한 함수이다.

매개변수

ProtocolVcContext

클라이언트 혹은 콜 매니저의 VC 당 컨텍스트 영역에 대한 핸들을 지정한다. 프로토콜은 원래 ProtocolCoCreateVc 함수로부터 이 핸들을 제공한다.

리턴값

ProtocolCoDeleteVc 함수는 다음과 같은 하나를 리턴한다:

NDIS_STATUS_SUCCESS

프로토콜은 원래 VC를 위해 할당한 모든 재자원들을 재사용을 위해 해제하거나 준비했다.

NDIS_STATUS_NOT_ACCEPTED

VC가 아직 활성화 되서 프로토콜은 파괴될 수 없는 VC를 지연하는 발생한 연산들을 가진다.

NDIS_STATUS_XXX

프로토콜은 드라이버 결정 이유로 VC 삭제를 실패했다.

주석

ProtocolCoDeleteVc 함수는 드라이버의 ProtocolCoCreateVc 함수의 상관관계이다.(reciprocal) 일반적으로, 콜 매니저 혹은 클라이언트가 전에 활성화 VC에서 연산들을 행하기 위해 할당했던 동적 자원들과 구조체들을 해제한다.

ProtocolCoDeleteVc 함수가 NDIS_STATUS_SUCCESS로 제어를 리턴할 때, ProtocolCoCreateVc 함수가 ProtocolVcContext 영역에 저장한 NdisVcHandle는 유효하지 않게 된다.

ProtocolCoDeleteVc 함수는 VC의삭제가 실패하기 위해 어떤 드라이버 결정 NDIS_STATUS_XXX를 리턴할 수 있지만, NDIS_STATUS_PENDING을 리턴할 수 없다. ProtocolCoDeleteVc 함수에 대한 호출들은 원래 동기적이다.

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