PROTOCOL_CM_NOTIFY_CLOSE_AF_COMPLETE 콜백 함수(ndis.h)

아티클
08/07/2023

ProtocolCmNotifyCloseAfComplete 함수는 클라이언트가 독립 실행형 통화 관리자 또는 MCM(미니포트 호출 관리자)이 를 호출하여 시작한 AF(주소 패밀리)의 닫기를 완료했음을 나타냅니다. NdisCmNotifyCloseAddressFamily 또는 각각 NdisMCmNotifyCloseAddressFamily 함수입니다.

참고PROTOCOL_CM_NOTIFY_CLOSE_AF_COMPLETE 형식을 사용하여 함수를 선언해야 합니다. 자세한 내용은 다음 예제 섹션을 참조하세요.

구문

PROTOCOL_CM_NOTIFY_CLOSE_AF_COMPLETE ProtocolCmNotifyCloseAfComplete;

void ProtocolCmNotifyCloseAfComplete(
  [in] NDIS_HANDLE CallMgrAfContext,
  [in] NDIS_STATUS Status
)
{...}

매개 변수

[in] CallMgrAfContext

ProtocolCmOpenAf 함수에서 호출 관리자가 NDIS에 제공한 호출 관리자의 AF 컨텍스트 영역에 대한 핸들입니다.

[in] Status

AF 닫기 알림에 대한 클라이언트 최종 상태. 상태는 다음 중 하나일 수 있습니다.

NDIS_STATUS_SUCCESS

클라이언트가 주소 패밀리를 성공적으로 닫았습니다.

NDIS_STATUS_XXX

클라이언트가 드라이버로 결정된 이유로 요청을 실패했습니다.

반환 값

없음

설명

CoNDIS 호출 관리자에는 ProtocolCmNotifyCloseAfComplete 함수가 필요합니다.

독립 실행형 호출 관리자가 기본 미니포트 어댑터에서 바인딩을 해제하는 경우 호출 관리자는바인딩 해제하기 전에 NdisCmNotifyCloseAddressFamily가 작동합니다. MCM(미니포트 호출 관리자)이 미니포트 어댑터를 중지하는 경우 MCM은 다음을 호출해야 합니다. NdisMCmNotifyCloseAddressFamily 함수입니다.

NdisCmNotifyCloseAddressFamily 또는 NdisMCmNotifyCloseAddressFamily가 NDIS_STATUS_PENDING 반환하는 경우 NDIS는 클라이언트가 AF 닫기 작업을 완료한 후 ProtocolCmNotifyCloseAfComplete를 호출합니다.

NDIS는 IRQL <= DISPATCH_LEVEL ProtocolCmNotifyCloseAfComplete를 호출합니다.

예

ProtocolCmNotifyCloseAfComplete 함수를 정의하려면 먼저 정의 중인 함수의 형식을 식별하는 함수 선언을 제공해야 합니다. Windows는 드라이버에 대한 함수 형식 집합을 제공합니다. 함수 형식을 사용하여 함수를 선언하면 드라이버에 대한 코드 분석, SDV( 정적 드라이버 검증 도구 ) 및 기타 확인 도구에서 오류를 찾을 수 있으며 Windows 운영 체제용 드라이버를 작성하기 위한 요구 사항입니다.

예를 들어 " MyCmNotifyCloseAfComplete"라는 ProtocolCmNotifyCloseAfComplete 함수를 정의하려면 다음 코드 예제와 같이 PROTOCOL_CM_NOTIFY_CLOSE_AF_COMPLETE 형식을 사용합니다.

PROTOCOL_CM_NOTIFY_CLOSE_AF_COMPLETE MyCmNotifyCloseAfComplete;

그런 다음 다음과 같이 함수를 구현합니다.

_Use_decl_annotations_
VOID
 MyCmNotifyCloseAfComplete(
    NDIS_HANDLE  CallMgrAfContext,
    NDIS_STATUS  Status
    )
  {...}

PROTOCOL_CM_NOTIFY_CLOSE_AF_COMPLETE 함수 형식은 Ndis.h 헤더 파일에 정의되어 있습니다. 코드 분석 도구를 실행할 때 오류를 보다 정확하게 식별하려면 함수 정의에 Use_decl_annotations 주석을 추가해야 합니다. Use_decl_annotations 주석은 헤더 파일의 PROTOCOL_CM_NOTIFY_CLOSE_AF_COMPLETE 함수 형식에 적용되는 주석이 사용되는지 확인합니다. 함수 선언 요구 사항에 대한 자세한 내용은 NDIS 드라이버에 함수 역할 형식을 사용하여 함수 선언을 참조하세요.

Use_decl_annotations 대한 자세한 내용은 함수 동작 주석 지정을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	NDIS 6.0 이상에서 지원됩니다.
대상 플랫폼	Windows
헤더	ndis.h(Ndis.h 포함)
IRQL	<= DISPATCH_LEVEL

추가 정보

NdisCmNotifyCloseAddressFamily NdisMCmNotifyCloseAddressFamily

ProtocolCmOpenAf

Share via