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
| Header | rndis.h |
| Windows Embedded CE | Windows CE .NET 4.0 and later |
See Also
Reference
Remote NDIS Messages
REMOTE_NDIS_INITIALIZE_CMPLT