TDI Client Event and PnP Notification Handlers
This section describes the system-defined ClientEventXxx callback routines and ClientPnPXxx notification routines that can be implemented in kernel-mode clients of TDI transports. A client registers each such ClientEventXxx callback by setting up an IRP for the underlying transport driver with TdiBuildSetEventHandler, to contain the IOCTL TDI_SET_EVENT_HANDLERcode, and calling IoCallDriver with the IRP. It registers each such ClientPnPXxx notification routine with TdiRegisterPnPHandlers.
The names of these client-supplied callback routines and PnP notification routines in this reference are metanames, chosen to describe their basic functionality. Because any client passes only the entry points for these event handlers in calls to TdiBuildSetEventHandlerand/or TdiRegisterPnPHandlers, their names actually can be anything the writer of each client chooses.
The following ClientEventXxx and ClientPnPXxx routine references are in alphabetic order.
Note The TDI feature is deprecated and will be removed in future versions of Microsoft Windows. Depending on how you use TDI, use either the Winsock Kernel (WSK) or Windows Filtering Platform (WFP). For more information about WFP and WSK, see Windows Filtering Platform and Winsock Kernel. For a Windows Core Networking blog entry about WSK and TDI, see Introduction to Winsock Kernel (WSK).