NdisMCmDispatchIncomingCloseCall 매크로(ndis.h)

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

NdisMCmDispatchIncomingCloseCall 은 일반적으로 MCM 드라이버가 네트워크에서 연결을 닫으라는 요청을 받았기 때문에 활성 또는 제공된 통화를 중단하라고 클라이언트에 지시합니다.

구문

void NdisMCmDispatchIncomingCloseCall(
   _S_,
   _H_,
   _B_,
   _Z_
);

매개 변수

_S_

연결 끊기 요청의 이유를 나타내는 호출자 결정 NDIS_STATUS_XXX를 지정합니다. 정상적인 네트워크 작업 중에 MCM 드라이버는 NDIS_STATUS_SUCCESS 전달하여 원격 당사자가 시작한 요청을 수신하여 활성 통화를 종료했음을 나타냅니다.

_H_

연결이 끊어진 호출의 VC에 대한 핸들을 지정합니다. 이 핸들은 NdisMCmCreateVc 를 사용하는 MCM 드라이버 또는 ProtocolCoCreateVc 함수에 대한 입력 매개 변수로 VC를 만들 때 NDIS에서 제공되었습니다.

_B_

추가 프로토콜별 연결 끊기 데이터가 포함된 호출자 할당 상주 버퍼에 대한 포인터입니다(있는 경우). 기본 매체에 따라 이 포인터는 NULL일 수 있습니다.

_Z_

버퍼가 NULL이면 버퍼의 크기(바이트)를 0으로 지정합니다.

반환 값

없음

설명

정상적인 네트워크 작업 과정에서 MCM 드라이버는 원격 노드의 해당 클라이언트가 NdisCloseCall을 호출했기 때문에 CloseStatus가 NDIS_STATUS_SUCCESS 설정된 NdisMCmDispatchIncomingCloseCall을 호출합니다.

그러나 MCM 드라이버는 다음 중 하나가 발생하는 경우 NdisMCmDispatchIncomingCloseCall 을 호출할 수도 있습니다.

MCM 드라이버는 들어오는 호출 제안을 클라이언트에 알립니다. 미니포트 드라이버의 ProtocolCmIncomingCallComplete 함수가 클라이언트의 동의로 호출되면 해당 클라이언트가 수정한 입력 호출 매개 변수의 유효성을 검사합니다. ProtocolCmIncomingCallComplete 는 클라이언트가 연결에 대해 지원되지 않는 호출 매개 변수를 제안하고 있음을 확인하므로 NdisMCmDispatchIncomingCloseCall을 호출합니다.
중단된 네트워크 조건으로 인해 MCM 드라이버는 활성 호출을 중단해야 합니다. 예를 들어 이 클라이언트와 연결에 대한 원격 당사자 간의 연결에 대한 링크가 다운될 때 MCM 드라이버에 알림이 표시되면 미니포트 드라이버는 NdisCmDispatchIncomingCloseCall 을 호출하여 클라이언트가 이러한 끊어진 연결에서 추가 데이터 전송을 시도(또는 예상)하지 못하도록 합니다.

클라이언트가 NdisCloseCall 을 호출하여 VC를 비활성화한 후 VC의 원래 작성자는 VC를 삭제할 책임이 있습니다. 클라이언트가 NdisCoDeleteVc를 호출하여 NDIS가 MCM 드라이버의 ProtocolCoDeleteVc 함수를 호출하거나 MCM 드라이버가 NdisMCmDeactivateVc를 호출하고 생성된 VC와 연결된 추가 리소스를 해제한 후 NdisMCmDeleteVc를 호출합니다.

NdisMCmDispatchIncomingCloseCall을 호출하면 NDIS에서 클라이언트의 ProtocolClIncomingCloseCall 함수를 호출합니다.

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

요구 사항


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