NdisMPromoteMiniport

NDIS_STATUS NdisMPromoteMiniport( IN NDIS_HANDLE MiniportAdapterHandle );

NdisMPromoteMiniport 함수는 주된 미니포트 어댑터가 시스템에서 제거된 후에 둘째의 미니포트 어댑터를 주된 역할로 승격시킨다.

매개변수

MiniportAdapterHandle

초기화된 어댑터에 대한 핸들을 서술한다. 미니포트 드라이버는 이 미니포트 어댑터를 둘째의 역할로 설정하기 위해서 전에 NdisMSetMiniportSecondary 함수를 호출했다.

리턴값

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

NDIS_STATUS_SUCCESS

둘째의 미니포트 어댑터는 주된 역할로 승격되었다.

NDIS_STATUS_FAILURE

둘째의 미니포트 어댑터를 주된 역할로 승격시키는 시도가 실패했다.

주석

미니포트 드라이버는 주된 미니포트 어댑터가 시스템에서 제거된 후에 둘째의 미니포트 어댑터를 주된 역할로 설정하기 위해서 NdisMPromoteMiniport 함수를 호출할 수 있다. 이 호출에서 미니포트 드라이버는 둘째의 미니포트 어댑터로 핸들을 전달한다. 미니포트 드라이버는 이 미니포트 어댑터를 둘째의 역할로 설정하기 위해서 전에 NdisMSetMiniportSecondary 함수를 호출했다.

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

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

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

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