NdisMCmActivateVc 함수(ndis.h)
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에서 전송을 계속할 수 있는 경우 호출 매개 변수에 대해 유지 관리하는 상태를 새 값으로 업데이트해야 합니다. NdisMCmActivateVc 호출하여 활성 VC에 대한 호출 매개 변수의 변경 내용을 NDIS에 알려야 합니다. 그렇지 않으면 MCM 드라이버는 다음 중 하나를 수행할 수 있습니다.
- VC에 대한 QoS 또는 기타 호출 매개 변수를 수정하라는 클라이언트의 요청에 실패하여 미니포트 드라이버가 VC에서 전송을 계속할 수 없는 상태로 NdisMCmDeactivateVc 호출합니다.
- 호출 매개 변수를 이전에 허용된 상태로 복원하고, 변경 사항을 요청한 클라이언트에 알리고, VC에서 데이터를 계속 전송할 준비가 된 상태로 유지합니다. 이 경우 클라이언트는 복원된 호출 매개 변수를 수락하거나 거부하여 VC의 닫기를 시작할 수 있습니다.
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | 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) |