SetAdapterMode

BOOL __stdcall SetAdapterMode ( HANDLE hOpen, PADAPTER_MODE pMode );

Return Value:
TRUE if call was successful, FALSE otherwise

Parameters:
hOpen
Specifies driver object open handle.
pMode
Pointer to the user allocated and initialized ADAPTER_MODE structure.

Remarks:
The following fields of ADAPTER_MODE must be initialized:

ADAPTER_MODE.hAdapterHandle must be set to the interface handle (obtained via call to GetTcpipBoundAdaptersInfo).
ADAPTER_MODE.dwFlags must be a combination of the XXX_LISTEN or XXX_TUNNEL flags:

  • MSTCP_FLAG_SENT_TUNNEL – queue all packets sent from MSTCP to network interface. Original packet dropped.
  • MSTCP_FLAG_RECV_TUNNEL – queue all packets indicated by network interface to MSTCP. Original packet dropped.
  • MSTCP_FLAG_SENT_LISTEN – queue all packets sent from MSTCP to network interface. Original packet goes ahead.
  • MSTCP_FLAG_RECV_LISTEN – queue all packets indicated by network interface to MSTCP. Original packet goes ahead.
  • MSTCP_FLAG_FILTER_DIRECT – In promiscuous mode TCP/IP stack receives all packets in the Ethernet segment and replies with various ICMP packets, to prevent this set this flag. All packets with destination MAC different from FF-FF-FF-FF-FF-FF and network interface current MAC will never reach MSTCP.

By default, loopback packets are passed to original MSTCP handlers without processing, to change this behavior use these additional flags below:

  • MSTCP_FLAG_LOOPBACK_FILTER – if not set, then loopback packets are silently passed over, otherwise these packets are passed for further processing (queued for redirecting to the application if not dropped by the MSTCP_FLAG_LOOPBACK_BLOCK below).
  • MSTCP_FLAG_LOOPBACK_BLOCK – if set, then loopback packets (with exception to broadcast/multicast) are silently dropped.
  • MSTCP_FLAG_LOOPBACK_BLOCK | MSTCP_FLAG_LOOPBACK_FILTER – does not allow loopback packet to pass silently and results blocking them (with exception to broadcast/multicast).

This member is a wrapper for CNdisApi::SetAdapterMode