NdisMSetMiniportSecondary
NDIS_STATUS
NdisMSetMiniportSecondary(
IN NDIS_HANDLE MiniportAdapterHandle,
IN NDIS_HANDLE PrimaryMiniportAdapterHandle
);
|
NdisMSetMiniportSecondary 함수는 특정 미니포트 어댑터를 우선 미니포트 어댑터에 관계해서 두번째 역할을 하도록 설정한다. 우선 미니포틍 어댑터는 모든 패킷 전송들을 처리하고 프로토콜 드라이버들에 의해 행하는 정보의 요구들을 처리한다.
매개변수
- MiniportAdapterHandle
- 전에 MiniportInitialize 함수에 대한 미니포트 어댑터 입력에 대한 핸들을 지정한다.
- PrimaryMiniportAdapterHandle
- MiniportInitialize 함수를 초기화했던 우선 미니포트 어댑터에 대한 핸들을 지정한다.
리턴값
NdisMSetMiniportSecondary 함수는 다음과 같은 값을 리턴할 수 있다. :
- NDIS_STATUS_SUCCESS
- 미니포트 어댑터는 우선 미니포트 어댑터에 대한 두번째 역할로 설정된다. 미니포트 드라이버는 연속해서 두번째 미니포트 어댑터에서 우선 역할로 promote한다.
- NDIS_STATUS_FAILURE
- 두번째 역할로 초기화된 미니포트 어댑터를 설정하는 시도가 실패한다.
주석
프로토콜 드라이버들은 단지 미니포트 드라이버의 우선 어댑터로 바인드할 수 있다. 미니포트 드라이버의 두번째 어댑터들에 대한 바인딩들은 끊긴다.(tear down)
미니포트 드라이버는 미니포트의 MiniportInitialize 함수내로부터 두번째 미니포트 어댑터의 초기화하는 동안 NdisMSetMiniportSecondary 함수를 호출할 수 있다. 이러한 호출에서, 미니포트 드라이버는 MiniportAdapterHandle 매개변수로 초기화된 미니포트 어댑터에 대한 핸들과 이미 PrimaryMiniportAdapterHandle 매개변수로 초기화된 우선 미니포트 어댑터의 핸들을 전달한다. 우선 미니포트 어댑터는 프로토콜 드라이버들에 의해 만들어진 정보를 위한 요구들과 모든 패킷 전송들을 다룬다. 그러나, NDIS는 특정 요구들을 두번째 미니포트 어댑터에 보낼 수 있다. 예를 들어, NDIS는 그러한 미디어 연결를 위해 모든 미니포트 어댑터들을 쿼리한다. 두번째 미니포트 어댑터는 이러한 쿼리를 처리해야 하고 응답해야 한다.
두번째 미니포트 어댑터의 초기화 후에, 미니포트 드라이버는 두번째 미니포트 어댑터에서 우선 역할(미니포트 어댑터)로 promote하기 위해 NdisMPromoteMiniport 함수를 호출할 수 있다.
미니포트가 NdisMsetMiniportSecondary 함수를 호출하기 전에, 만약 초기화된 미니포트 어댑터가 미니포트 어댑터의 미니포트 bundle의 부분이라면은 처음 결정되야 한다. 미니포트 드라이버는 이 번들을 사용하여 각 미니포트 어댑터가 실행하는 work load를 균형잡고 만약 우선 미니포트 어댑터가 실패한다면은 두번째 어댑터가 정보 요구들과 패킷 전송들을 양도받도록 할 수 있다. 이러한 능력은 load balancing 과 fail over(LBFO)라고 불린다. 예로, 만약 미니포트 드라이버의 우선 어댑터가 실패한다면은, 미니포트 드라이버는 시스템으로부터 그리고 미니포트 드라이버의 번들로부터 우선 어댑터를 제거 하기 위해 NdisMRemoveMiniport 함수를 호출할 수 있다. 미니포트 드라이버는 그리고 나서 NdisMPromoteMiniport 함수를 호출해서 두번째 어댑터를 우선 역할로 promote 할 수 있다.
만약 초기화된 미니포트 드라이버가 미니포트 드라이버의 번들의 부분이라는 것을 결정하기 위해 미니포트 드라이버는 처음 미니포트 드라이버의 구성 매개변수들이 저장된 레지스트리 키를 위한 핸들을 얻기 위해 NdisOpenConfiguration 함수를 호출한다. 다음, 미니포트 드라이버는 미니포트의 레지스트리 키 아래에 있는 BundleIndentifier 키워드로부터 문자열 값(REG_SZ)을 검색하기 위해 NdisReadConfiguration 함수를 호출한다. 미니포트 드라이버는 문자열 값을 초기화된 미니포트 어댑터 특정 정보를 미니포트가 저장하는 미니포트 내부 구조체에 복사해야 한다.
초기화하는 동안, 미니포트 드라이버는 드라이버가 이미 동일한 bundle-indentifier 값을 가지는 인스턴스를 위치하기 위해 이미 초기화하는 모든 미니포트 어댑터 인스턴스들을 통해 찾아야 한다. 이러한 검색을 행하기 위해, 미니포트 드라이버는 각 인스턴스의 MiniportAdapterContext를 조사한다. 만약 드라이버는 match가 위치한다면은, NdisMSetMiniportSecondary 함수를 호출해야 하고 우선 혹은 두번째 미니포트 어댑터들을 위해 핸들들을 전달한다.
미니포트 드라이버는 NdisMSetMiniportSecondary 함수를 몇몇 미니포트 어댑터들의 연속적인 초기화동안 그들 모두 두번째 역할로 설정하기 위해 호출할 수 있다. 즉, 다중 두번째 미니포트 어댑터들은 번들내에 존재할 수 있다. NDIS는 단지 transports들에게 미니포트 드라이버의 우선 어댑터를 expose 할 것이다. 만약 transports(전송 계층) 들이 미니포트에게 패킷들을 보내기 요구한다면은 혹은 정보를 설정하거나 쿼리하도록 요구한다면은, NDIS는 이러한 요구들을 우선 어댑터를 사용하여 미니포트 드라이버에게 전달할 것이다. 미니포트 드라이버는 적당하게 이러한 요구들을 위해 LBFO를 제공해야 한다. 미니포트 드라이버는 단지 우선 어댑터로 핸들을 사용하여 네트워크으로부터 수신된 패킷들을 위로 인디케이트한다.
같은 미니포트 드라이버에 의해 초기화된 그리고 미니포트의 번들이 속한 미니포트 어댑터 인스턴스들은 MiniportMSetMiniportSecondary 함수를 호출할 수 있다.
미니포트 드라이버에 대한 LBFO 능력을 추가하는 정보에 대한 더 자세한 정보는 passthru 드라이버를 위한 readme를 봐라. 이러한 미니포트 드라이버는 Windows 2000 DDK내에 같은 인터미디엇 미니포트 드라이버이다.
NdisMSetMiniportSecondary 함수의 호출자들은 IRQL PASSIVE_LEVEL에서 실행한다.
|