CO_MEDIA_PARAMETERS

typedef struct _CO_MEDIA_PARAMETERS{

    ULONG    Flags;

    ULONG    ReceivePriority;

    ULONG    ReceiveSizeHint;

    CO_SPECIFIC_PARAMETERS MediaSpecific;

} CO_MEDIA_PARAMETERS, *PCO_MEDIA_PARAMETERS;

CO_MEDIA_PARAMETERS 구조체는 전형적으로 아래 연결 지향 NIC 미니포트에 대한 미디어 매개변수들을 지정하기 위해 콜 매니저에 의해 사용되어진다. 미니포트는 특정 미디어 매개변수들로 VC를 활성화하거나 혹은 VC를 위한 자원들을 예약한다.

멤버

Flags
플래그들은 하나나 그 이상(OR 연산)의 값이다. 다음과 같은 것들이 있다:

RECEIVE_TIME_INDICATION
설정될 때, 미니포트는 각 수신된 패킷을 위해 out-of-band 데이터 블럭내에 TimeReceived 멤버에 채우기 위해 NDIS_SET_PACKET_TIME_RECEIVED 매크로를 사용해야 한다.

USE_TIME_STAMPS
설정될 때, 미니포트는 각 전송된 패킷을 위해 out-of-band 데이터 블럭내에 TimeSent 멤버를 채우기 위해 NDIS_SET_PACKET_TIME_SENT 매크로를 사용해야 한다. 만약 미디엄이 타임 스탬프들을 지원하지 않는다면은, 미니포트는 이 플래그를 무시해야 한다.

TRANSMIT_VC
설정될 때, 미니포트에 의해 활성화된 VC는 데이터를 전송하기 위해 사용될 것이다라는 것을 인디케이트한다.

RECEIVE_VC
설정될 때, 미니포트에 의해 활성화된 VC는 데이터를 수신하기 위해 사용될 것이다라는 것을 인디케이트한다.

INDICATE_ERRED_PACKETS
설정될 때, 미니포트는 클라이언트에게 에러들(체크섬 에러들과 같은)을 포함하는 수신 패킷들을 인디케이트 해야 한다. 그렇지 않는다면은, 미니포트는 클라이언트에게 알리는 것 없이 그러한 패킷들을 무시해야 한다.

INDICATE_END_OF_TX
설정될 때, 미니포트는 패킷의 전송이 마친후에, 단지 패킷을 위해 NdisMCoSendComplete 함수를 호출해야 한다. 그렇지 않는다면은, 예를 들어 프로토콜 제공 데이터를 NIC 버퍼에 전송한 후에 곧 NdisMCoSendComplete 함수를 호출할 수 있다.

RESERVE_RESOURCES_VC
설정될 때, 콜 매니저는 미니포트가 VC를 위해 필요한 모든 자원들(버퍼들과 같은)을 예약하는 것을 요구하고 있다. 미니포트는 MiniportCoActivateVc 함수가 클리어된 이러한 플래그로 호출되어질 때까지 VC를 활성화할 필요가 없다.

ROUND_DOWN_FLOW
설정될 때, 미니포트는 만약 지정된 정확한 값이 지원될 수 없다면은 가장 가까운 지원된 값에 각 미디어 특정 흐름 매개변수(대역폭과 같은)을 round down 해야 한다. NdisMCoActivateVcComplete 함수에 대한 호출에서, 미니포트는 각 라운드된 값을 위해 사용된 실제 값 (MediaSpecific 매개변수들에 버퍼들내에)을 리턴해야 한다.

ROUND_UP_FLOW
설정될 때, 미니포트는 만약 지정된 정확한 값이 지원될 수 없다면은 가장 가까운 지원된 값을 각 미디어 특정 flow 매개변수(대역폭과 같은)의 값을 round up을 해야 한다. NdisMCoActivateVcComplete 함수에 대한 호출에서, 미니포트는 각 라운드된 값을 위해 사용된 실제 값을(MediaSpecific 매개변수들 버퍼들내에) 리턴해야 한다.

ReceivePriority
이 값은 현재 예약중이다.

ReceiveSizeHint
들어오는 패킷들의 바이트로 크기를 지정한다. 이 멤버는 공통적으로 최대 SDU 크기에 대해 설정되어진다.

MediaSpecific
사용된 특정 미디엄에 지정된 정보를 포함하는 버퍼화된 CO_SPECIFIC_PARAMETERS 구조체를 가리킨다.

주석

    버퍼화된 CO_MEDIA_PARAMETERS 구조체의 주소는 CO_CALL_PARAMETERS 구조체의 멤버이다. CO_MEDIA_PARAMETERS 구조체는 모든 연결 지향 미니포트들에 대해 관심이 있는 일반적인 미디어 매개변수들을 포함한다. CO_MEDIA_PARAMETERS 매개변수는 또한 미디엄을 제어하는 특정 미니포트에 대한 그리고 특정 네트워크 미디엄에 적용되는 미디엄 특정 매개변수들을 지정한다.

    다음은 연결 지향 NDIS 연산들에서 미디어 매개변수들의 역할을 설명한다.

    Making an Outgoing Call

    항상 콜 매니저는 NdisClMakeCall 함수에 대한 클라이언트 호출에 의해 제공된 그리고 콜 매니저의 ProtocolCmMakeCall 함수에 전달되어지는 일반적인 콜 매니저 매개변수들로부터 나가는 호출을 위해 미디어 매개변수들을 유도한다. 콜 매니저는 CO_MEDIA_PARAMETERS을 채우고 Ndis(M)CmActivateVc 함수를 호출한다. 미니포트는 MiniportCoActivateVc 함수내에 CO_MEDIA_PARAMETERS 구조체를 수신하고 VC을 위해 자원들을 예약하거나 VC를 활성화하기 위해 미디어 매개변수들을 사용한다.

    아래 미디엄을 인식하는 클라이언트는 NdisClMakeCall 함수를 호출하기 전에 CO_MEDIA_PARAMETERS 구조체를 채울 수 있다. 만약 클라이언트가 또한 CO_CALL_PARAMETERS 구조체내에 PERMANENT_VC 비트를 설정한다면은, 콜 매니저는 미니포트에게 해석안된 콜 매개변수들을 Ndis(M)CmActivateVc 함수로 미니포트에게 전달할 수 있다.

    Indicating an Incoming Call

    콜 매니저가 클라이언트에 의해 등록된 SAP에 들어오는 호출을 감지할 때, 시그널링 메시지로 수신된 매개변수들을 클라이언트를 위한 콜 매니저 매개변수들 그리고 미니포트를 위한 미디어 매개변수들에 맵한다. 콜 매니저는 미디어 특정 매개변수들을 미니포트에 전달하기 위해 Ndis(M)CmActivateVc 함수를 호출한다. 콜 매니저는 Ndis(M)CmDispatchIncomingCall 함수로 들어오는 호출의 클라이언트의 클라이언트에게 알리기 전에 이것을 한다.

    Request to Change Call Parameters for a VC

    VC를 위한 콜 매개변수들을 변화하기 위한 요구가 성공적으로 클라이언트와 네트워크에 있는 리모트 entity 사이에 협상되었을 때, 콜 매니저는 호출을 위해 VC를 다시 활성화해야 한다. 콜 매니저는 미디어 매개변수들의 수정된 것들을 미니포트에게 Ndis(M)CmActivateVc 함수를 사용하여 보낸다.

    Adding a Party to a Call

    만약 아래 네트워크 미디엄(예로, ATM)은 멀티 포인트 VC들에 대해 party 당 트래픽 매개변수들을 지원하지 않는다면은, 콜 매니저는 호출에 대한 party를 추가할 때 VC를 위해 콜 매개변수들을 변화하기 위한 클라이언트 요구가 실패할 것이다. 이러한 경우에, party를 추가하는 것은 미디어 매개변수들과 관련이 없다.

    만약 아래 네트워크 미디엄이 멀티포인트 VC들에서 party당 트래픽 매개변수들을 지원한다면은, 클라이언트는 추가된 어떤 새로운 party을 위해 새로운 콜 매개변수들을 지정할 수 있다. NdisClAddParty 함수에 대한 호출에서, 클라이언트는 콜 매니저가 새로운 party를 위한 미디어 매개변수들에 번역되어지는 일반적인 콜 매니저 매개변수들 을 포함할 수 있고 클라이언트는 콜 매니저가 미니포트에 해석안되고 전달하는 새로운 party를 위한 미디어 매개변수들을 포함할 수 있다.