ProtocolCmMakeCall
NDIS_STATUS
ProtocolCmMakeCall(
IN NDIS_HANDLE CallMgrVcContext,
IN OUT PCO_CALL_PARAMETERS CallParameters,
IN NDIS_HANDLE NdisPartyHandle OPTIONAL,
OUT PNDIS_HANDLE CallMgrPartyContext OPTIONAL
);
|
ProtocolCmMakeCall 함수는 가상 연결(VC)을 위한 미디어 특정 매개변수들을 설정하고 가상 연결을 활성화는 데 필요한 함수이다.
매개변수
- CallMgrContext
- 콜 매니저들은 VC당 상태를 유지하는 콜 매니저 할당 컨텍스트 영역에 대한 핸들을 지정한다. 콜 매니저는 이 핸들을 ProtocolCoCreateVc 함수로부터 NDIS에 대한 핸들을 제공한다.
- CallParameters
- 이러한 나가는 호출을 위해 연결 지향 클라이언트에 의해 지정된 매개변수들을 포함하는 CO_CALL_PARAMETERS 구조체를 가리킨다.
- NdisPartyHandle
- 유일하게 멀티포인트 가상 연결에서 초기 파티를 지정하는 NDIS에 의해 제공된 핸들을 지정한다. 이 핸들은 콜 매니저에게 불분명하고 NDIS 라이브러리 사용을 위해 예약된다. 이 핸들은 만약 클라이언트가 나가는 멀티포인트 호출을 설정하지 않으면 NULL이다.
- CallMgrPartyContext
- 리턴하자마자, 콜 매니저는 멀티포인트 호출에 대한 초기 파티에 대해 상태를 유지하는 콜 매니저 제공 컨텍스트 영역에 대한 핸들을 지정한다. 만약 NdisPartyHandle이 NULL이라면, 이 핸들은 NULL로 설정될 것이다.
리턴값
ProtocolCmMakeCall 함수는 다음과 같은 값들 중 하나로서 연산들의 상태를 리턴한다.
- NDIS_STATUS_SUCCESS
- 콜 매니저가 성공적으로 호출을 하는 필요한 자원들을 할당하고 미니포트 드라이버와 가상 연결을 활성화할 수 있다는 것을 가리킨다.
- NDIS_STATUS_PENDING
- 콜 매니저가 비동기적으로 호출을 하는 것에 대한 요구를 완성할 것이라는 것을 가리킨다. 콜 매니저가 호출을 하는 모든 연산들을 완성할 때, 이러한 호출이 완성되었다는 것을 NDIS에게 신호화하기 위해 NdisCmMakeCallComplete 함수를 호출해야 한다.
- NDIS_STATUS_RESOURCES
- 콜 매니저는 클라이언트에 의해 요구된 가상 연결을 활성화하기 위해 자원들을 할당하고 초기화할 수 없다는 것을 가리킨다.
- NDIS_STATUS_NOT_SUPPORTED
- 콜 매니저는 CallParameters에 지정된 호출 매개변수들내에 호출자가 유효하지 않거나 이용할 수 없는 특징들을 요구하기 때문에 가상 연결을 활성화할 수 없다는 것을 가리킨다.
주석
만약 ProtocolCmMakeCall 함수는 외연적인 NdisPartyHandle이 제공된다면, 이러한 VC는 멀티포인트 호출을 위해 클라이언트에 의해 만들어진다. 콜 매니저는 상태 정보를 유지하고 멀티포인트 호출을 제어하기 위해 요구되는 필요한 자원들을 할당하고 초기화해야 한다. 그러한 자원들은 다음과 같은 것으로 제한적인지 않지만 메모리 버퍼들, 데이터 구조체들, 이벤트들, 다른 유사한 자원들을 포함한다. 만약 콜 매니저가 상태 영역을 위한 필요한 자원들을 할당할 수 없거나 초기화할 수 없다면, NDIS_STATUS_RESOURCES로 NDIS에게 제어를 리턴해야 한다.
ProtocolCmMakeCall 함수는 필요하다면 로컬 노드와 CallParameters로 지정된 호출 매개변수들을 토대로 리모트 노드 사이에 연결을 하기 위해 네트워크 제어 장치들 혹은 다른 미디어 특정 actors들과 통신한다. 그러한 행동들은 다음과 같은 것으로 제한적이지 않지만, 스위칭 하드웨어와 통신, 네트워크 제어 스테이션과 통신 혹은 네트워크 미디엄에 대한 적당한 다른 행동들을 포함할 수 있다.
만약 콜 매니저가 네트워크 하드웨어와 통신이 필요로 되어진다면(네트워크 스위치 등등) ProtocolBindAdapter 함수로 설립한 네트워크 제어 장치와 가상 연결을 사용해야 한다. 콜 매니저들은 NdisCoSendPackets 함수를 호출함으로써 미니포트 드라이버를 통해 그들의 네트워크 하드웨어 와 통신한다. 통합된 호출 관리 지원을 하는 NIC 미니포트들은 NdisCoSendPackets 함수들을 호출하지 않고 오히려 그들 자신이 데이터를 전송할 것이다.
이 호출이 멀티포인트 호출이면, 콜 매니저가 미디엄에 의해 요구된 것처럼 네트워킹 하드웨어와 모든 필요한 통신을 행하고 콜 매개변수들을 검증하고 파티당 상태 데이터를 할당하고 초기화한 후, 상태 블럭의 주소는 NDIS에게 제어를 리턴하기 전에 CallMgrPartyContext 핸들내에 설정되어야 한다. 핸들은 핸들을 참조하는 것을 해제함으로써 설정되고 핸들의 값으로 상태 블럭에 대한 포인터를 저장함으로써 설정된다. 예로 :
*CallMgrPartyContext = SomeBuffer;
만약 ProtocolCmMakeCall 함수가 네트워크을 우한 필요한 연산들이 완성되고 VC가 성공적으로 NdisCmActivateVc을 통해 활성화된다면, ProtocolCmMakeCall 함수는 STATUS_SUCCESS의 상태로 가능한 한 빨리 제어를 리턴해야 한다.
ProtocolCmMakeCall 함수가 NDIS에게 제어를 리턴한 후, 콜 매니저는 설정된 이러한 호출로 더 이상의 어떤 행동을 기대하지 말아야 한다. ProtocolCmMakeCall 함수는 연결을 설립하기 위한 책임이 있고 그래서 클라이언트는 이러한 VC를 통해 네트워크를 걸쳐 데이터 전송들을 할 수 있다. 그러나 호출 매니저는 계속적으로 호출의 서비스 질을 수정하기 위해 만약 이것이 멀티 포인트 VC이면 파티들을 추가하거나 드롭하기 위해, 궁극적으로 이러한 호출을 종료하기 위해 호출될 수 있다.
ProtocolCmMakeCall 함수는 IRQL DISPATCH_LEVEL에서 실행될 수 있도록 쓰여져야 한다.
|