TdiDeregisterPnPHandlers

NTSTATUS
   TdiDeregisterPnPHandlers(
       IN HANDLE BindingHandle
       );

TdiDeregisterPnPHandlers 함수는 TdiRegisterPnPHandlers 함수의 반대이다. 이 함수는 특정 트랜스포트와 NIC과의 바인딩에서 등록된 ClientPnPXxx의 모음으로 PnP와 전원상태 통보를 디스에이블한다.

매개변수

BindingHandle

클라이언트의 TdiRegisterPnPHandlers 함수 호출에 의해서 리턴된 핸들을 서술한다.

리턴값

등록에 해제된다면 TdiDeregisterPnPHandlers 함수는 STATUS_SUCCESS를 리턴한다. 그렇지 않으면 이 함수는 다음중 하나를 리턴할 수 있다:

STATUS_INSUFFICIENT_RESOURCES

TDI는 이 시간에 이 리퀘스트를 완료하기 위해서 필요한 자원을 할당하지 않았다. 시스템 자원의 이용가능성이 동적이기 때문에 같은 클라이언트로부터의 순차적인 호출은 성공할 수 있다.

STATUS_NETWORK_BUSY

ClientPnPXxx 루틴이 현재 실행중이기 때문에 TDI는 교착상태를 막기 위해서 호출을 실패한다. 같은 클라이언트로부터의 순차적인 호출은 성공할 수 있다.

주석

TdiDeregisterPnPHandlers 함수로의 성공적인 호출은 특정 트랜스포트와 NIC과의 바인딩에서 TdiRegisterPnPHandlers 함수를 가지고 미리 등록된 ClientPnPXxx 루틴으로의 호출로써 보내지는 증진된 PnP/전원, 바인딩, 언바인딩, 그리고 넷 주소 변화 통보를 멈춘다.

TdiDeregisterPnPHandlers 함수가 STATUS_SUCCESS를 리턴할 때 호출자는 주어진 바인딩을 위해서 상태를 유지하기 위해 할당한 자원을 해제해야한다. 예를들어 ClientPnPAddNetAddress와 ClientPnPDelNetAddress 루틴에 의해서 유지되는 이 바인딩 상에서 현재 등록된 네트웍 주소에 대한 내부 리스트처럼 할당된 바인딩당 상태와 모든 나머지 바인딩당 자원을 유지하기 위해서 할당된 자원을 해제해야한다.

TdiDeregisterPnPHandlers 함수의 호출자는 IRQL < DISPATCH_LEVEL에서 실행된다.