BOOL CNdisApi::SetAdapterListChangeEvent ( HANDLE hEvent ) const;Return Value:TRUE if call was successful, FALSE otherwise
Parameters:hEvent
Handle to user created Win32 event. Set it to NULL if you want to release event.
Remarks:
The user application should create a Win32 event (with CreateEvent API call) and pass the event handle to this function. Helper driver will signal this event when TCP/IP bound adapter’s list changes (an example this happens on plug/unplug network card, disable/enable network connection or etc.). Usually, you should call CNdisApi::GetTcpipBoundAdaptersInfo and renew your adapter associated structures on this event.
This member calls the filter driver with IOCTL_NDISRD_SET_ADAPTER_EVENT control code (see details below).
IOCTL_NDISRD_SET_ADAPTER_EVENT
| Input Buffer | Win32 event handle or NULL if you want to release event. |
| Input Buffer Size | sizeof(HANDLE) |
| Output Buffer | None |
| Output Buffer Size | 0 |
The IOCTL table describes the native process layout. Under WOW64, the SDK uses ULARGE_INTEGER for the corresponding request and translates handles or pointers. Use the public library function rather than copying native buffer sizes into a direct WOW64 IOCTL call.