TdiRegisterNetAddress

NTSTATUS
   TdiRegisterNetAddress(
       IN PTA_ADDRESS Address,
       IN PUNICODE_STRING DeviceName,
       IN PTDI_PNP_CONTEXT Context,
       OUT HANDLE *AddrRegistrationHandle
       );

TdiRegisterNetAddress 함수는 특정 네트웍 주소를 가지고 원격지와 방금 연결을 성립됐거나 실행중인 컴퓨터를 위해서 트랜스포트가 새로운 네트웍 주소를 생성했음을 트랜스포트의 클라이언트에게 알린다.

매개변수

Address

프로토콜 타입 특정 TDI_ADDRESS_XXX 주소 명세을 포함하는 TA_ADDRESS 구조체로써 포맷된 호출자 할당 버퍼를 가리킨다.

DeviceName

이 트랜스포트와 NIC과의 바인딩을 구현하는 트랜스포트 생성 장치 객체를 확인하는 호출자 제공의 버퍼화된 유니코드 문자열을 가리킨다. TdiRegisterDeviceObject 함수가 호출됐을 때 트랜스포트는 TDI를 가지고 이 장치 객체를 등록했다. 결국 이 문자열은 이 네트웍 주소가 등록된 곳에서 트랜스포트와 NIC의 바인딩을 확인한다.

Context

이 주소와 연관된 트랜스포트 결정 컨텍스트를 가리킨다.

예를들어 TCP/IP는 이 주소가 도착하는 물리 장치의 PDO에 대한 포인터를 리턴한다.

AddrRegistrationHandle

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

리턴값

TdiRegisterNetAddress 함수가 모든 트랜스포트 클라이언트의 등록을 알 때 STATUS_SUCCESS를 리턴한다. 그렇지 않으면 STATUS_INSUFFICIENT_RESOURCES를 리턴할 수 있다. (시스템 자원의 사용이 동적이기 때문에 같은 트랜스포트로부터의 순차적인 호출은 성공할 수 있다.)

주석

트랜스포트가 TdiRegisterNetAddress 함수를 호출하기 전에 트랜스포트는 새로운 네트웍 주소의 명세를 포함하는 페이저블이 가능한 버퍼를 할당한다. 트랜스포트는 우선 이 버퍼를 0으로 초기화해야한다. 그리고 TA_ADDRESS 구조체의 멤버를 설정한다. 트랜스포트가 이 호출을 할 때 트랜스포트는 Address에서 시작하는 버퍼의 나머지안으로 새로운 네트웍 주소만을 제공해야한다. 즉 어떤 추가적인 멤버가 트랜스포트의 프로토콜 타입 특정 TDI_ADDRESS_XXX 서브구조체안에 부가정보를 위해서 정의됐다면 그 멤버들은 트랜스포트가 TdiRegisterNetAddress 함수를 호출할 때 0이 되어야한다.

TdiRegisterNetAddress 함수는 트랜스포트 제공 장치 이름과 컨텍스트 데이타를 복사하지만 이 호출자 제공 정보를 해석하려고 하지는 않는다. 트랜스포트 개발자의 결정에서 입력 컨텍스트 포인터는 NULL일 수 있다. 혹은 새롭게 등록된 각각의 네트웍 주소에 대한 추가적인 프로토콜 특정 정보를 트랜스포트에서 클라이언트로 전달하기 위해서 사용될 수 있다. 트랜스포트가 각각의 클라이언트를 인식했을 때 TdiRegisterNetAddress 함수는 복사된 장치 이름과 컨텍스트 정보에 대한 포인터를 가지고 각각의 등록된 ClientPnPAddNetAddress 함수를 호출한다.

각각의 ClientPnPAddNetAddress 함수는 새로운 주소가 그 클라이언트와 관계가 있는지를 결정하기 위해서 하부의 트랜스포트가 Context와 장치 이름에 제공한 컨텍스트 정보가 무엇이든지간에 사용할 수 있다. 트랜스포트가 ClientPnpDelNetAddress 루틴의 호출을 야기하는 TdiDeregisterNetAddress 함수를 호출할 때까지 입력 Context 포인터는 유효하다. 트랜스포트가 값이 TDI_PNP_OP_DEL인 PnPOpcode를 가지고 ClientPnPBindingChange 루틴으로의 호출을 야기하는 TdiDeregisterDeviceObject 함수를 호출할 때까지 입력 DeviceName 포인터는 유효하다. 그러나 모든 클라이언트는 읽기 전용 정보로써 이 TDI 상태를 다뤄야한다.

TdiRegisterNetAddress 함수의 성공적인 호출자는 TdiDeregisterNetAddress 함수로의 순차적이고 상호적인 호출을 위해서 *AddrRegistrationHandle에 리턴값을 저장해야한다.

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