NdisOpenAdapter
VOID
NdisOpenAdapter(
OUT PNDIS_STATUS Status,
OUT PNDIS_STATUS OpenErrorStatus,
OUT PNDIS_HANDLE NdisBindingHandle,
OUT PUINT SelectedMediumIndex,
IN PNDIS_MEDIUM MediumArray,
IN UINT MediumArraySize,
IN NDIS_HANDLE NdisProtocolHandle,
IN NDIS_HANDLE ProtocolBindingContext,
IN PNDIS_STRING AdapterName,
IN UINT OpenOptions,
IN PSTRING AddressingInformation OPTIONAL,
);
|
NdisOpenAdapter 호출하는 프로토콜과 특정 아래 계층 NIC 드라이버와 NDIS 인터미디엇 드라이버와 바인딩을 설정한다.
매개변수
- Status
- 이 함수로부터 리턴하는 다음과 같은 값들중 하나가 될 수 있는 호출자 제공 변수를 가르킨다.
- STATUS_SUCCESS
- 요구된 바인딩이 설정되고 호출자는 NdisXxx에 대한 계속적인 호출에서 NdisBindHandle과 SelectedMediumIndex에 리턴된 값을 사용할 수 있다.
- NDIS_STATUS_PENDING
- 요구된 연산이 비동기적으로 처리가 되고, 호출자의 ProtocolOpenAdapterComplete 함수가 오픈이 완성됐을 때 호출되어진다.
- NDIS_STATUS_RESOURCES
- 요구된 연산이 NDIS가 충분한 메모리가 할당되어지지 않거나 오픈 바인딩을 추적하는데 사용되어지는 상태를 초기화하지 못했기 때문에 실패했다.
- NDIS_STATUS_ADAPTER_NOT_FOUND
- 요구된 연산이 AdapterName에서의 이름이 시스템 객체 네임스페이스에서 발견될 수 없기 때문에 실패했다.
- NDIS_STATUS_UNSUPPORTED_MEDIA
- MediumArray의 배열은 NDIS에서나 혹은 아래 계층 드라이버에 의해 지원하는 어떤 미디엄을 지정하지 않했다.
- NDIS_STATUS_CLOSING
- 호출자나 AdapterName에 지정된 물리적인 혹은 가상적인 장치가 닫했다.
- NDIS_STATUS_OPEN_FAILED
- 오픈 시도가 선행 특정 이유의 아무것도 없는 것 때문에 실패했다. 예를 들면, 가능한한 NDIS가 선택된 미디엄을 위해 필터 패키지가 초기화될 수 없다.
- OpenErrorStatus
- NdisOpenAdapter가 Status에서 에러를 리턴한다면은 더 많은 정보를 제공하는 NDIS_STATUS_XXX 에러를 포함할 수 있는 호출자 제공 변수를 가리킨다. 예를 들면, Token Ring NIC의 드라이버는 이러한 변수에 링 에러를 리턴할 것이다.
- NdisBindingHandle
- 호출자와 AdapterName에 지정된 주어진 물리적인 혹은 가상 NIC 사이에 성공적인 바인딩을 표현하는 핸들을 리턴하는 호출자 제공 변수를 가리킨다.
- SelectedMedimIndex
- NDIS는 아래 계층 NDIS 드라이버가 사용하는 미디어 타입을 지정하는 배열 요소 인덱스를 리턴하는 호출자 제공 변수를 가리킨다.
- MediumArray
- 호출자가 제공할 수 있는 미디어 타입을 지정하는 NDIS_MEDIUM 타입 값 배열을 가리킨다.
- NdisMedium802_3
- 이더넷(802.3) 네트워크를 지정한다.
- NdisMedium802_5
- 토큰링(802.5) 네트워크를 지정한다.
- NdisMediumFddi
- Fiber Distributed Data Interface(FDDI) 네트워크를 지정한다.
- NdisMediumWan
- wide area 네트워크를 지정한다. 이 타입은 다양한 형태의 point-to-point와 WAN NIC들을 커버한다. 마찬가지로 다양한 주소와 헤더 포맷들을 프로토콜 드라이버와 바인딩이 설립된 후 아래 계층 드라이버 사이에 교섭되어진다.
- NdisMediumLocalTalk
- LocalTalk 네트워크를 지정한다.
- NdisMediumDix
- 드라이버가 DIX 이더넷 헤더 포맷을 사용하기 위해 이더넷 네트워크를 지정한다.
- NdisMediumArcnetRaw
- ARCNET 네트워크를 지정한다.
- NdisMediumarcnet878_2
- ARCNET(878.2) 네트워크를 지정한다.
- NdisMediumAtm
- 이 값은 미래 사용을 위해 예약되었다. 현재 NIC드라이버들은 LAN 에뮬레이션을 통해 ATM을 지원한다. (LanE 1.0은 ATM 포럼 1.0 사양과 UNI 3.1 시그널링에서 정의되었다.) 그러한 드라이버는 NdisMedium802_3이나 NdisMedium802_5로서 미디어 타입을 보고해야 한다.
- NdisMediumWirelessWan
- wireless 네트워크를 지정한다. 이 타입은 NdisMediumIrda로 지정된 infrared wireless를 포함하지 않는 다양한 wireless media를 커버한다.
- NdisMediumIrda
- 이 값은 윈도우즈 NT 드라이버에서 미래 사용을 위해 예약되었다.
- MediumArraySize
- MediumArray에 요소 수를 지정한다.
- NdisProtocolHandle
- NdisRegisterProtocol에 의해 리턴된 핸들을 지정한다.
- ProtocolBindingContext
- 프로토콜이 바인딩이 설립된 후 이러한 바인딩에 대한 상태를 유지하는 호출자 제공 상주 컨텍스트 영역을 위한 핸들을 지정한다.
- AdapterName
- upper-edge(MiniportXxx) 함수들 집합에 익스포트된 아래 계층 NDIS 드라이버의 가상 어댑터나 NIC을 명명하는 시스템 디폴트 문자 셋으로 지정되어지는 숫자화된 문자열을 가리킨다. Windows NT 드라이버에 대해 이러한 숫자화된 문자열은 유니코드 문자들을 포함한다.
- OpenOptions
- NIC 드라이버로 추측되어지는 호출자가 다음 낮은 드라이버에 전달하는 플래그를 포함하는 비트마스크를 지정한다. 현재 이 매개변수는 시스템 사용으로 예약되어졌다.
- AddressingInformation
- NIC 드라이버가 넷카드에 프로그램하는 데 사용될 수 있는 아래 계층 NIC에 대한 특정 정보를 포함하는 선택적인 가변 길이 숫자화된 문자열을 가리킨다. 이 포인터는 NULL이 될 수 있다.
만약 제공되어진다면은, 어드레싱 정보는 open 연산이 완성될 때까지 유효하게 남아야 한다. 비동기 모뎀을 지원하는 아래 계층 NIC 드라이버는 다이얼링을 위해 이러한 정보를 사용할 수 있다.
주석
프로토콜 드라이버들은 그들의 DriverEntry나 ProtocolBindAdapter함수로부터 NdisOpenAdapter를 호출한다. NDIS 인터미디엇 드라이버들은 항상 그들의 ProtocolBindAdapter함수로부터 이 호출를 해야 한다.
AdapterName 문자열은 심지어 Status가 NDIS_STATUS_PENDING를 리턴해도 NdisOpenAdapter가 리턴할 때까지 단지 유효한 값으로 남는다.
NdisBindingHandle과 SelectedMediumIndex 변수들은 NdisOpenAdapter가 NDIS_STATUS_PENDING를 리턴한다면은 ProtocolOpenAdapterComplete함수가 호출될 때까지 무시되어질 수 있다. 이러한 변수들은 ProtocolOpenAdapterComplete이 호출되어질 때 유효하지 않은 값으로 남아 있기 때문에 그들은 스택에 있을 수 없다. 항상, 이러한 변수는 이 핸들이 ProtocolOpenAdapterComplete에 입력 매개변수일 때 ProtocolBindingContext 영역에 상주한다.
프로토콜 드라이버는 NdisProtocolHandle에 리턴된 핸들을 유지해야 한다. 그것은 드라이버가 앞으로 계속해서 호출할 다른 NdisXxx 함수들에게 필요한 매개변수가 된다. 제공된 ProtocolBindingContext는 호출자의 ProtocolXxx 함수들의 입력 매개변수이다.
호출자는 SelectedMediumIndex에 리턴된 값을 후에 호출하는 NdisRequest에서 사용한다. 요구 패킷에 설정된 OID들은 리턴된 NdisMediumXxx 값에 의존한다. 예를 들어, 만약 NdisMediumWan이 SelectedMediumIndex에 리턴되어진다면은 프로토콜 드라이버는 아래 계층 드라이버가 사용하는 WAN 미디어 타입들을 결정하는 쿼리로 OID_WAN_MEDIUM_SUBTYPE을 지정하는 NdisRequest를 호출한다.
전에 발행된 wireless 미디어를 위해 OID_NETWORK_TYPE 의 글로벌 쿼리가 드라이버와 아래 계층 NIC이 하나 이상의 NdisMediumWirelessWan 타입 미디엄을 지원한다는 것을 지시한다면은 프로토콜은 NDIS가 바인딩을 설정하자마자 프로토콜이 헤더 포멧을 선택하기 전에 지원된 미디어의 하나를 선택해야 한다.
또 하나의 예는, 만약 MdisMedium802_3를 리턴한다면은, 프로토콜 드라이버는 아래 계층 드라이버가 NDIS_802_3_MAC_OPTION_PRIORITY로 플래그를 설정하는지를 체크하기 위한 쿼리로서 OID_802_3_MAC_OPTIONS을 지정하여 NdisRequest를 호출함으로써 아래 계층 드라이버가 패킷 우선권을 지원하는지를 결정할 수 있다. 만약 이 플래그가 쿼리가 완성되었을 때 설정된다면은, 프로토콜 드라이버는 우선화된 패킷들을 아래 계층 NIC 드라이버에게 NdisSendPackets으로 보내진다. 프로토콜 드라이버는 만약 아래 계층 드라이버가 또한 멀티 패킷 리시브 인디케이션들을 지원한다면은 우선화된(prioritized) 패킷들의 인디케이션들을 얻기 위해 ProtocolReceivePacket함수를 기대할 수 있다.
프로토콜 드라이버들이 단지 바인드된 NDIS 드라이버와 교섭하는 데 사용하는 일반적이고 미디엄 특정 OID들에 대한 더 자세한 정보는 Chapter 5를 보라.
NdisOpenAdapter에 대한 호출자들은 IRQL PASSIVE_LEVEL에서 실행한다.
|