REMOTE_NDIS_HALT_MSG

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

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 Values

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

OS Versions: Windows CE .NET 4.0 and later.
Header: Rndis.h.

See Also

RNDIS Concepts | REMOTE_NDIS_INITIALIZE_MSG | RNDIS_REQUEST_ID

 Last updated on Tuesday, May 18, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.