REMOTE_NDIS_INITIALIZE_MSG (Compact 2013)
3/26/2014
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.
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 |