NdisCmAddPartyComplete

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

NdisCmAddPartyComplete함수는 콜 매니저가 이전에 NDIS_STATUS_PENDING을 리턴한것에 대한 성립된 멀티포인트 VC에 party를 추가하기위한 클라이언트의 요청에 마지막 상태를 리턴한다.

매개변수

Status

콜 매니저의 추가 party연산의 마지막 상태를 지정한다. NDIS_STATUS_SUCCESS 혹은 NDIS_STATUS_PENDING를 제외한 어떤 NDIS_STATUS_XXX

NdisPartyHandle

party를 확인하는 핸들을 지정한다. 이 핸들은 콜 매니저의 ProtocolCmAddParty함수의 입력이다.

CallMgrPartyContext

만약 추가-party연산이 성공한다면, 콜 매니저가 party당 상태 정보를 유지할 호출자 할당 상주 컨택스트 영역에대한 핸들을 지정한다. 그렇지 않으면, 이 파라미터는 무시되기때문에 NULL이다.

CallParameters

추가되는 party에대해 원래 클라이언트에의해 지원된는 콜 파라미터를 포함하는 CO_CALL_PARAMETERS타입 구조체의 포인터

주석

만약 독립적인 콜매니저의 ProtocolCmAddParty함수가 NDIS_STATUS_PENDING를 리턴한다면, CM은 클라이언트와 NDIS에게 멀티포인트 VC에 party를 추가하는 시도가 완료했다는것을 알리기위해,성공인지 에러인지, NdisCmAddPartyComplete함수를 호출해야만한다.

만약 클라이언트가 CallParameters에 트래픽 파라미터들내에 멀티 포인트 VC에대해 이미 성립된 매치되지않는것을 넘겼을때, 네트웍 미디엄에의해 강요되는 어떤 강제성을하에 콜매니저의 설계자가 어떻게 이 상황을 다루느냐에 의존한다. 다음을 포함할 가능성이 있다.:

• 만약 하위 네트웍 미디엄이 멀티 포인트 VC들에대해 이 특징을 지원하지 않는다면 party당 트래픽 파라미터들을 설정한다.
• 처음 나가는 호출이 CM이 Status로서 NDIS_STATUS_SUCCESS로 NdisCmAddPartyComplete함수를 호출하지전에 만들어질때, VC에대해 성립된 클라이언트 제공 트래픽을 리셋한다.
• CM이 NdisCmAddPartyComplete함수를 Status로써 NDIS_STATUS_SUCCESS로 호출하기전에 모든 현재 연결된 party에대해 VC에대한 트래픽 파라미터들을 클라이언트 제공 변수들로 바꾼다.
• party를 추가하는 클라이언트의 시도를 실패한다. (이 선택은 강제적으로 클라이언트로 하여금 그들의 트래픽 파라미터를 NdisClMakeCall함수로 멀티 포인트 VC에대해 설정하도록 강요하고 주어진 멀티 포인트 VC에대한 NdisClAddParty의 각 순차적인 호출에서 같은 트래픽 파라미터를 지정하도록 한다.)

만약 CM이 NDIS_STATUS_SUCCESS로 Status를 설정한다면, NdisCmAddPartyComplete함수를 호출할때 CallMgrPartyContext로써 CM할당 party당 상태 영역에대한 포인터를 사용하는 실제적인 핸들을 제공해야만한다.

NdisCmAddPartyComplete함수의 호출은 NDIS가 클라이언트의 ProtocolClAddPartyComplete함수의 호출을 야기한다.

프로토콜로써 NDIS로 그들을 등록 하는 독립적인 콜 메니저만이 NdisCmAddPartyComplete함수를 호출할수있다. 통합적인 콜 매니저 지원을 제공하는 연결지향 닉 미니포트는 대신에 NdisMCmAddPartyComplete함수를 호출한다.

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