ProtocolClCloseAfComplete

VOID ProtocolClCloseAfComplete( IN NDIS_STATUS Status, IN NDIS_HANDLE ProtocolAfContext );

모든 연결 지향 NDIS 클라이언트들은 그들이 NdisClCloseAddressFamily 함수로 초기화한 비동기 연산들을 완성하기 위해 ProtocolClCloseAfComplete 함수들을 가져야 한다.

매개변수

Status

다음과 같은 값들중 하나가 될 수 있는 주소 패밀리를 닫기 위한 클라이언트 초기 요구의 마지막 상태를 지정한다.

NDIS_STATUS_SUCCESS

주소 패밀리는 닫혀진다. 클라이언트가 ProtocolAfContext 영역에 저장한 열린 주소 패밀리를 표시하는 NdisAfHandle은 지금 유효하지 않다.

NDIS_STATUS_FAILURE

AF는 클라이언트가 AF를 닫는 시도하기 전에 해제해야 하는 관련된 VC들 혹은 등록된 SAP들을 가지거나 클라이언트는 NDIS가 AF 상태가 "closing"으로 표시된 것을 발견하기 때문에 두번 NdisClCloseAddressFamily 함수를 호출한다.

ProtocolAfContext

AF당 컨텍스트 영역에 대한 클라이언트 제공 핸들을 지정한다. 클라이언트는 원래 이 컨텍스트 영역을 설정하고 NdisClOpenAddressFamily 함수로 NDIS에게 이 핸들을 전달한다.

주석

열린 주소 패밀리로 발생한 VC들과 등록된 SAP들이 없다는 것을 확실히 한후, 클라이언트는 그 자체와 콜 매니저 그리고 특히 아래 NIC 사이에 관계를 지우기 위해 NdisClCloseAddressFamily 함수를 호출한다. NDIS는 클라이언트가 원래 비동기 연산으로 주소를 열기 위해 사용된 콜 매니저를 위해 ProtocolCmCloseAf 함수를 호출한다. NdisClCloseAddressFamily 함수를 호출한 후, 클라이언트는 NdisAfHandle이 유효하지 않다는 것으로 여긴다.

결과적으로, 클라이언트는 NDIS가 비동기 close-AF 연산이 행해질 때 호출하는 ProtocolClCloseAfComplete 함수를 가져야 한다. 만약 입력 Status가 NDIS_STATUS_SUCCESS 이면, 클라이언트는 AF당 컨텍스트 영역을 해제할 수 있다.

ProtocolClCloseAfComplete 함수는 IRQL DISPATCH_LEVEL에서 실행할 수 있도록 쓰여져야 한다.