Partager via

REMOTE_NDIS_INITIALIZE_MSG

  • Article

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.

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 Values

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

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

See Also

RNDIS Concepts | REMOTE_NDIS_INITIALIZE_CMPLT

 Last updated on Tuesday, May 18, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.