ProtocolUnbindAdapter
VOID
ProtocolUnbindAdapter(
OUT PNDIS_STATUS Status,
IN NDIS_HANDLE ProtocolBindingContext,
IN NDIS_HANDLE UnbindContext
);
|
ProtocolUnbindAdapter함수는 플러그앤 플레이를 지원하기위해 요구되어지는 함수이다.
매개변수
- Status
- NdisCloseAdapter함수의 리턴된값으로써 바인딩해제연산의 상태를 지정하고, 다음중 하나가 될 수 있다:
- NDIS_STATUS_SUCCESS
- 바이딩이 종료되고 그바인딩에 부속된 모든 리소스들이 해제 됐다.
- NDIS_STATUS_PENDING
- 요청이 비동기적으로 다뤄졌고 ProtocolCloseAdapterComplete함수가 연산을 종료 할 것이다.
- ProtocolBindingContext
- 프로토콜드라이버가 바인딩루틴당 상태를 유지하는 프로토콜할당 컨텍스트영역의 핸들을 지정한다. 드라이버는 NdisOpenAdapter함수를 호출했을때 이핸들을 제공한다.
- UnbindContext
- NDIS가 제공하고 프로토콜이 NdisCompleteUnbindAdapter함수에게 나중에 넘겨주는 핸들을 핸들을 지정한다.
주석
ProtocolBindAdapter함수의 반대로서, ProtocolUnbindAdapter함수는 하나의 가능한 예외를 제외하고 드라이버가 바인딩당네트웍 I/O연산에대해 할당한 리소스들을 해제한다. 예외=>ProtocolBindingContext핸들에의해 만들어진 드라이버할당 컨텍스트영역
ProtocolUnbindAdapter함수는 ProtocolBindingContext핸드로 드라이버의 ProtocolCloseAdapterComplete함수를 호출할수 있는 NdisCloseAdapter함수를 호출해야만 한다. 그래서 만약 NdisCloseAdapter함수가 NDIS_STATUS_SUCCESS를 리턴하지 않더라도, ProtocolUnbindAdapter함수는 ProtocolBindingContext의 메모리를 해제 할 수 없다.
결과적으로, ProtocolUnbindAdapter함수는 NdisCloseAdapter함수를 호출하기전에 입력UnbindContext핸들을 ProtocolBindingContext의 영역안에 저장해야한다. 만약 이호출이 비동기적이라면, ProtocolCloseAdapterComplete함수는 드라이버가 할당한 바인딩당 리소스들을 해제할것이며, UnbindContext핸들로 NdisCompleteUnbindAdapter함수를 호출할것이다.
NdisCloseAdapter함수가 NDIS_STATUS_SUCCESS를 리턴한다면, ProtocolUnbindAdapter함수는 드라이버가 할당한ProtocolBindingContext 메모리를 포함해서 모든 바인딩당 리소스들을 해제한다.
NDIS인터미디엇드라이버의 ProtocolUnbindAdapter함수는 반대되는 NdisIMDeinitializeDeviceInstance함수를 호출한다. 드라이버의 MiniportHalt같은 함수는 인터미디엇드라이버의 가상닉이 시스템으로 부터 제거되거전에 인터미디엇드라이버의닉과 관계된 모든 드라이버할당 리소스들을 해제해야만 한다.
ProtocolUnbindAdapter함수가 NdisCloseAdapter함수를 호출하자마자, NdisOpenAdapter함수에 의해 리턴된 원래NdisBindingHandle은 무효로 간주되어야 한다.
ProtocolUnbindAdapter함수는 이핸들로 어떤다음의 NdisXxx함수의 호출을 할 수 없고, 프로토콜은 하위드라이버로부터 어떤 리시브인디케이션을 받을 수 없다. 그러나 만약 하위닉이 재구성되기위해 제거되고 있다면, NDIS는 닉이 다시이용할수 있을때 바이딩을 다시 설정하기위해 드라이버의 ProtocolBindAdapter함수를 호출할 것이다.
디폴트로, ProtocolBindAdapter함수는 시스템스레드영역에서 PASSIVE_LEVEL로 동작한다.
|