NdisCmMakeCallComplete

VOID NdisCmMakeCallComplete( IN NDIS_STATUS Status, IN NDIS_HANDLE NdisVcHandle, IN NDIS_HANDLE NdisPartyHandle OPTIONAL, IN NDIS_HANDLE CallMgrPartyContext OPTIONAL, IN PCO_CALL_PARAMETERS CallParameters );

NdisCmMakeCallComplete함수는 나가는 호출을 만들기위해 콜매니저가 이젠에 NDIS_STATUS_PENDING을 리턴한것에대한 클라이언트의 요청에대한 마지막 상태를 리턴한다.

매개변수

Status

연결을 만들기위한 시도의 마지막 상태를 지정한다. NDIS_STATUS_SUCCESS혹은 NDIS_STATUS_PENDING을 제외한 어떤 CM의존 NDIS_STATUS_XXX

NdisVcHandle

콜 매니저는 처음에 ProtocolCoCreateVc함수의 입력 파라미터로써 얻은 클라이언트가 생성한 VC의 핸들을 지정한다. 더 최근에 CM은 ProtocolCmMakeCall함수내로 넘겨진 CallMgrVcContext에의해 설계된 VC당 상태로부터 이 핸들을 얻는다.

NdisPartyHandle

콜 매니저는 ProtocolCmMakeCall함수로의 입력 파라미터로써 얻는 클라이언트가 생성한 멀티포인트 VC의 초기 party에대한 핸들을 지정한다.

CallMgrPartyContext

CM이 party당 상태 정보를 유지할 호출자가 할당한 상주 컨택스트 영역에대한 CM지원 핸들을 지정한다. 만약 NdisPartyHandle가 NULL이면 NULL이다. 멀티포인트 VC에대해, NDIS는 모든 순차적인 호출들에서의 CM지원 CallManagerPartyContext핸들을 이 party로 간주하는 ProtocolCmXxx함수에게 넘겨준다.

CallParameters

만약 상태가 NDIS_STATUS_SUCCESS이면, 이 연결을 설정하는 콜 파라미터들을 지정하는 CO_CALL_PARAMETERS타입 구조체의 포인터.

주석

독립적인 콜 매니저는 단지 하위 닉 미니포트가 VC에대한 데이타 트랜스퍼들 만들기위해 준비돼었을때만 NDIS_STATUS_SUCCESS로 NdisMCmMakeCallComplete함수를 호출해야만 한다. 즉, 콜 매니저는 VC에대한 콜 파라미터들을 성립하기위해 네트웍과 협상하고 성공적으로 NdisCmActivateVc함수를 호출한다.

만약 ProtocolCmMakeCall함수가 주어진 NdisVcHandle에대해 이전에 NDIS_STATUS_PENDING을 리턴했다면 독립적인 콜 매니저는 NdisCmMakeCallComplete함수를 호출해야만 한다. CM이 NDIS_STATUS_SUCCESS로 NdisCmMakeCallComplete함수를 호출할때까지 지연된 나가는 호출을 초기화하는 클라이언트는 전송을 만들기위해 VC를 사용할 수 없다.

심지어 시도된 연결이 실패한다면, CM의 NdisCmMakeCallComplete함수의 호출이 그 클라이언트의ProtocolClMakeCallComplete함수를 호출하도록 할때까지, NDIS와 클라이언트가 그들이 상태를 유지하기위해 할당한 리소스들을 해제할 수 없다. 사실 그런 연결을 설정하는 실패한 시도에대한 NdisCmMakeCallComplete함수의 호출을 무시하는것은 콜 메니저내의 메모리 누출을 야기한다. 또한 그것은 나가는 호출을 실패한것에대해 생성된 VC를 해제하는것으로부터 클라이언트를 예방하여 CM이 VC에대해 할당한 리소스들을 해제하기위한 호출하지않는다.

만약 CM이 상태에대해 NDIS_STATUS_FAILURE와 같은 에러를 넘긴다면, NdisCmMakeCallComplete함수를 호출하자마자 NdisPartyHandle을 무효하다고 간주한다. CM은 NdisCmMakeCallComplete함수가 컨추럴을 리턴할때 주어진 party에대한 상태를 유지하기위해 할당한 어떤 리소스들을 해재(혹은 재사용을 위한 재초기화)를 할수 있다.

클라이언트가 초기화한 나가는 호출을 설정하는 코스에서, CM은 처음에 ProtocolCmMakeCall함수에게 넘겨준 클라이언트 제공 콜 파라미터들을 수정할수 있다. 만약 그렇게 한다면, CM은 NdisCmMakeCallComplete함수를 호출할때 그 수정본을 CallParameters의 버퍼에 넘겨야만한다. 만약 클라이언트가 이 수정된 콜 파라미터들을 받아들일수 없다면, 그 콜을 해제할것이다. 이것은 또한 ProtocolCoDeleteVc함수의 호출을 야기한다.

스스로 NDIS로 프로토콜로서 등록하는 독립적인 콜 매니저만이 NdisCmMakeCallComplete함수를 호출할수 있다. 통합 콜 매니지먼트르 지원하는 닉 미니포트들은 대신 NdisMCmMakeCallComplete함수를 호출한다.

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