ProtocolCmAddParty

NDIS_STATUS ProtocolCmAddParty( IN NDIS_HANDLE CallMgrVcContext, IN OUT PCO_CALL_PARAMETERS CallParameters, IN NDIS_HANDLE NdisPartyHandle, OUT PNDIS_HANDLE CallMgrPartyContext );

ProtocolCmAddParty 함수는 존재하는 멀티포인트 호출에 대한 파티를 추가하기 위해 미디어 특정 매개변수들을 설정하고 새로운 파티를 위해 상태 데이터를 저장하고 파티가 호출에 추가되도록 하는데 필요한 함수이다.

매개변수

CallMgrVcContext

콜 매니저는 VC당 상태를 유지하는 콜 매니저 할당 컨텍스트 영역에 대한 핸들을 지정한다. 콜 매니저는 ProtocolCoCreateVc 함수로부터 NDIS에게 이 핸들을 제공한다.

CallParameters

존재하는 호출에 추가되는 파티를 위해 연결 지향 클라이언트에 의해 지정된 매개변수들을 포함하는 CO_CALL_PARAMETERS 구조체를 가리킨다.

NdisPartyHandle

존재하는 가상 연결에 추가되는 멀티포인트 파티를 유일하게 가리키는 NDIS에 의해 제공된 핸들을 지정한다. 이 핸들은 콜 매니저에게 불분명하고 NDIS 라이브러리 사용을 위해 예약된다.

CallMgrPartyContext

리턴값으로 콜 매니저가 멀터포인트 호출을 위해 이러한 파티에 대해 상태를 유지하는 콜 매니저 제공 컨텍스트 영역에 대한 핸들을 지정한다.

리턴값

ProtocolCmAddParty 함수는 다음과 같은 하나값으로 연산들의 상태를 리턴한다.

NDIS_STATUS_SUCCESS

콜 매니저는 성공적으로 파티에 대한 상태를 유지하기 위해 필요한 자원들을 할당하고 성공적으로 호출에 대한 파티가 추가되었다는 것을 가리킨다.

NDIS_STATUS_PENDING

콜 매니저가 비동기적으로 파티를 추가하기 위한 요구가 완성할 것이라는 것을 가리킨다. 콜 매니저가 파티를 추가하기 위해 모든 연산들을 완성할 때, 이러한 연산이 완성됐다는 것을 NDIS에게 신호화하기 위해 NdisCmAddPartyComplete 함수를 호출해야 한다.

NDIS_STATUS_RESOURCES

콜 매니저는 연결에 대한 파티를 추가하기 위해 자원들을 할당할 수 없고 초기화할 수 없다는 것을 가리킨다.

NDIS_STATUS_NOT_SUPPORTED

콜 매니저가 호출자가 CallParameters인 호출 매개변수들에서 유효하지 않거나 이용할 수 없는 특징들을 요구하기 때문에 멀티포인트 호출에 대한 파티를 추가할 수 없거나 이러한 콜 매니저에 의해 제공된 미디어 타입이 멀티 포인트 호출들을 지원하지 않는다는 것을 가리킨다.

주석

ProtocolCmAddParty는 동적 자원들과 콜 매니저가 멀티 포인트 호출에 추가되는 NdisPartyHandle로 지정된 파티에 대한 상태 정보를 유지하기 위해 요구된 구조체들의 어떤 필요한 할당을 행한다. 그러한 자원들은 제한적이지 않지만 메모리 버퍼들, 데이터 구조체들, 이벤트들, 다른 유사한 자원들을 포함할 수 있다. 콜 매니저들은 또한 이러한 함수에서 파티당 구조체들을 초기화해야 한다.

콜 매니저가 할당하는 파티당 상태 영역에서 콜 매니저는 미래 호출들을 유한 참조들을 위해 NdisPartyHandle에 의해 지정된 핸들을 저장해야 한다. 콜 매니저가 파티당 상태 정보를 할당하고 초기화를 마친 후, 상태 버퍼의 주소는 NDIS에게 제어를 리턴하기 전, 상태 버퍼의 주소는 CallMgrPartyContext 핸들로 설정되어져야 한다. 이렇게 하기 위해, 핸들을 참조해제하고 핸들의 값으로 상태 버퍼에 대한 포인터를 저장한다. 예로:

*CallMgrPartyContext = SomeBuffer;

ProtocolCmAddParty 함수는 IRQL DISPATCH_LEVEL에서 실행할 수 있도록 쓰여져야 한다.