NdisCmDispatchIncomingCall 함수(ndis.h)

아티클
08/07/2023

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

구문

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

매개 변수

[in] NdisSapHandle

SAP를 식별하는 핸들을 지정합니다. NDIS는 클라이언트가 원래 NdisClRegisterSap이라고 하고 호출 관리자가 원래 이 핸들을 에 대한 입력 매개 변수로 가져온 경우 이 핸들을 설정합니다. ProtocolCmRegisterSap 함수입니다.

[in] NdisVcHandle

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

[in] CallParameters

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

반환 값

NdisCmDispatchIncomingCall이 NDIS_STATUS_PENDING 이외의 항목을 반환하는 경우 호출 관리자는 내부 호출을 수행해야 합니다. ProtocolCmIncomingCallComplete 함수입니다. 그렇지 않으면 NDIS는 이 작업이 완료되면 CM의 ProtocolCmIncomingCallComplete 함수를 호출합니다.

설명

NdisCmDispatchIncomingCall을 호출하기 전에 독립 실행형 호출 관리자가 이미 다음을 수행했습니다.

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

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

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

요구 사항

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