REMOTE_NDIS_HALT_MSG (Windows Embedded CE 6.0)

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

See Also

Reference

Remote NDIS Messages
REMOTE_NDIS_INITIALIZE_MSG
RNDIS_REQUEST_ID

Concepts

RNDIS Concepts