Share via

REMOTE_NDIS_HALT_MSG (Windows Embedded CE 6.0)

  • Article

1/6/2010

This message is sent by the host to terminate the network connection.

Syntax

REMOTE_NDIS_HALT_MSG
(UINT32) NdisMessageType;
(UINT32) MessageLength;
(RNDIS_REQUEST_ID) RequestId;

Parameters

  • NdisMessageType
    Specifies the RNDIS message type, which is set to REMOTE_NDIS_HALT_MSG.
  • MessageLength
    Specifies the total length of this RNDIS message in bytes.
  • RequestId
    Specifies the Remote NDIS message identifier value. This value is used to match device responses to host sent messages.

Return Value

None.

Remarks

Implementation of REMOTE_NDIS_HALT_MSG is optional. If implemented, the device sends this message to the host through the control channel only when the device is in the rndis-initialized or rndis-data-initialized state. The device must terminate all communication immediately after sending this message. Sending this message causes the device to enter the rndis-uninitialized state.

Unlike the other host initiated control messages, there is no device response to REMOTE_NDIS_HALT_MSG. The message may be sent at any time that the device is in the rndis-initialized or rndis-data-initialized state. For more information about RNDIS device states, see RNDIS Concepts.

Requirements

Header rndis.h
Windows Embedded CE Windows CE .NET 4.0 and later

See Also

Reference

Remote NDIS Messages
REMOTE_NDIS_INITIALIZE_MSG
RNDIS_REQUEST_ID

Concepts

RNDIS Concepts