NdisClIncomingCallComplete 함수(ndis.h)

아티클
04/20/2022
읽는 데 4분 걸림

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에 대한 핸들을 지정합니다. 클라이언트는 ProtocolClIncomingCall 함수에 입력 매개 변수로 전달된 ProtocolVcContext에 의해 지정된 VC별 상태에서 이 핸들을 얻었습니다.

[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)