NdisMCmMakeCallComplete

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

NdisMCmMakeCallComplete함수는 나가는 호출을 만들기위해 MCM드라이버가 이전에 NDIS_STATUS_PENDING을 리턴하는것에대해, 클라이언트의 최종 상태를 리턴한다.

매개변수

Status

연결을 만들기위한 시도의 최종 상태를 지정한다. NDIS_STATUS_SUCCESS혹은 NDIS_STATUS_PENDING을 제외한 호출자 의존NDIS_STATUS_XXX.

NdisVcHandle

이것은 MCM미니포트가 ProtocolCoCreateVc함수에대한 입력 파라미터로써 얻은 그리고 더 최근에, ProtocolCmMakeCall함수에게 넘겨진 CallMgrVcContext로부터 얻은 클라이언트가 생성한 VC에대한 핸들을 지정한다.

NdisPartyHandle

클라이언트 생성 멀티 포인트 VC에대해 초기 파티에대한 핸들을 지정한다. 이VC는 MCM미니포트가 ProtocolCmMakeCall함수에대한 입력 파라미터로써 얻어진 것이다. 만약 주어진 NdisVcHandle이 포인트-포인트VC를 나타낸다면, 이 파라미터는 NULL이다.

CallMgrPartyContext

MCM미니포트가 파티당 상태 정보를 유지할 호출자 할당 상주 컨택스트 영역에대한 핸들을 지정한다. 혹은 만약 NdisPartyHandle이 NULL이면, 이 파라미터는 NULL이다. 멀티포인트 VC에대해, NDIS는 모든 순차적인 호출에서의 이 MCM드라이버 지원 CallManagerPartyContext핸들을 이 파티를 주목하는 ProtocolCmXxx함수에게 넘긴다. 만약 Status가 NDIS_STATUS_SUCCESS이외의 다른것이라면, NDIS는 이 파라미터를 무시한다.

CallParameters

만약 Status가 NDIS_STATUS_SUCCESS이면 이 연결에대한 콜 파라미터 설정을 지정하는CO_CALL_PARAMETERS타입 구조체의 포인터.

주석

MCM드라이버는 단지 그 VC로 데이타 전송을 만들 준비가 됐을때만 NDIS_STATUS_SUCCESS로 NdisMCmMakeCallComplete함수를 호출해야만 한다. 즉, MCM드라이버는 이러한 콜 파라미터들에대한 닉의 설정 VC에대한 콜 파라미터를 설정하기위해 네트웍과 협상한다. 그리고 VC활성화를 NDIS에게 알리기위해 NdisMCmActivateVc를 호출한다.

MCM드라이버는 만약 ProtocolCmMakeCall함수가 이전에 주어진 NdisVcHandle에대해 NDIS_STATUS_PENDING을 리턴했다면, NdisMCmMakeCallComplete함수를 호출해야만 한다. 나가는 호출을 지연하는 클라이언트는 미니포트가 NDIS_STATUS_SUCCESS로 NdisMCmMakeCallComplete함수를 호출할때까지 전송을 만들기위해 VC를 사용할수 없다.

심지어 시도된 연결이 실패하더라도, NDIS와 클라이언트는 MCM드라이버의 NdisMCmMakeCallComplete 함수에대한 호출이 그 클라이언트의 ProtocolClMakeCallComplete함수에대한 호출을 야기할때까지 상태를 유지하기위해 할당한 리소스들을 해제 할 수 없다. 사실, 그런 연결을 설정하기위한 실패한 시도에대한 NdisMCmMakeCallComplete함수의 호출에대한 무시는 MCM드라이버에서의 메모리 누수를 야기한다.; 그것은 실패한 나가는 호출에대해 생성된 VC를 해제하는것으로부터 클라이언트를 예방하여, MCM미니포트의 ProtocolCoDeleteVc함수가 그 VC에대해 미니포트가 할당한 리소스들을 해제하기위해 호출되지 않는다.

만약 MCM드라이버가 에러를 넘긴다면, Status에대해 NDIS_STATUS_FAILURE와 같은것은 NdisMCmMakeCallComplete함수가 컨추럴을 리턴할때, NdisPartyHandle이 무효하다고 여겨져야만 한다. 그 CM은 NdisMCmMakeCallComplete함수가 컨추럴을 리턴한후 주어진 파티에대한 상태를 유지하기위해 할당한 리소스들을 재사용(재 사용을 위해 재 초기화)할수 있다. MCM드라이버의 ProtocolCoDeleteVc함수는 MCM드라이버가 에러 상태를 NdisMCmMakeCallComplete함수에게 넘길때마다, 미니포트가 클라이언트가 생성한 VC의 상태를 트랙킹하기위해 할당한 리소스들을 해제하기위해 호출될 것이다.

클라이언트가 초기화하는 나가는 호출의 설정중에, MCM드라이버는 처음에 ProtocolCmMakeCall함수에게 넘겨지는 클라이언트 제공 콜 파라미터를 수정할수 있다. 만약 그렇게 한다면, NdisMCmMakeCallComplete함수를 호출할때, MCM미니포트는 CallParameters의 버퍼에 그 수정내용을 넘겨야만 한다. 만약 클라이언트가 이러한 수정된 콜 파라미터가 수용될수 없다는것을 안다면, MCM드라이버의 ProtocolCoDeleteVc함수에대한 호출을 야기시키는 호출 해제를 할것이다.

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

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