NdisClCloseAddressFamily

NDIS_STATUS NdisClCloseAddressFamily( IN NDIS_HANDLE NdisAfHandle );

NdisClCloseAddressFamily함수는 클라이언트가 바인딩된 특별한 닉에대한 클라이언트 프로토콜과 콜매니져 혹은 등록된 AF의 MCM 사이의 연관을 해제한다.

매개변수

NdisAfHandle

NdisClOpenAddressFamily에의해 리턴된 NDIS제공 핸들을 지정한다.

리턴값

NdisCloseAddressFamily함수가 NDIS_STATUS_PENDING이외의 어떤다른것을 리턴했을때, 클라이언트는 ProtocolClCloseAfComplete함수에대한 내부적인 호출을 만든다. 반면에 이 연산이 완료됐을때, NDIS는 클라이언트의 ProtocolClCloseAfComplete함수를 리턴한다(애매).

주석

NdisClCloseCall 그리고/혹은 NdisClDeregisterSap의 호출로 바인딩에대한 클라이언트의 열린 모든 VC들을 닫은후, 클라이언트는 일반적으로 클라이언트의 ProtocolUnbindingAdapter함수로부터 NdisClCloseAddressFamily함수를 호출한다.

클라이언트가 바인딩된 하위 닉이 머신으로 부터 제거되거나 재 구성될때마다, NDIS는 클라이언트의 ProtocolUnbindAdapter함수를 호출한다. 하위 닉 미니포트의 PnP재구성은 콜 매니저 혹은 MCM 미니포트로하여금 닉에대해 지원하는 어드레스 패밀리를 재등록 하도록 한다. 교대로 이것은 클라이언트의 ProtocolCoAfRegisterNotify함수에대한 다음의 호출을 야기시킨다. 또다른 시나리오에서, 클라이언트의 ProtocolUnbindAdapter함수는 하위 닉 드라이버에 의존하여 현재 사용되고있는 어떤 뚜렷한(애매) NdisAfHandle로 NdisClCloseAddressFamily를 호출해야만 한다.

일반적인 가이드 라인에서처럼, 클라이언트는 ProtocolUnbindAdapter함수가 NdisCloseAdapter함수를 호출하기전에, 닉 미니포트를 통한 연결지향 통신에대해 할당한 모든 리소스들을 해제해야만한다.

NdisAfHandle함수는 이 호출이 일어나자마자 클라이언트에대해 타당하지 않게 하기위해 NdisClCloseAddressFamily함수에게 넘긴다.

NdisClCloseAddressFamily함수의 호출자는 IRQL <= DISPATCH_LEVEL에서 동작될수 있다.