NdisClIncomingCallComplete 함수(ndis.h)

아티클
02/29/2024

NdisClIncomingCallComplete 는 클라이언트의 ProtocolClIncomingCall 함수가 이전에 NDIS_STATUS_PENDING 반환한 제공된 수신 호출에 대한 클라이언트의 수락 또는 거부를 반환합니다.

구문

void NdisClIncomingCallComplete(
  [in] NDIS_STATUS         Status,
  [in] NDIS_HANDLE         NdisVcHandle,
  [in] PCO_CALL_PARAMETERS CallParameters
);

매개 변수

[in] Status

클라이언트가 제공된 호출을 수락하는 경우 NDIS_STATUS_SUCCESS 로 설정됩니다. 그렇지 않으면 이 매개 변수를 NDIS_STATUS_PENDING 제외한 모든 NDIS_STATUS_XXX 로 설정하여 호출을 거부하는 클라이언트 결정 이유를 나타낼 수 있습니다.

[in] NdisVcHandle

호출 관리자가 들어오는 호출을 나타내기 위해 만든 VC에 대한 핸들을 지정합니다. 클라이언트는 의 입력 매개 변수로 전달된 ProtocolVcContext 에 의해 지정된 VC별 상태에서 이 핸들을 획득했습니다. ProtocolClIncomingCall 함수입니다.

[in] CallParameters

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

반환 값

없음

설명

클라이언트의 ProtocolClIncomingCall 함수가 이전에 NdisClRegisterSap을 사용하여 클라이언트에 의해 등록된 특정 SAP에서 들어오는 제공된 호출에 대해 NDIS_STATUS_PENDING 반환하는 경우 클라이언트는 이후에 NdisClIncomingCallComplete 를 호출하여 제공된 호출을 수락하거나 거부하는지 여부를 나타내야 합니다.

NdisClIncomingCallComplete를 호출하기 전에 이러한 클라이언트는 NdisClModifyCallQoS를 한 번 이상 호출하여 두 드라이버가 수신 통화에 대해 허용되는 서비스 품질에 대한 합의에 도달하거나 클라이언트가 QoS를 수정하려는 시도가 규약을 생성하지 않고 일부 클라이언트 결정 제한에 도달하기 때문에 제공된 호출을 거부해야 한다고 결정할 때까지 통화 관리자와 협상할 수 있습니다.

클라이언트가 ProtocolClIncomingCall 함수에 전달된 호출 매개 변수를 변경한 경우 NdisClIncomingCallComplete에 이러한 변경 내용을 전달할 때 CALL_PARAMETERS_CHANGED CO_CALL_PARAMETERS 구조의 Flags 멤버를 설정해야 합니다. 호출 관리자가 호출 매개 변수에 대한 클라이언트의 제안된 변경 내용을 수락하거나 거부하는지 여부에 따라 NDIS는 이후에 클라이언트 중 하나를 호출합니다. ProtocolClCallConnected 함수 또는 해당 함수 ProtocolClIncomingCloseCall 함수는 각각 입니다.

NdisClIncomingCallComplete를 호출하면 NDIS에서 CM을 호출합니다. ProtocolCmIncomingCallComplete 함수입니다. NDIS는 NdisClIncomingCallComplete 의 클라이언트 제공 매개 변수를 ProtocolCmIncomingCallComplete에 입력 매개 변수로 전달합니다.

클라이언트가 상태를 NDIS_STATUS_SUCCESS 이외의 항목으로 설정하여 제공된 호출을 거부하는 경우 클라이언트는 NdisClIncomingCallComplete에 대한 호출이 발생하는 즉시 CallParameters 포인터가 잘못된 것으로 간주해야 합니다.

요구 사항

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