NdisMCmActivateVc 함수(ndis.h)

아티클
02/29/2024

NdisMCmActivateVc 는 MCM 드라이버가 특정 VC에서 전송할 준비가 되었다는 것을 NDIS에 알린다.

구문

NDIS_STATUS NdisMCmActivateVc(
  [in] NDIS_HANDLE         NdisVcHandle,
  [in] PCO_CALL_PARAMETERS CallParameters
);

매개 변수

[in] NdisVcHandle

VC를 식별하는 핸들을 지정합니다.

[in] CallParameters

미니포트 드라이버가 활성화된 VC에 사용하는 모든 미디어별 매개 변수를 포함하는 CO_CALL_PARAMETERS 형식의 구조로 형식이 지정된 호출자 할당 버퍼에 대한 포인터입니다.

반환 값

NdisMCmActivateVc가 NDIS_STATUS_PENDING 이외의 항목을 반환하는 경우 MCM 드라이버는 내부 호출을 수행해야 합니다. ProtocolCmActivateVcComplete 함수입니다. 그렇지 않으면 이 작업이 완료되면 NDIS에서 MCM 드라이버의 ProtocolCmActivateVcComplete 함수를 호출합니다.

설명

NdisMCmActivateVc 는 MCM 드라이버가 새로 만든 VC에서 호출 및 미디어 매개 변수를 설정했거나 설정된 VC에서 호출 매개 변수를 변경했음을 NDIS에 알릴 수 있습니다.

MCM 드라이버는 VC에서 연결을 설정한 후 해당 VC에서 데이터를 보내거나 받기 전에 NdisMCmActivateVc 를 호출해야 합니다. 이 호출은 미니포트 드라이버가 VC에서 전송할 준비가 된 NIC를 만들었다는 것을 NDIS에 알린 것입니다.

클라이언트에서 시작한 발신 호출의 경우 MCM 드라이버는 일반적으로 NdisMCmMakeCallComplete로 나가는 호출 완료를 NDIS(및 클라이언트)에게 알리기 전에 원격 노드와의 협상된 계약 또는 스위치의 성공적인 호출 설정을 나타내는 핸드셰이크에 따라 NdisMCmActivateVc를 호출합니다. 들어오는 호출의 경우 MCM 드라이버는 일반적으로 NdisMCmCreateVc 를 성공적으로 호출한 후 호출하기 전에 NdisMCmActivateVc 를 호출합니다. NdisMCmDispatchIncomingCall.

드라이버 작성기는 MCM 드라이버에 발신 및 수신 호출에 대한 연결을 설정하는 컨텍스트에서 드라이버가 호출하는 (내부) MiniportCoActivateVc 함수가 있는지 여부를 결정합니다.

연결 기간 동안 MCM 드라이버는 호출 매개 변수를 네트워크 변경 및/또는 클라이언트가 NdisClModifyCallQoS를 호출할 때마다 조건으로 수정할 수 있습니다. MCM 드라이버는 새로 수정된 호출 매개 변수에 따라 VC에서 계속 전송할 수 있는 경우 호출 매개 변수에 대해 유지 관리하는 상태를 새 값으로 업데이트해야 합니다. 활성 VC에 대한 호출 매개 변수의 변경 내용을 NDIS에 알리려면 NdisMCmActivateVc 를 호출해야 합니다. 그렇지 않으면 MCM 드라이버는 다음 중 하나를 수행할 수 있습니다.

미니포트 드라이버가 VC에서 계속 전송할 수 없는 상태로 VC에 대한 QoS 또는 기타 호출 매개 변수를 수정하라는 클라이언트의 요청에 실패한 후 NdisMCmDeactivateVc 를 호출합니다.
호출 매개 변수를 이전에 허용된 상태로 복원하고, 변경 사항을 요청한 클라이언트에 알리고, VC에서 데이터를 계속 전송할 준비가 된 상태로 유지합니다. 이 경우 클라이언트에는 복원된 호출 매개 변수를 수락하거나 거부하여 VC를 종료하는 옵션이 있습니다.

통합 통화 관리 지원을 제공하는 연결 지향 미니포트 드라이버만 NdisMCmActivateVc를 호출할 수 있습니다. NDIS에 프로토콜 드라이버로 등록하는 독립 실행형 통화 관리자는 대신 NdisCmActivateVc 를 호출합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista에서 NDIS 6.0 및 NDIS 5.1 드라이버(NdisMCmActivateVc(NDIS 5.1 참조))에 대해 지원됩니다. Windows XP의 NDIS 5.1 드라이버(NdisMCmActivateVc(NDIS 5.1 참조))에 대해 지원됩니다.
대상 플랫폼	데스크톱
머리글	ndis.h(Ndis.h 포함)
라이브러리	Ndis.lib
IRQL	<= DISPATCH_LEVEL
DDI 규정 준수 규칙	Irql_MCM_Function(ndis)