TdiProviderReady

NTSTATUS
   TdiProviderReady(
       IN HANDLE ProviderHandle
       );

TdiProviderReady 함수는 하나이상의 하부 NIC과 성립된 바인딩을 가지는 특정 트랜스포트의 TDI 클라이언트를 인식한다. 그리고 네트웍으로 데이타를 보내거나 받을 수 있다.

매개변수

ProviderHandle

트랜스포트가 TdiRegisterProvider 함수로부터 얻은 핸들을 서술한다.

리턴값

네트웍으로 데이타를 보내기위한 현재의 모든 바인딩 클라이언트의 트랜스포트 준비가 됐을 때 TdiProviderReady 함수는 STATUS_SUCCESS를 리턴한다. 그렇지 않으면 STATUS_INSUFFICIENT_RESOURCES를 리턴할 수 있다. (시스템 자원의 사용이 동적이기 때문에 같은 트랜스포트로부터의 순차적인 호출은 성공할 수 있다.)

주석

TDI 트랜스포트는 다음의 모든 연산을 하자마자 TdiProviderReady 함수를 호출한다:

• 트랜스포트 스택에서 최하위 드라이버의 ProtocolBindAdapter 함수가 하나이상의 하부 NDIS 미니포트와의 바인딩을 성공적으로 성립해서 이 미니포트의 NIC은 초기화됐고 네트웍으로 데이타를 전송할 수 있다.
• NDIS는 NetEventBindsComplete 타입의 입력 NET_PNP_EVENT를 가지고 트랜스포트 스택의 밑에서 ProtocolPnPEvent 함수를 호출했다.
• 새롭게 성립된 트랜스포트와 NIC의 바인딩에서 그들이 네트웍 전송을 트랙할 필요가 있는 상태가 무엇이든지 트랜스포트 스택안에 어떤 인터미디엇 드라이버가 할당되고 초기화되었다.
• 또한 새롭게 성립된 트랜스포트와 NIC의 바인딩에서 클라이언트의 네트웍 전송을 트랙할 필요가 있는 상태가 무엇이든지 TDI 트랜스포트 드라이버가 할당되고 초기화되었다. 예를들어 트랜스포트는 각각의 그러한 바인딩에서 클라이언트의 네트웍 I/O 연산의 타겟을 구현하기 위해서 생성된 장치 객체의 이름을 가지고 한번이상 TdiRegisterDeviceObject 함수를 호출했다. 또한 트랜스포트는 방금 성립된 바인딩에서 한번이상 TdiRegisterNetAddress 함수를 호출했다.

• TDI는 입력 PnPOpcode 값 TDI_PNP_OP_PROVIDERREADY를 가지고 이 트랜스포트의 클라이언트에 대한 등록된 ClientPnPBindingChange 루틴을 호출한다. 따라서 TDI는 하부의 트랜스포트 스택이 새롭게 성립된 트랜스포트와 NIC의 바인딩을 통해서 네트웍으로 데이타를 보내거나 받을 준비가 된 클라이언트를 인식한다.
• 이 기계상에서 레지스트리안에 저장된 네트웍 구성 정보에 따라서 이것이 TDI에게 주어진 마지막 트랜스포트 준비 인디케이션이고 성립된 마지막 트랜스포트와 NIC의 바인딩이라면 TDI는 모든 트랜스포트의 클라이언트에 대해서 등록된 ClientPnPBindingChange 루틴을 호출한다. 결국 TDI는 시스템 초기화시에 바인딩 연산이 NULL DeviceName 포인터와 값이 TDI_PNP_OP_NETREADY인 PnPOpcode를 가지고 각각의 등록된 ClientPnPBindingChange 루틴을 호출하므로써 행해질 때 모든 등록된 클라이언트를 인식한다.

TdiProviderReader 함수의 호출자는 IRQL < DISPATCH_LEVEL에서 실행되어야한다.