TdiRegisterProvider

NTSTATUS
   TdiRegisterProvider(
       IN PUNICODE_STRING ProviderName,
       OUT HANDLE *ProviderHandle
       );

TdiRegisterProvider 함수는 PnP를 지원하는 트랜스포트 드라이버가 초기화 중이고 트랜스포트가 하나이상의 하부 NDIS NIC 미니포트와의 바인딩을 성립했고 네트웍 I/O 연산의 수행을 준비중일 때 TdiProviderReady 함수로의 순차적인 호출을 할 것이다라는 것을 TDI에게 알린다.

매개변수

ProviderName

\device\tcp_{GUID_for_tcp}, \device\nwlinkipx, 등등과 같은 트랜스포트를 위한 일반적인 이름인 버퍼화된 유니코드 문자열을 가리킨다.

ProviderHandle

이 호출이 성공한다면 불투명한 핸들을 리턴하는 TdiRegisterProvider 함수의 호출자 제공 로케이션의 변수를 서술한다.

리턴값

TDI가 트랜스포트를 트랙하기 위해서 유지하는 내부 상태와 트랜스포트 존재의 인식된 잠재적인 클라이언트가 무엇이든지간에 설정했을 때 TdiRegisterProvider 함수는 STATUS_SUCCESS를 리턴한다. 그렇지 않으면 시스템 설정동안에 자신을 초기화 중인 트랜스포트로 이 상태를 리턴하는 게 아주 좋지않다 하더라도 STATUS_INSUFFICIENT_RESOURCES를 리턴할 수 있다.

주석

TDI 트랜스포트 드라이버는 그들의 DriverEntry 루틴에서부터 TdiRegisterProvider 함수를 호출한다.

TdiRegisterProvider 함수로의 성공적인 호출에 의해서 리턴된 핸들은 TdiProviderReady 함수로의 순차적인 호출을 위해서 그리고 트랜스포트 드라이버의 Unload 루틴으로부터 TdiDeregisterProvider 함수의 상호적인 호출을 위해서 저장되어야한다.

TdiRegisterProvider 함수의 호출자는 IRQL < DISPATCH_LEVEL에서 실행할 수 있다.