ProtocolBindAdapter

VOID 

  ProtocolBindAdapter(

    OUT PNDIS_STATUS Status,

    IN NDIS_HANDLE  BindContext,

    IN PNDIS_STRING  DeviceName,

    IN PVOID  SystemSpecific1,

    IN PVOID  SystemSpecific2

    );

ProtocolBindAdapter 함수는 Plug and Play를 지원하기 위해 필요한 드라이버 함수이다.

매개변수

Status
다음과 같은 하나로 ProtocolBindAdapter 함수는 연산들의 상태를 리턴하는 변수를 가리킨다.

NDIS_STATUS_SUCCESS
드라이버의 완성된 초기화는 성공적이고 DeviceName과 지정된 주어진 NIC 드라이버에 대해 바인드가 성공적이다.

NDIS_STATUS_PENDING
프로토콜은 아래 드라이버로부터 수신들을 허락하기 위해 그리고 아래 드라이버에 요구들을 설정하고 쿼리하고 전송을 보내기 위해 준비할 때 NdisCompleteBindAdapter 함수에 대한 호출로 비동기적으로 바인드 연산을 완성할 것이다.

NDIS_STATUS_XXX 혹은 NTSTATUS_XXX
바인딩을 설정하기 위한 프로토콜의 시도가 실패하거나 프로토콜이 네트워크 I/O 연산들을 실행하기 위해 필요한 자원들을 할당할 수 없다. 항상, 그러한 에러 상태는 NdisXxx 함수 혹은 커널 모드 지원 루틴으로부터 전달되어진다.

BindContext
프로토콜이 연속적인 NdisCompleteBindAdapter 함수에 대해 전달하는 NDIS에 의해 전공된 핸들을 지정한다.

DeviceName
ProtocolBindAdapter 함수가 바인드해야 하는 가상 NIC 드라이버 혹은 아래 NIC 드라이버를 명명하는 버퍼화된 Unicode 문자열을 가리킨다.

SystemSpecific1
NdisOpenProtocolConfiguration 함수에 대한 요구된 매개변수인 레지스트리 경로 포인터를 지정한다. 호출자는 어떤 다른 목적을 위해 이러한 포인터를 사용할 수 없다.

SystemSpecific2
시스템 사용을 위해 예약된다. 호출자는 어떤 목적을 위해 이러한 포인터를 사용할 수 없다.

주석

ProtocolBindAdapter 함수는 프로토콜이 바인드할 수 있는 아래 NIC이 이용할 수 있을 때마다 동적 바인딩 연산들을 행한다. 추가적으로, ProtocolBindAdapter 함수는 plug and play를 지원하기 위해 DriverEntry 함수로부터 지연된 드라이버 초기화 연산들을 계속한다. ProtocolBindAdapter 함수는 바인딩당 런타임 상태를 유지하기 위해 충분한 메모리를 할당하고 아래 드라이버에 대해 바인드하기 위해 주어진 BindContext와 DeviceName으로 NdisOpenAdapter 함수를 호출한다.

만약 NdisOpenAdapter 함수가 NDIS_STATUS_PENDING을 리턴한다면, 드라이버의 ProtocolOpenComplete 함수가 바인딩 연산이 완성될 때, 계속적으로 호출될 것이다. ProtocolBindAdapter 함수가 바인딩당 상태를 위해 할당된 영역에서 입력 BindContext 핸들을 저장해야 한다. NdisOpenAdapter 함수에 제공된 ProtocolBindContext 핸들이 계속적인 NdisCompleteBindAdapter 함수에 대한 BindContext 핸들로 전달해야 하는 드라이버의 ProtocolOpenadAdapterComplete 함수에 대한 입력 매개변수이다. 아래 NIC 드라이버는 open 연산이 지연되는 동안 수신하는 어떤 요구들을 위해 NDIS_STATUS_ADAPTER_NOT_READY를 리턴한다. 결과적으로, ProtocolBindAdapter 함수는 만약 NdisOpenAdapter 함수가 NDIS_STATUS_PENDING 을 리턴한다면 아래 드라이버를 쿼리하기 위해 Ndis(Co)Request 함수를 호출할 수 없다.

이러한 환경에서, ProtocolBindAdapter 함수는 단지 NDIS_STATUS_PENDING에 대한 Status로 설정하고 바인딩 특정 상태로 설정하기 위해 그리고 만약 이러한 함수가 NDIS_STATUS_SUCCESS의 입력 Status로 호출된다면 ProtocolOpenAdapterComplete 함수로 바인딩 특정 자원들을 할당하기 위해 취해진 행동들이 무엇이든지간에 지연하고 제어를 리턴한다.

유사하게, 만약 NdisOpenAdapter 함수가 에러 상태를 리턴한다면, ProtocolBindAdapter 함수가 리턴된 값으로 Status를 설정하고 드라이버가 할당한 어떤 바인딩당 자원들을 해제하고 즉시 제어를 리턴한다. 그렇지 않으면, 성공적인 바인딩은 설립되고 프로토콜은 Protocol(Co)Status, Protocol(Co)ReceivePacket, ProtocolReceive 함수들로 아래 드라이버로부터 인디케이션들을 수신할 수 있다.

결과적으로, NdisOpenAdapter 함수가 NDIS_STATUS_SUCCESS를 리턴한다면, ProtocolBindAdapter 함수가 드라이버가 바인딩된 네트워크 I/O를 실행하기 위해 필요한 자원들을 할당하고 프로토콜이 네트워크 I/O 연산들을 추적하기 위해 사용하는 바인딩 특정 런타임 상태가 무엇인든지 간에 설정한다. 만약 드라이버의 설치 스크립트가 레지스트리의 프로토콜 섹션내에 어댑터 특정 구성 정보를 설치한다면, ProtocolBindAdapter 함수는 이러한 정보를 검색하기 위해 NdisOpenProtocolConfiguration 함수와 NdisReadConfiguration 함수를 호출한다. 드라이버 설치 스크립트에 대한 더 많은 정보를 위해 Setup, Plug and Play, Power Management Design Guide와 Reference를 봐라.

아래 미디어에 의존해서 ProtocolBindAdapter 함수는 또한 최대 프레임 크기, 전송/수신 버퍼 공간, 등등 바인딩을 위해 적당한 상태를 설정하기 위한 아래 드라이버의 NIC 특정 제한들에 대해 아래 드라이버 (혹은 NDIS)를 쿼리하기 위해 NdisCoRequest 혹은 NdisRequest 함수를 호출할 수 있다.

연결 지향 NIC 드라이버에 바인딩된 어떤 프로토콜은 아래 미니포트가 멀티패킷 보내기들을 지원하고 full-패킷 수신들을 인디케이트하는 지를 추측할 수 있다.

비연결 지향 NIC 미니포트와 바인딩된 프로토콜은 아래 드라이버가 드라이버가 프로토콜이 NdisRequest 함수에 전달하는 OID_GEN_CURRENT_LOOKAHEAD 와 OID_GEN_RECEIVE_BLOCK_SIZE 쿼리들을 위해 리턴하는 값들을 비교함으로써 full-packet 수신들을 인디케이트한다. 만약 그들이 동일하다면, 프로토콜이 이러한 바인딩시 NdisTransferData 함수로 호출들을 하지 않을 것이다. 프로토콜은 아래 드라이버가 OID_GEN_MAXIMUM_SEND_PACKETS 쿼리로 멀티 패킷 보내기들을 지원하는지를 결정할 수 있다. 그러나, 만약 아래 드라이버가 MiniportSendPackets 함수를 가지지 않는다는 것을 가리키는 하나를 리턴한다면, 프로토콜은 프로토콜은 보내기들을 위해 할당한 패킷 디스크립터들에 대역외 정보를 제공하지 않는 한 바인딩 시에 NdisSendPackets 함수를 호출할 수 있다. NDIS는 그러한 아래 비연결 지향 NIC 드라이버에 바인드된 프로토콜들로의 패킷 배열들의 제출(submissions)들을 다룬다. 프로토콜은 아래 드라이버가 프로토콜 제공 대역외 데이터를 다루는 능력을 가지는 것을 확실히 하기 위한 책임이 있다.

일반적이고 미디엄 특정 OID 요구들에 대한 더 많은 정보를 위해, Part 2를 봐라.

드라이버의 Protocol(Co)ReceivePacket 함수 혹은 ProtocolReceive 함수는 바인딩을 위한 OID_GEN_CURRENT_PACKET_FILTER로 패킷 필터를 설정하자마자 호출될 수 있다. NULL 필터를 위해, 수신 인디케이션들은 NdisOpenAdapter 함수에 대해 성공적인 호출로부터 리턴하자마자 가능으로 된다.

모든 NDIS 프로토콜 드라이버는 계속적인 네트워크 전송들을 위해 그리고 가능한 계속적인 transfer data 요구들을 위해 아래 드라이버가 NdisMIndicateReceivePacket 함수 혹은 NdisMCoIndicateReceivePacket 함수로 full-packet 수신들을 인디케이트하는 것에 의존하면서 패킷 디스크립터들과 버퍼 디스크립터들을 할당하기 위한 것으로부터 충분한 패킷 pool과 버퍼 pool을 할당해야 한다.

연결 지향 콜 매니저 혹은 MCM 드라이버의 ProtocolBindAdapter 함수는 NDIS에 이러한 어댑터를 위해 시그널링 서비스들과 ProtocolCmXxx 함수들을 등록하기 위해 각각, NdisCmRegisterAddressFamily 함수 혹은 NdisMCmRegisterAddressFamily 함수를 호출해야 한다. NDIS는 각 잠재적인 연결 지향 클라이언트가 DriverEntry 함수로부터 NdisRegisterProtocol 함수를 호출할 때 등록하는 그들의 ProtocolCoAfRegisterNotify 함수들을 호출함으로써 가능한 클라이언트 프로토콜들에 대한 콜 매니저의 서비스들을 광고할 것이다.

연결 지향 클라이언트 프로토콜들은 ProtocolBindAdapter 함수들로부터 NdisClOpenAddressFamily 함수를 호출할 수 없다는 것을 주목하라. 그 대신에, 이러한 프로토콜들은 그들의 ProtocolCoAfRegisterNotify 함수들로부터 NDIS와 함께 그들의 ProtocolClXxx 함수들을 등록하기 위해 이러한 호출들을 한다. NDIS 인터미디엇 드라이버의 ProtocolBindAdapter 함수는 차례로 드라이버의 MiniportIntialize 함수를 호출하는 NdisIMInitializeDeviceInstanceEx 혹은 NdisIMIntializeDeviceInstance 함수를 호출함으로써 드라이버의 가상 NIC의 초기화를 prompt할 책임이 있다. 그러한 드라이버는 ProtocolBindAdapter(혹은 ProtocolBindAdapterComplete) 함수가 DeviceName에 지정된 아래 드라이버에 바인딩을 설립한 후 초기화해야 한다. 아직 상위 레벨 프로토콜들은 가상 NIC이 초기화되기까지 그러한 인터미디엇 드라이버에 바인드할 수 없다. 만약 인터미디엇 드라이버는 NdisIMIntializeDeviceInstanceEx 함수로 장치 컨텍스트 영역을 설정한다면, 가상 NIC이 연속적으로 그들을 바인드하는 상위 레벨 프로토콜들은 인터미디엇 드라이버가 제공하는 정보를 쿼리하기 위해 NdisIMGetBindingContext 함수를 호출할 수 있다.

만약 ProtocolBindAdapter 함수가 계속적인 네트워크 I/O 연산들을 실행하기 위해 필요한 자원들을 할당할 수 없다면, 이미 할당된 모든 자원들을 해제해야하고 Status에 적당한 에러 값을 설정하고 제어를 리턴한다.

만약 드라이버가 설립된 바인딩에 대한 네트워크 I/O를 실행하기 위한 준비가 되면 ProtocolBindAdapter 함수는 Status와 OpenStatus 매개변수들을 위해 NDIS_STATUS_SUCCESS로 NdisCompleteBindAdapter 함수를 호출한다.

디폴트로, ProtocolBindAdapter 함수는 시스템 쓰레드의 컨텍스트에서 IRQL PASSIVE_LEVEL에서 실행한다.