NdisMCmAddPartyComplete

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

NdisMCmAddPartyComplete함수는 성립된 다중 포인트 VC에대해 PARTY를 추가하기위해 MCM드라이버가 이전에 NDIS_STATUS_PENDING을 리턴했던것에대한, 클라이언트의 요청에대한 최종 상태를 리턴한다.

매개변수

Status

MCM미니포트의 PARTY추가 연산의 최종 상태를 지정한다. NDIS_STATUS_SUCCESS 혹은 NDIS_STATUS_PENDING를 제외한 다른 NDIS_STATUS_XXX.

NdisPartyHandle

party를 확인하는 핸들을 지정한다. MCM드라이버는 이핸들을 ProtocolCmAddParty함수에대한 입력 파라미터로써 이핸들을 얻는다.

CallMgrPartyContext

만약 파티를 추가하는 연산이 성공하면 MCM드라이버는 파티 지정 상태 정보를 유지하게될 호출자 할당 상주 컨택스트 영역에대한 핸들을 지정한다.

CallParameters

클라이언트에의해 최초로 제공되는, 추가되어질 파티에대한 콜 파라미터들을 포함하는 CO_CALL_PARAMETERS타입 구조체의 포인터.

주석

만약 MCM드라이버의 ProtocolCmAddParty함수가 NDIS_STATUS_PENDING를 리턴한다면, 드라이버는 NdisMCmAddPartyComplete함수는 순차적으로 클라이언트와 NDIS에게 성공인지 드라이버 의존 에러 상태를 가지는지 다중포인터VC에대한 파티를 추가하기위한 시도가 완료됐다는것을 알리기위해 NdisMCmAddPartyComplete함수를 호출해야만 한다.

하위 네트웍 미디엄은 클라이언트가 멀티포인트 VC에대한 파티당 트래픽 파라미터들을 지정할수 있는지를 결정한다. 예를들어, 멀티포인트 VC에대한 트래픽 파라미터들은 ATM네트웍에대한 모든 파티들에대해 똑같다.

만약 하위 네트웍 미디엄이, ATM과같이, 멀티포인트 VC들에대한 파티당 트래픽 파라미터들을 지원하지 않는다면, MCM드라이버는 클라이언트가 그 VC에대해 이미 성립된 트래픽 파라미터들을 매치되지 않는 CallParameters에 지정된 값으로 파티를 추가하려고 시도할때 한번(애매) 을 할수 있다.:

• 그 VC를 추가하는데 성공할때, 멀티 포인트VC에대해 이미 성립된 트래픽 파라미터들을 리셋한다.
• 새로운 파티를 추가하는데 성공할때, 그 VC에서의 모든 파티에대해 트래픽 파라미터들을 바꾼다.
• 새로운 파티를 추가하는 요청은 거절한다. (이 선택은 클라이언트로하여금 NdisClMakeCall함수로 멀티포인트 VC에대한 그들의 트래픽 파라미터들을 절대적으로 설정하도록하고 주어진 멀티포인트 VC에대해 NdisClAddParty함수의 각 순차적인 호출에서 같은 트래픽 파라미터들을 지정하도록 한다.)

NdisMCmAddPartyComplete함수에대한 호출은 NDIS로하여금 클라이언트의ProtocolClAddPartyComplete함수를 호출하도록 한다.

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

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