CO_CALL_PARAMETERS

typedef struct _CO_CALL_PARAMETERS{

    ULONG                          Flags;

    PCO_CALL_MANAGER_PARAMETERS    CallMgrParameters;

    PCO_MEDIA_PARAMETERS           MediaParameters;

} CO_CALL_PARAMETERS, *PCO_CALL_PARAMETERS;

CO_CALL_PARAMETERS 연결지향 클라이언트, 콜매니저, MCM미니포트, 연결지향 NIC미니포트에의해 사용되는 콜파라미터들을 포함한다. 콜파라미터들은 outgoing call 셋업, outgoing call에 대한QoS 요청, incoming call에 대한 QoS알림, outgoing 이나 incoming call에 대한 VC 활성화, VC에 대한 콜파라미터의 변경 협상, 멀티포인트 콜에 새 party 추가를 위해 사용된다.

매개변수

Flags
Flags는 아래의 하나나 그이상이 될 수 있다. (ORed)

PERMANENT_VC
outgoing call을 만들 때 NdisClMakeCall을 호출하기 전에 콜매니저가 콜을 PVC로 만들어야 한다는 것을 알리기 위해 클라이언트는 이 플래그를 셋한다. 클라이언트가 미디어 파라미터를 기술하지 않는다면 콜매니저는 SAP로 구성된 PVC(outgoing call의 목적지 SAP와 부합하는)의 리스트를 찾는다. 클라이언트가 미디어 파라미터를 기술한다면 콜매니저는 구성된 PVC를 검색하지 않는다. 대신 콜매니저는 미디어 파라미터에서 클라이언트에의해 기술된 PVC를 사용한다. 콜매니저가 콜의 요구들에 부합하는 PVC를 찾는다면 콜매니저는 이 PVC를 사용하고 콜에서 PERMANENT_VC플래그를 셋하고 Ndis(M)CmMakeCallComplete에게 리턴한다. 콜매니저가 부합하는 PVC를 찾을 수 없다면 콜매니저는 NDIS_STATUS_FAILURE로 콜시도는 실패하게 된다.

클라이언트가 PERMANENT_VC플래그를 셋하지 않고, 미디어파라미터를 기술하지 않았다면 콜매니저는 항상 PVC의 리스트를 검색하게되므로 주의해야 한다. 콜매니저가 그런 PVC를 찾을 수 없다면 콜매니저는 outgoing call에 대해 SVC를 도입하기위해 시도한다.

Incoming call에서 PVC를 나타내는 호출, Ndis(M)CmDispatchIncomingCall에서 VC핸들이 클라이언트에게 넘겨진다면 콜 매니저는 이 플래그를 셋한다. 이것은 콜매니저가 클라이언트에의해 등록된 SAP에 부합하는 PVC를 찾았다는 것을 가리킨다.

CALL_PARAMETERS_CHANGED
Ndis(M)CmMakeCallComplete을 호출하기전에 CO_CALL_PARAMETERS안의 어떤 값이 콜 셋업처리하는 동안 네트웍이나 시그널링 피어와 협상의 결과 변화되었다면 콜매니저는 이 플래그를 셋한다.(콜셋업이 시그널링 프로세서에 의존하는 동안 그런 협상이 발생했을때나… Whether and when) 클라이언트는 변화된 파라미터를 결정하기위하여 CO_CALL_PARAMETERS와 그것의 내부구조체들을 조사해야한다. 시그널링 프로토콜에 의존할 때, 클라이언트는 NdisClModifyCallQoS를 호출함으로써 콜파라미터들에 대한 재협상을 시도하거나 NdisClCloseCall을 호출함으로써 콜을 해제해서 새로운 콜 파라미터를 시도할 수 있다.

QUERY_CALL_PARAMETERS
예약된 플래그

BROADCAST_VC
예약된 플래그

MULTIPOINT_VC
outgoing call을 할 때 NdisClMakeCall을 호출하기전에 클라이언트가 멀티포인트 연결의 root임을 알리기위해 클라이언트는 이 플래그를 셋할 수 있다.

incoming call에서 Ndis(M)CmDispatchIncomingCall을 호출하기전에 클라이언트가 멀티포인트 커넥션의 leaf임을 가리키기위해 콜매니저는 이 플래그를 셋할 수 있다.

CallMgrParameters
CO_CALL_MANAGER_PARAMETERS구조체 버퍼포인터

MediaParameters
CO_MEDIA_PARAMETERS구조체 버퍼포인터

주석

CO_CALL_PARAMETERS는 연결지향 클라이언트, 콜매니저, MCM미니포트, 연결지향 NIC미니포트에 의해 사용된 콜 파라미터를 포함한다 콜파라미터는 멀티포인트 콜에 party를 추가하기위해, VC에대한 콜파라미터의 변경요청을 위해, incoming calls이나 outgoing calls 에 대한 VC의 활성화를 위해, outgoing calls 셋업, incoming calls을 가리키기 위하여 사용된다.

CO_CALL_PARAMETERS의 flags는 클라이어트와 콜매니저에게 중요하다. 클라이언트는 NdisClMakeCall 을 호출하기전에CO_CALL_PARAMETERS의 flags를 셋할 수 있다. CALL_PARAMETERS_CHANGED(콜매니저는 네트웍상의 원격개체에의한 콜파라미터의 변경을 알리기위해 Ndis(M)CmMakeCallComplete을 호출하기전에 셋할 수 있다.)에 대해 제외해라. 콜매니저는 Ndis(M)CmDispatchIncomingCall을 호출하기 전에 플래그를 셋할 수 있다.

CO_CALL_PARAMETERS에의해 포인트된 콜매니저파라미터는 클라이언트와 콜매니저에게 중요하다. CO_CALL_MANAGER_PARAMETERS의 구조체에서 포함된 파라미터들은 기술된 시그널링 프로토콜과 프로토콜을 지원하는 콜 매니저에 이용될 뿐아니라 모든 콜매니저에게 이용되는 포괄적인 파라미터들을 기술할 수 있다. CO_CALL_MANAGER_PARAMETERS는 콜매니저가 outgoing call 셋업을 위해 사용하고 클라이언트가 incoming call을 받아들일 것인지 아닌지를 결정하기위하여 사용하는 콜파라미터들을 기술한다. 클라이언트는 VC에대한 콜파라미터의 변경을 요청하기위하여 그리고 콜매니저는 VC에대한 콜파라미터의 변경요청이 들어온 것을 알리기위해 CO_CALL_MANAGER_PARAMETERS를 사용한다. 멀티포인트 콜에 party를 추가할 때 클라이언트는 새 party의 주소를 기술하기위하여 CO_CALL_MANAGER_PARAMETER를 사용한다.

CO_CALL_PARAMETERS에서 미디어파라미터는 미니포트에게 중요하다. CO_MEDIA_PARAMETERS구조체에 포함된 미디어파라미터들은 기술된 미디엄과 미디엄을 제어하는 특정한 미니포트뿐 아니라 모든 미니포트에 이용되는 포괄적인 파라미터들을 포함할 수 있다. 전형적으로 콜매니저는 미니포트에게 미디어파라미터를 기술하기위해 CO_MEDIA_PARAMETERS를 사용한다. 미니포트는 기술된 미디어파라미터로 VC를 활성화하거나 VC에대한 자원을 예약한다.