ClientPnPDelNetAddress

VOID
   ClientPnPDelNetAddress(
       IN PTA_ADDRESS Address,
       IN PUNICODE_STRING DeviceName,
       IN PTDI_PNP_CONTEXT Context
       );

TDI는 TdiDeregisterNetAddress 함수로의 트랜스포트 호출에 대한 결과로써 ClientPnPDelNetAddress 함수를 호출한다.

매개변수

Address

버퍼화된 네트웍 주소를 가리킨다. 이 버퍼의 내용과 레이아웃은 하부의 트랜스포트에 의해서 설정되므로써 AddressType과 AddressLength 멤버에 의존하는 Address에 제공된 정보를 가진 특징에서 프로토콜 특정이다.

DeviceName

등록해제되는 주어진 네트웍 주소로부터 트랜스포트를 효과적으로 확인하는 버퍼화된 유니코드 문자열을 가리킨다. 일반적으로 이것은 클라이언트가 이 바인딩을 제공했을 때 ClientPnPBindingChange 루틴으로 원래 전달되는 트랜스포트 생성 장치 객체의 이름을 포함한다.

Context

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

예를들어 TCP/IP는 파괴되는 주어진 주소에 대한 연결에서 장치를 구현하는 PDO로 포인터를 전달한다.

주석

클라이언트는 존재하는 넷 주소를 PnP를 지원하는 트랜스포트가 삭제하려할 때 이 통보의 수신을 시작하기 위해서 TdiRegisterPnPHandlers 함수로의 호출을 가지고 ClientPnPDelNetAddress 루틴을 등록해야한다.

초기화시에 ClientPnPAddNetAddress 함수로의 호출결과에 이어서 PnP를 지원하는 트랜스포트가 TDI를 가지고 네트웍 주소를 등록해제할 때마다 TDI는 ClientPnPDelNetAddress 함수를 호출한다. 즉 ClientPnPDelNetAddress 함수는 바인딩이 되어있지 않은 트랜스포트에 조차도 제공된 주소를 가지고 호출될 수 있다. 결국 ClientPnPDelNetAddress 함수는 클라이언트가 입력 주소의 프로토콜 특정 타입을 인식하지 못한다면 즉시 통제를 리턴해야한다. 더 좋은 클라이언트의 퍼포먼스를 위해서 TA_ADDRESS 구조체의 AddressType 멤버를 검사하는 것은 DeviceName에 버퍼화된 내용에서 문자열을 비교하는 것보다도 더 효과적이다.

Address에 버퍼의 내용과 포맷은 TA_ADDRESS 구조체의 AddressType 멤버의 값에 의존한다. 하부의 트랜스포트는 네트웍 주소의 사양 제공에만 책임을 진다. 특정 타입의 TA_ADDRESS 구조체는 또한 소켓 식별자를 포함하거나 ClientPnPDelNetAddress 함수에 의해서 무시되어야하는 부수적인 멤버들도 포함한다.

입력 컨텍스트 매개변수에 대해서 TDI_PNP_CONTEXT 구조체안에 ContextType 멤버의 값은 이 트랜스포트 제공, 그리고 프로토콜 결정 컨텍스트 정보를 어떻게 해석하는지에 대한 힌트를 제공한다. TdiDeregisterNetAddress 함수를 호출할 때 하부의 트랜스포트가 컨텍스트 정보를 제공하지 않는다면 Context 포인터는 NULL일 수 있다.

ClientPnPAddNetAddress 함수와 관련하여 ClientPnPDelNetAddress 함수는 바인딩 당 유효한 네트웍 주소의 클라이언트 내부 리시트를 유지한다. ClientPnPDelNetAddress 함수가 그러한 내부 리스트로부터 주소를 제거하기 위해서 호출될 때 주소를 사용하는 클라이언트에게 네트웍 연결이 방금 파괴됐다고 알린다.

TdiDeregisterPnPHandlers 함수로의 상반된 호출은 ClientPnPDelNetAddress 함수로의 호출을 디스에이블한다.

TDI는 IRQL < DISPATCH_LEVEL에서 ClientPnPDelNetAddress 함수를 호출한다.