NdisCmDispatchIncomingCall 함수(ndis.h)

아티클
02/07/2025

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를 만들었습니다.
네트워크를 통해 허용되는 호출 매개 변수에 대해 협상하거나 원격 노드에서 보낸 호출 매개 변수를 수락했을 수 있습니다.
NdisCmActivateVcVC를 활성화하여 기본 미니포트 드라이버가 협상되거나 허용된 호출 매개 변수에 따라 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)