NdisMCmDispatchIncomingCall 매크로(ndis.h)

아티클
08/07/2023

NdisMCmDispatchIncomingCall 은 이전에 해당 클라이언트가 MCM 드라이버에 등록한 SAP에서 들어오는 호출을 클라이언트에 알릴 수 있습니다.

구문

void NdisMCmDispatchIncomingCall(
   _SH_,
   _VH_,
   _CP_
);

매개 변수

_SH_

SAP를 식별하는 핸들을 지정합니다. NDIS는 클라이언트가 원래 NdisClRegisterSap라고 하고 MCM 드라이버가 이 핸들을 에 대한 입력 매개 변수로 가져올 때 이 핸들을 설정합니다. ProtocolCmRegisterSap 함수입니다.

_VH_

MCM 드라이버가 등록된 이 SAP로 전달되는 들어오는 호출 제안을 처리할 때 NdisMCmCreateVc 로 만든 VC를 식별하는 핸들을 지정합니다.

_CP_

VC에 대한 호출 및 미디어 매개 변수를 지정하는 형식 CO_CALL_PARAMETERS 구조체에 대한 포인터입니다.

반환 값

없음

설명

NdisMCmDispatchIncomingCall을 호출하기 전에 MCM 드라이버는 이미 다음을 수행했습니다.

네트워크를 통해 수신한 호출(실제로 연결 요청)에 대해 이전에 특정 클라이언트에 의해 등록된 대상 SAP를 식별했습니다.
NdisMCmCreateVc를 사용하여 들어오는 호출에 대한 VC를 만들었습니다.
네트워크를 통해 허용되는 호출 매개 변수에 대해 협상하거나 원격 노드에서 보낸 호출 매개 변수를 수락했을 수 있습니다.
협상되거나 수락된 호출 매개 변수에 따라 VC에서 전송할 준비가 되었음을 NDIS에 알리기 위해 NdisMCmActivateVc 를 사용하여 VC를 활성화했습니다.

MCM 드라이버가 NdisMCmDispatchIncomingCall을 호출하면 NDIS가 클라이언트의 ProtocolClIncomingCall 함수를 호출하게 되며, 이 함수 내에서 클라이언트는 요청된 연결을 수락하거나 거부합니다. 연결을 수락할지 여부를 결정한 후 클라이언트는 NdisClIncomingCallComplete를 호출합니다. 그러면 MCM 드라이버의 ProtocolCmIncomingCallComplete 함수를 호출합니다. 클라이언트가 호출을 수락하면 MCM 드라이버가 다음으로 호출합니다. NdisMCmDispatchCallConnected. 그렇지 않으면 제공된 호출이 거부되었음을 원격 노드에 알립니다.

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

요구 사항

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