NdisClAddParty

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

NdisClAddParty함수는 클라이언트의 다수의 VC에 party를 더한다.

매개변수

NdisVcHandle

NdisCoCreateVc함수에 의해 리턴되는 VC핸들의 포인터.

ProtocolPartyContext

만약 호출이 성공적이라면 클라이언트가 party당 상태를 유지하는 호출자 제공 상주 컨텍스트 영역에대한 핸들을 지정한다.

CallParameters

만약 호출이 성공이라면 호출자가 party당 상태를 유지할 호출자가 할당한 상주 컨텍스트 영역의 핸들을 지정한다.

NdisPartyHandle

만약 추가된 party의 연산이 성공이라면, NDIS에의해 설정된 변수의 포인터.

리턴값

NdisClAddParty함수가 NDIS_STATUS_PENDING이외의 다른 어떤것을 리턴할때, 클라이언트는 내부적으로ProtocolClAddPartyComplete함수를 호출하도록 해야한다. 그렇지 않으면, 이 연산이 완료됐을때, NDIS는 클라이언트의 ProtocolClAddPartyComplete함수를 호출한다.

주석

NdisClAddParty를 호출하기전에, 클라이언트는 NdisClMakeCall로 VC에대한 멀티포인터 연결을 설정해야만한다. 추가된 party에대한 컨텍스트 영역을 할당하고 초기화할뿐만아니라. 클라이언트는 일반적으로 그들이 NdisClAddParty를 호출할때, ProtocolPartyContext로써의 컨텍스트 영역의 핸들을 넘기고 NdisPartyHandle파라미터로써으 ㅣ컨텍스트 영역내의 변수의 포인터를 넘긴다.

NdisClAddParty함수의 호출은 NDIS로하여금 이요청을 클라이언트가 주어진 NdisVcHandle을 공유하는것으로의 콜메니저의 ProtocolCmAddParty함수로 포워드 하도록 한다. 콜메니저는 즉시 에러상태를 리턴하든가, 보다 일반적으로 만약 이 요청이 안정적으로 시도됐다면 NDIS_STATUS_PENDING을 리턴한다. 만약 그 시도가 리모트 엔드포인트 혹은 하위 닉 드라이버에게 거절되면,Ndis(M)CmAddPartyComplete함수를 호출했을때, 콜메니져는 NDIS_STATUS_FAILURE와 같은 에러 상태를 리턴한다. 클라이언트의 ProtocolClAddPartyComplete함수는 처리하기전에 NDIS_STATUS_SUCCESS에대한 입력 상태값을 확인해야만한다.

하위 네트웍 미디엄은 클라이언트가 멀티포인트 VC에대한 party당 트래픽 파라미터를 지정할수 있느지를 결정한다. 예를들어, 멀티포인트 VC에서의 트래픽 파라미터들은 ATM네트웍에서의 모든 party들에대해 확인한다. ATM네트웍에서의 클라이언트가 NdisClAddParty함수를 호출할때, CallParameters에서의 대역폭과같은 트래픽 파라미터는 그러한 이미 NdisClMakeCall로 클라이언트에의해 처음으로 설정된 멀티포인트 VC에대한 성립된것을 매치해야만한다. 클라이언트가 순차적으로 그 미니포트 VC에 추가한 각 party에대해, ATM 콜매니저는 같은 트래픽 파라미터들을 사용한다. 그래서 클라이언트는 단지 새로운 어들레싱 정보만을 지정할 필요가 있고 NdisClAddParty에대한 CallParameters에서의 이미 성립된 멀티포인트 VC의 트래픽 파라미터들을 지정할 필요가있다.

ATM과 같은 하위 네트웍 미디엄이 멀티포인트 VC들에대한 party당 트래픽 파라미터들을 가지고 있지않다면,클라이언트가 그 VC에대해 이미 성립된 트래픽 파라미터들을 매치하지않는 CallParameters의 지정으로 party를 추가하는 시도를 할때마다 콜 매니저는 다음중 하나를 할수 있다. :

• 새로운 party를 추가하는 요청을 거절한다.
• 그 VC로의 party를 성공적으로 추가했을때, 그 멀티 포인트에대해 그런 이미 성립된 트래픽 파라미터를 리셋한다.
• 새로운 party를 성공적으로 추가했을때 VC의 모든 party에대한 트래픽 파라미터를 바꾼다.

교대로, NDIS는 다음에 호출에서 클라이언트 제공 ProtocolPartyContext핸들을 이 새롭게 추가된 party, ProtocolClAddPartyComplete함수의 호출을 포함하는, 클라이언트의 ProtocolClXxx함수로 넘겨준다.

멀티포인트 호출이 클라이언트가 바인딩된 하위 닉 드라이버의 미디엄에 의존하는 party당 트래픽 파라미터들로 direction 그리고/혹은 party당 트랜스퍼에서의 트랜스퍼를 허용하든안하든(애매). NdisPartyHandle은 멀티포인트 VC보다는 단지 NdisClAddParty의 성공적인 호출에의해 추가된 지정된 party만을 나타낸다. 결과적으로, 클라이언트는 ProtocolPartyContext영역을 단지 순차적인 party지정 콜-매니지먼트 요청에 대해서만 사용할수있다. party당 트랜스포 혹은 트래픽 파라미터를 지원하지않는 네트웍 미디엄에 걸친 데이타 전송에대해서, 클라이언트는 NdisVcHandle을 대신 사용할수 있다. 예를들어, ATM네트웍에대해, 클라이언트가 데이타를 성립된 멀티포인트 연결을 나타내는 VC에대한 특별한 party를 배제적으로 보내는 방법은 없다.

NdisClAddParty의 호출자는 IRQL <= DISPATCH_LEVEL에서 동작되어질수있다.