TdiDeregisterDeviceObject

NTSTATUS
   TdiDeregisterDeviceObject(
       IN HANDLE DevRegistrationHandle
       );

TdiDeregisterDeviceObject 함수는 TdiRegisterDeviceObject 함수의 반대이다. 이 함수는 클라이언트의 네트웍 I/O 리퀘스트를 위한 유효한 타겟으로써 TDI를 가지고 미리 등록된 트랜스포트 생성 장치 객체를 제거한다.

매개변수

DevRegistrationHandle

TdiRegisterDeviceObject 함수로의 호출에서 리턴된 핸들을 서술한다.

리턴값

등록이 해제되고 바인딩된 모든 클라이언트가 통보했다면 TdiDeregisterDeviceObject 함수는 STATUS_SUCCESS를 리턴한다. 그렇지 않다면 STATUS_INSUFFICIENT_RESOURCES를 리턴할 수 있다.(시스템 자원의 사용가능성이 동적이기 때문에 같은 트랜스포트로부터의 순차적인 호출은 성공할 수 있다.)

주석

트랜스포트 드라이버는 트랜스포트 스택의 밑에서 ProtocolUnbindAdapter 함수로 NDIS 호출의 결과로 TdiDeregisterDeviceObject 함수를 호출한다. ProtocolUnbindAdapter 함수로의 그러한 호출은 트랜스포트가 바인딩된 하부의 NIC이 제거되거나 디스에이블되는 것을 알린다. 결과적으로 TDI 트랜스포트 드라이버는 그 NIC에 대해서 바인딩을 위해 전에 생성된 장치 객체를 파괴할 것이다,

트랜스포트가 TDI를 가지고 이 장치 객체를 미리 등록했다면 트랜스포트는 시스템으로부터 장치 객체를 삭제하기 전에 TdiDeregisterDeviceObject 함수를 호출해야한다. 트랜스포트가 장치 객체를 등록해제하기 전에 트랜스포트는 바인딩상에 현재 TDI를 가지고 등록된 각각의 네트웍 주소를 가진 TdiDeregisterNetAddress 함수의 호출을 한번이상 해야한다. 즉, 트랜스포트는 NIC과의 바인딩을 끊은 후에 TdiDeregisterDeviceObject 함수를 호출한다.

TdiDeregisterDeviceObject 함수는 트랜스포트의 장치 객체가 트랜스포트의 클라이언트 I/O 리퀘스트에 대해서 더이상 유효하지 않다는 것을 호출하는 트랜스포트의 클라이언트에게 통보한다. 이 호출이 발생했을 때 TDI는 입력 PnPOpcode 인자 TDI_PNP_OP_DEL를 가진 이 통보를 받기 위해서 TdiRegisterPnPHandlers 함수를 가지고 자신을 등록한 그 클라이언트의 ClientPnPBindingChange 루틴을 호출한다.

TdiDeregisterDeviceObject 함수가 STATUS_INSUFFICIENT_RESOURCES를 리턴한다면 트랜스포트는 등록된 장치 객체를 지시하는 순차적인 들어오는 클라이언트 리퀘스트를 실패한다. 리턴값이 적절할 때 트랜스포트는 이용할 수 있는 시스템 메모리의 임시 부족이 원래의 호출을 실패하도록 하기 때문에 TdiDeregisterDeviceObject 함수를 호출해야한다.

TdiDeregisterDeviceObject 함수의 호출자는 IRQL < DISPATCH_LEVEL에서 실행해야한다.