NdisClIncomingCallComplete

VOID NdisClIncomingCallComplete( IN NDIS_STATUS Status, IN NDIS_HANDLE NdisVcHandle, IN PCO_CALL_PARAMETERS CallParameters );

NdisClIncomingCallComplete함수는 제안된 들어오는 호출에대한 클라이언트의 허용과 거부를 리턴한다. 클라이언트의 ProtocolClIncomingCall함수가 이전에 NDIS_STATUS_PENDING을 리턴한것에대해서.

매개변수

Status

클라이언트가 제안된 호출을 받아들였다면 NDIS_STATUS_SUCCESS를 설정한다. 그렇지 않으면, 이 파라미터는 호출을 거부하는것에대한 클라이언트 의존 이유를 설명하기위해 NDIS_STATUS_PENDING을 제외한 어떤 NDIS_STATUS_XXX를 설정할수있다.

NdisVcHandle

들어오는 호출을 나타내기위해 콜매니저에의해 만들어진 VC에대한 핸들을 지정한다. 클라이언트는 ProtocolClIncomingCall함수에대한 입력 파라미터로써 넘겨진 ProtocolVcContext에의해 만들어진 VC당 상태로 부터 이핸들을 얻는다.

CallParameters

CO_CALL_PARAMETERS타입의 구조체의 포인터, 들어오는 호출에 대한 콜 파라미터를 지정한다.

주석

만약 클라이언트의 ProtocolClIncomingCall함수가 이전에 NdisClRegisterSap함수로 클라이언트에의해 등록된 특별한 SAP에대해 들어오는 제안된 호출에대해 NDIS_STATUS_PENDING리턴하면, 클라이언트는 순차적으로 제안된 호출을 받아들일것인지 거절할것인지를 알리기위해 NdisClIncomingCallComplete함수를 호출해야만한다.

NdisClIncomingCallComplete함수를 호출하기전에, 그런 클라이언트는 한번 혹은 그 이상의 NdisClModifyCallQoS함수의 호출에 의해 콜매니저와 협상을 할수있다. 두 드라이버가 들어오는 호출에대한 허용할수 있는 서비스 질에대한 동의에 이를때까지 혹은 동의하는 결과없이 몇몇 클라이언트의 결정의 제한에 이르는 QoS를 수정하기위한 시도때문에(애매) 클라이언트가 제안된 호출을 거절해야만 한다는것을 결정할때까지.

만약 클라이언트가 ProtocolClIncomingCall함수에게 넘겨준 콜 파라미터를 바꿨다면, 이런한 변화를 NdisClIncomingCallComplete함수에게 넘겨줄때, CO_CALL_PARAMETERS구조체내의 Flags멤버를 CALL_PARAMETERS_CHANGED로 설정해야만 한다. 콜 매니저가 콜 파라미터들로 클라이언트의 제안된 변화들을 거절할것인지 허용할것인지에 의존하여 NDIS는 순차적으로 각각 클라이언트의 ProtocolClCallConnected함수를 호출하거나 ProtocolClIncomingCloseCall함수를 호출한다.

NdisClIncomingCallComplete함수의 호출은 NDIS가 CM의 ProtocolCmIncomingCallComplete함수를 호출하도록 한다. NDIS는 입력 파라미터들로써 NdisClIncomingCallComplete함수의 클라이언트 제공 파라미터들을 ProtocolCmIncomingCallComplete함수에게 넘겨준다.

만약 클라이언트가 NDIS_STATUS_SUCCESS이외의 다른 상태의 설정으로 제안된 호출을 거절한다면, 클라이언트는 NdisClIncomingCallComplete함수의 호출이 발생하자마자 CallParameters포인터를 타당하지 않은것으로 간주한다.

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