NdisMRemoveMiniport

NDIS_STATUS NdisMRemoveMiniport( IN NDIS_HANDLE MiniportAdapterHandle );

NdisMRemoveMiniport 함수는 미니포트 드라이버가 시스템으로부터 회복할 수 없다고 결정한 특정 미니포트 어댑터를 제거한다.

매개변수

MiniportAdapterHandle

미니포트 드라이버가 회복할 수 없다고 결정한 초기화된 어댑터에 대한 핸들을 서술한다.

리턴값

NdisMRemoveMiniport 함수는 다음중 하나를 리턴할 수 있다:

NDIS_STATUS_SUCCESS

미니포트 어댑터가 제거됐다.

NDIS_STATUS_FAILURE

미니포트 어댑터를 제거하는 시도가 실패했다.

주석

만약 미니포트 드라이버가 특정 미니포트 어댑터가 실패하고 회복될 수 없다는 것을 결정했을 때 미니포트 드라이버는 시스템으로부터 어댑터를 제거하기 위해서 NdisMRemoveMiniport 함수를 호출할 수 있다. 이 호출에서 미니포트 드라이버는 제거되는 어댑터에 대한 핸들을 전달한다.

각각의 미니포트 어댑터가 운반하는 작업 로드의 균형을 유지하고 주된 미니포트 어댑터가 실패한다면 둘째의 미니포트 어댑터로 하여금 패킷 전송과 정보 리퀘스트를 할 수 있게 하기 위해서 미니포트 드라이버는 미니포트 어댑터의 묶음을 사용한다. 이 능력은 LBFO(load balancing and fail over)라고 불린다. 예를들어 미니포트 드라이버의 주된 어댑터가 실패한다면 미니포트 드라이버는 시스템으로부터 혹은 미니포트 드라이버의 묶음으로부터 주된 어댑터를 제거하기 위해서 NdisMRemoveMiniport 함수를 호출할 수 있다. 그리고나서 미니포트 드라이버는 둘째의 어댑터를 주된 역할로 승격시키기 위해서 NdisMPromoteMiniport 함수를 호출할 수 있다.

미니포트 드라이버가 처음 초기화한 미니포트 어댑터는 처음에는 주된 미니포트 어댑터이다. 주된 미니포트 어댑터는 패킷 전송과 정보에 대한 리퀘스트를 다룬다. 미니포트 드라이버는 몇몇 미니포트 어댑터의 순차적인 초기화 동안에 그들 모두를 둘째의 역할로 설정하기 위해서 NdisMSetMiniportSecondary 함수를 호출할 수 있다. 즉 여러개의 둘째 미니포트 어댑터는 묶음으로 존재할 수 있다.

미니포트 드라이버에 대한 추가적인 LBFO 능력에 대한 더 많은 정보는 passthru 드라이버의 readme를 봐라. 이 미니포트 드라이버는 Windows 2000 DDK의 인터미디엇 미니포트 드라이버의 예제이다.

NdisMRemoveMiniport 함수의 호출자는 IRQL <= DISPATCH_LEVEL에서 실행한다.