NdisMCmCloseCallComplete 매크로(ndis.h)

아티클
08/07/2023

NdisMCmCloseCallComplete는 이전에 MCM 드라이버가 NDIS_STATUS_PENDING 반환한 클라이언트 요청의 최종 상태 반환하여 호출을 중단합니다.

구문

void NdisMCmCloseCallComplete(
   _S_,
   _VH_,
   _PH_
);

매개 변수

_S_

MCM 드라이버가 연결을 닫는 클라이언트 요청의 최종 상태 지정합니다(NDIS_STATUS_SUCCESS 또는 호출자가 결정한 NDIS_STATUS_XXX(NDIS_STATUS_PENDING 제외).

_VH_

호출에 대한 VC에 대한 핸들을 지정합니다. 이 핸들은 NdisMCmCreateVc 가 있는 MCM 드라이버 또는 ProtocolCoCreateVc 함수에 대한 입력 매개 변수로 VC를 원래 만들 때 NDIS에서 제공했습니다.

_PH_

NdisVcHandle이 지점 간 VC 또는 다중 포인트 연결의 마지막 남은 파티에 대한 핸들을 나타내는 경우 NULL을 지정합니다. 이 핸들은 MCM 드라이버가 CallMgrPartyContext가 지정한 파티별 상태에서 가져온 입력 매개 변수로 전달됩니다. ProtocolCmCloseCall 함수입니다.

반환 값

없음

설명

MCM 드라이버의 ProtocolCmCloseCall 함수가 NDIS_STATUS_PENDING 반환하는 경우 NdisMCmCloseCallComplete 를 호출하여 클라이언트 및 NDIS에 연결 끊기 시도가 성공적으로 또는 오류로 인해 완료되었음을 알려야 합니다. NdisMCmCloseCallComplete를 호출하면 NDIS가 클라이언트의 ProtocolCloseCallComplete 함수를 호출합니다.

NDIS_STATUS_SUCCESS 상태로 전달하는 경우 MCM 드라이버는 NdisMCmCloseCallComplete를 호출하는 즉시 네트워크를 통해 전송할 수 없는 NdisVcHandle(및 NdisPartyHandle,있는 경우)을 고려해야 합니다. MCM 드라이버가 원래 VC를 만든 경우 방금 NdisMCmCloseCallComplete에 전달한 것과 동일한 NdisVcHandle을 사용하여 NdisMCmDeleteVc를 호출해야 합니다. 클라이언트가 이 VC를 만든 경우 MCM 드라이버는 를 사용하여 ProtocolCoDeleteVc 함수에 대한 호출을 기대할 수 있습니다.
ProtocolVcContext- 동일한 NdisVcHandle을 입력 매개 변수로 저장한 VC별 상태를 지정합니다.

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

요구 사항

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