ProtocolClAddPartyComplete
VOID
ProtocolClAddPartyComplete(
IN NDIS_STATUS Status,
IN NDIS_HANDLE ProtocolPartyContext,
IN NDIS_HANDLE NdisPartyHandle,
IN PCO_CALL_PARAMETERS CallParameters
);
|
멀티포인트 연결들을 설정하는 연결 지향 NDIS 클라이언트들은 그들이 NdisClAddParty로 초기화한 비동기 연산들을 완성하기 위해 ProtocolClAddPartyComplete 함수를 가져야 한다. 그렇지 않으면, 그러한 프로토콜 드라이버의 등록된 ProtocolClAddPartyComplete 함수는 간단히 제어를 리턴할 수 있다.
매개변수
- Status
다음과 같은 하나가 될 수 있는 클라이언트 초기화된 add-party 연산의 마지막 상태를 지정한다.
- NDIS_STATUS_SUCCESS
- 주어진 party가 클라이언트의 활성화한 멀티포인트 VC에 추가된다.
- NDIS_STATUS_RESOURCES
- NDIS는 새로운 party을 추적하기 위한 충분한 자원들을 할당할 수 없다.
- NDIS_STATUS_FAILURE
- 클라이언트는 NdisClAddParty 함수에 유효하지 않은 NdisVcHandle을 전달했다.
- NDIS_STATUS_XXX
- 콜 매니저의 ProtocolCmAddParty 함수는 party를 VC에 추가할 수 없는 이유를 가리키는 CM 결정 값을 리턴했다.
- ProtocolPartyContext
- 원래 NdisClAddParty에 전달된 클라이언트 제공 핸들을 지정한다.
- NdisPartyHandle
- Status가 NDIS_STATUS_SUCCESS라면, 이러한 NDIS 제공 핸들은 이러한 party에 관한 콜 매니저와 클라이언트 사이에 관계를 표시한다. 그렇지 않으면, party를 추가하는 시도가 실패되었고 클라이언트는 이러한 매개변수를 유효하지 않는 핸들로 여겨야 한다.
- CallParameters
- 원래 NdisClAddParty 함수에 대한 호출로 클라이언트에 의해 설정되지만 가능한 콜 매니저에 의해 계속해서 수정되는, 타입 CO_CALL_PARAMETERS의 구조체를 가리킨다.
주석
ProtocolClAddPartyComplete에 대한 호출은 클라이언트가 NdisClAddParty 함수를 호출할 때 초기화된 비동기 연산의 완성을 가리킨다. 만약 입력 Status가 NDIS_STATUS_SUCCESS외 다른 어떤것으로 설정되면, ProtocolClAddPartyComplete 함수는 CallParameters 와 ProtocolPartyContext에 클라이언트 할당 버퍼들을 해제할 수 있거나 다시 사용할 수 있다.
만약 party를 추가하는 시도가 성공적이면, ProtocolClAddPartyComplete 함수는 클라이언트의 ProtocolPartyContext 영역에 이러한 party와 관련한 NDIS 라이브러리 함수들에 대한 연속적인 호출들을 위해 입력 NdisPartyHandle을 저장해야 한다. 예로, 클라이언트는 만약 그것이 표시하는 리모트 party가 처음 연결을 닫지 않는다면, 결과적으로 NdisClDropParty 함수에 대한 이어진 호출에서 이러한 핸들을 전달해야 한다.
CallParameters 구조체는 원래 NdisClAddParty 함수에 대한 포인터를 전달하는 클라이언트에 의해 할당되고 초기화된다. 그러나, 콜 매니저는 클라이언트의 add-party 요구를 처리하는 동안 시그널링 peer와 혹은 네트워크과 CM 협상의 결과들을 반영하기 위한 클라이언트 제공 값들을 수정해야 할 것이다. 콜 매니저가 어떤 수정들을 할 것인지 결정하기 위해, ProtocolClAddPartyComplete 함수는 CALL_PARAMETERS_CHANGED가 설정되었는지 이러한 구조체의 Flags 멤버를 체크할 수 있다. 만약 그렇다면, ProtocolClAddPartyComplete 함수는 만약 CM의 수정들을 수락할 수 없는 것으로 발견되지 않는다면, ProtocolPartyContext를 이러한 호출을 위해 클라이언트가 유지하는 party당 상태를 업데이트해야 한다. 특정 시그널링 프로토콜은 클라이언트가 이러한 경우에 할 수 있는 것이 무엇인지 결정한다. 항상 클라이언트는 만약 CM 수정 콜 매개변수들이 수정할 수 없는 것으로 발견된다면 NdisClDropParty 함수를 호출한다.
콜 매니저의 시그널링 프로토콜에 의존하는, CallParameters 트래픽 매개변수들은 어떤 멀티포인트 연결에 대한 모든 파티들을 위해 동일할 수 있다. 즉, 그러한 콜 매니저의 클라이언트가 클라이언트가 원래 NdisClMakeCall로 설정한 멀티포인트 연결에 대한 파티들을 추가할 때, 각 파티의 타켓 주소를 제공할 수 있고 원래 NdisClAddParty 함수를 호출할 때마다 멀티포인트 VC를 위해 설정된 트래픽 매개변수들을 남긴다.
ProtocolClAddPartyComplete 함수는 IRQL DISPATCH_LEVEL에서 실행할 수 있게 하기 위해 쓰여져야 한다.
|