MiniportCoActivateVc

NDIS_STATUS MiniportCoActivateVc( IN NDIS_HANDLE MiniportVcContext, IN OUT PCO_CALL_PARAMETERS CallParameters );

MiniportCoActivateVc는 연결 지향 미니포트들을 위해 필요한 함수이다. MiniportCoActivateVc는 가상 연결이 활성화되었다는 것을 미니포트에게 지시하기 위해 NDIS에 의해 호출되어진다.

매개 변수

MiniportVcContext

미니포트가 VC 당 상태를 유지하는 미니포트 할당 컨텍스트 영역에 대한 핸들을 지정한다. 미니포트는 이 핸들을 MiniportCoCreateVc 함수로부터 NDIS에게 이 핸들을 제공한다.

CallParameters

콜 매니저에 의해 지정된 것처럼 이러한 VC를 위하여 만들어진 콜 매개변수를 지정한다. 출력으로는, 미니포트는 만약 어떤 플래그들이 CO_CALL_PARAMETERS 구조체로 설정되어진다면은 바뀐 콜 매개변수들이 리턴된다.

리턴값

NDIS_STATUS_SUCCESS

VC가 성공적으로 활성화되었다는 것을 가리킨다.

NDIS_STATUS_PENDING

미니포트는 VC가 비동기적으로 활성화되는 것에 대한 요구를 완성할 것이라는 것을 가리킨다. 미니포트가 이 연산을 마쳤을 때, NdisMCoActivateVcComplete을 호출해야 한다.

NDIS_STATUS_INVALID_DATA

CallParameters에서 지정된 콜 매개변수들은 이러한 미니포트가 지원하는 미디어 타입을 위해 유요하지 않거나 불법적이라는 것을 가리킨다.

NDIS_STATUS_RESOURCES

미니포트는 미니포트가 활성화된 VC에 대해 상태 정보를 유지하기 위해 필요한 모든 요구된 자원들을 할당할 수 없기 때문에 VC를 활성화할 수 없다는 것을 가리킨다.

주석

미니포트 드라이버는 CallParameters내에 지정된 것처럼 어댑터가 요구된 호출을 지원할 수 있는 지를 검증하기 위해 이러한 VC를 위한 콜 매개변수들을 검증해야 한다. 만약 요구된 호출 매개변수들이 만족할 수 없다면은 미니포트는 NDIS_STATUS_INVALID_DATA로 요구를 실패를 해야 한다.

MiniportCoActivateVc는 이미 활성화된 콜을 위한 콜 매개변수들을 바꾸기 위하여 하나의 VC를 위하여 여러번 호출되어질 수 있다. 모든 호출에서 미니포트는 매개변수들을 유효화해야 하고 요구를 만족시키기 위해 어댑터에 의해 필요한 어떤 처리들을 행해야 한다. 그러나 만약 주어진 콜 매개변수들을 설정할 수 없다면은, MiniportCoActivateVc는 연결 지향 클라이언트 혹은 콜 매니저가 지난 콜 매개변수들을 사용하여 데이터를 계속해서 보내고 받고 할 수 있기 때문에 사용할 수 있는 상태에서 VC를 떠나야 한다.(leave)

만약 ROUND_UP_FLOW 혹은 ROUND_DOWN_FLOW 플래그들이 CallParameters->MediaParameters->Flags에 콜 매개변수들 구조체에서 설정되어진다면은, 미니포트는 흐름 률(flow rate)이 설정된 적당한 플래그에 따라 라운드되어진후, VC의 실제 흐름 율을 리턴하라고 요구되어진다. 만약 미니포트가 이러한 플래그가 설정되었기 때문에 콜 매개변수의 어떤 것을 변화한다면은, CallParameters에 VC를 위한 사용이 실제 콜 매개변수들에 리턴되어져야 한다.

만약 콜 매개변수들이 수락되어질 수 있다면은, MiniportCoActivateVc는 가상 연결을 가로질러 데이터를 받거나 보내는 어댑터를 준비하는데 필요한 것처럼 어댑터와 통신을 한다. (e.g. 수신 버퍼들을 프로그래밍한다.)

MiniportCoActivateVc는 IRQL DISPATCH_LEVEL로부터 실행될 수 있게 쓰여져야 한다.