REMOTE_NDIS_INITIALIZE_MSG (Windows Embedded CE 6.0)

1/6/2010

This message is sent by the host to a Remote NDIS device to initialize the network connection. It is sent through the control channel and only when the device is in the rndis-uninitialized state. For more information about RNDIS device states, see RNDIS Concepts.

Syntax

REMOTE_NDIS_INITIALIZE_MSG
(UINT32) NdisMessageType;
(UINT32) MessageLength;
(RNDIS_REQUEST_ID) RequestId;
(UINT32) MajorVersion;
(UINT32) MinorVersion;
(UINT32) MaxTransferSize;

Parameters

• NdisMessageType
  Set to 0x00000002. Specifies the RNDIS message type, which is set to REMOTE_NDIS_INITIALIZE_MSG.

• MessageLength
  Specifies the total length of this RNDIS message in bytes. For REMOTE_NDIS_INITIALIZE_MSG, this value is always 24.

• RequestId
  Specifies the Remote NDIS message identifier value. This value is used to match device responses to host sent messages.

• MajorVersion
  RNDIS_MAJOR_VERSION Specifies the Remote NDIS protocol major version implemented by the host.

• MinorVersion
  RNDIS_MINOR_VERSION Specifies the Remote NDIS protocol minor version implemented by the host.

• MaxTransferSize
  Specifies the maximum size, in bytes, of any single bus data transfer that the host expects to receive from the device. Typically, each bus data transfer accommodates a single Remote NDIS message. However, the device may bundle several Remote NDIS data packets into a single transfer (see REMOTE_NDIS_PACKET_MSG).

Return Value

None.

Remarks

All RNDIS messages start with two UINT32 fields, NdisMessageType and MessageLength that identify the type of message being sent and its length. All messages that expect a response from a remote device and all responses to such messages from a remote device also include a third UINT32 field, RequestId, that is used to match device responses to host sent messages.

Requirements

See Also

Reference

Remote NDIS Messages
REMOTE_NDIS_INITIALIZE_CMPLT

Concepts

RNDIS Concepts