NdisClMakeCall

NDIS_STATUS NdisClMakeCall( IN NDIS_HANDLE NdisVcHandle, IN OUT PCO_CALL_PARAMETERS CallParameters, IN NDIS_HANDLE ProtocolPartyContext OPTIONAL, OUT PNDIS_HANDLE NdisPartyHandle OPTIONAL );

NdisClMakeCall함수는 클라이언트가 만든 VC에대한 나가는 호출을 설정한다.

매개변수

NdisVcHandle

NdisCoCreateVc의 선행하는 호출에의해 리턴된 핸들을 지정한다.

CallParameters

만약 호출자에의해 지원되는 네트웍 미디엄과 어드레스 패밀리가 QoS특성들을 허용한다면 호출자가 호출, 잠복, 대역폭, 서비스 질에대한 타겟 어드레스와 같은 이 연결에대한 특성을 지정한것에대한 CO_CALL_PARAMETERS타입의 구조체의 포인터.

ProtocolPartyContext

추가적으로 클라이언트가 멀티포인트 VC에대한 처음party에대한 party당 상태를 유지할것에대한 상주 컨택스트 영역에대한 호출자 제공 핸들을 지정한다. 이 파라미터는 만약 주어진 VC가 멀티포인트 연결을 나타내지 않는다면 NULL이다. 멀티포인트 VC에대해, NDIS는 이핸들을 다시 이 특별한 party에게 영햐을 미치는 모든 순차적인 호출들내의 클라이언트의 ProtocolClXxx함수에게 넘겨준다.

NdisPartyHandle

만약 나가는 호출을 설정하는것에대한 요청이 성공이라면, NDIS 멀티포인트 연결에대한 처음 party를 나타내는 핸들을 리턴하는것에서의 일반적으로 호출자 할당 party컨텍스트 영역내의 호출자 제공 변수의 포인터.

리턴값

NdisClMakeCall함수는 NDIS_STATUS_PENDING이외의 다른것을 리턴할때, 클라이언트는 ProtocolClMakeCallComplete함수의 내부적인 호출을 해야만한다. 그렇지않으면, NDIS는 클라이언트의 ProtocolClMakeCallComplete함수를 이연산이 완료됐을때 ProtocolClMakeCallComplete함수를 호출한다.

주석

NdisClMakeCall함수는 클라이언트가 초기화한 나가는 호출에대한 클라이언트가 생성한 VC의 특성을 설정한다. 클라이언트는 나가는 호출을 만들기위한 시도를 하기전에 NdisCoCreateVc로 VC를 설정해야만한다.

NdisClMakeCall의 호출은 NDIS가 이 요청을 클라이언트가 주어진 NdisVcHandle을 공유하느것으로 콜 메니저의 ProtocolCmMakeCall함수에게 포워드하도록 한다. CM은 주어진 데이타가 CallParameters에 맞다는것에대한 책임이 있다. 적절한 네트웍 컴포넌트들과 협상하면서 그것은 이 클라이언트 제공 데이타를 수정할 수있고, 클라이언트가 처음에 NdisClMakeCall에게 준것과 다른 트래픽 파라미터들을 리턴할수 있다. 클라이언트의 ProtocolClMakeCallComplete함수는 수정된 콜 파라미터를 받아들이는것에대한 책임을 진다. 만약 이것이 발생하거나 혹은 호출을 해제하는것에대해 만약 CM이 제안한 콜파라미터가 받아들일수 없다면.

결과적으로, CallParameters에서 데이타가 적어도 콜 설정동안에 대해서 콜 매니저를 이용할수 있도록 남겨두어야만 한다. NdisClMakeCall이 NDIS_STATUS_PENDING를 리턴할때, 클라이언트는 이 버퍼를 해제할 수없다. ProtocolClMakeCallComplete함수가 호출될때까지 이 클라이언트 할당 리소스들을 해제하는것을 지연해야만한다.

만약 NdisClMakeCall함수가 멀티포인트 연결을 설정한다면, 클라이언트는 주어진 VC에대해 글로벌리하게 트래픽 파라미터들을 설정하고 있다, 만약 하위 네트웍 미디엄이 party당 트래픽 파라미터들을 지원하지 않는다면. 예를들어 아주 많은 party들일지라도 클라이언트는 순차적으로 NdisClAddParty함수로 ATM멀티포인트 VC에 추가한다. 이러한 party들은 모두 그들의 멀티포인트 연결에대한 같은 트래픽 파라미터들을 공유할 것이다. ATM네트웍에서의 클라이언트는 대역폭, QoS, 그리고 party 기본당 CallParameters들을 지정하지않는다. 추가적으로, 만약 ATM네트웍에서의 클라이언트가 성립된 멀티포인트 VC에대한 QoS를 NdisClModifyCallQoS함수로 바꾼다면, 그 변화는 멀티포인트 VC의 모든 party에 영향을 준다.

클라이언트가 NdisPartyHandle에 리턴된 핸들을 사용하기전에, 클라이언트의 ProtocolClMakeCallComplete함수는 NDIS_STATUS_SUCCESS에대한 입력 Status를 채크한다. 만약 콜 메니저가 멀티 포인트 연결의 호출을 설정하는 요청을 실패하면, 이 클라이언트 제공 변수의 값은 타당하지 않다.

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