REMOTE_NDIS_INITIALIZE_CMPLT (Windows Embedded CE 6.0)
1/6/2010
This message is sent by a Remote NDIS to the host in response to a REMOTE_NDIS_INITIALIZE_MSG message. In the REMOTE_NDIS_INITIALIZE_CMPLT message, the device reports its medium type, Remote NDIS version numbers, and its type.
Syntax
REMOTE_NDIS_INITIALIZE_CMPLT
(UINT32) NdisMessageType;
(UINT32) MessageLength;
(RNDIS_REQUEST_ID) RequestId;
(RNDIS Status Values) Status;
(UINT32) MajorVersion;
(UINT32) MinorVersion;
(UINT32) DeviceFlags;
(RNDIS_MEDIUM) Medium;
(UINT32) MaxPacketsPerMessage;
(UINT32) MaxTransferSize;
(UINT32) PacketAlignmentFactor;
(UINT32) AFListOffset;
(UINT32) AFListSize;
Parameters
- NdisMessageType
Specifies the RNDIS message type, which is set to REMOTE_NDIS_INITIALIZE_CMPLT.
- 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.
- Status
Specifies RNDIS_STATUS_SUCCESS if the device initialized successfully, otherwise it specifies an error code describing the failure. For more information, see RNDIS_STATUS.
- MajorVersion
The latest Remote NDIS protocol version the device can support, which may not be higher than the version specified by the host in the REMOTE_NDIS_INITIALIZE_MSG.
- MinorVersion
The latest Remote NDIS protocol version the device can support, which may not be higher than the version specified by the host in the REMOTE_NDIS_INITIALIZE_MSG.
- DeviceFlags
Specifies the miniport driver type as connectionless or connection-oriented. Windows Embedded CE supports only connectionless driver types.
- Medium
Set to RNDIS_MEDIUM_802_3 (0x00000000). Specifies the medium supported by the device.
- MaxPacketsPerMessage
Specifies the maximum number of RNDIS data messages that the device can handle in a single transfer to it.
- MaxTransferSize
This value should be at least one. Specifies the maximum size, in bytes, of any single bus data transfer that the device expects to receive from the host.
- PacketAlignmentFactor
This value is specified in powers of 2. Specifies the byte alignment the device expects for each RNDIS message that is part of a multi-message transfer to it. For example, this value is set to three to indicate 8-byte alignment. This value has a maximum setting of seven, which specifies 128-byte alignment.
- AFListOffset
Set value to 0. Reserved for connection-oriented devices.
- AFListSize
Set value to 0. Reserved for connection-oriented devices.
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.
The device should report its medium type, Remote NDIS version numbers, and its type (connection-less or connection-oriented) in its response to REMOTE_NDIS_INITIALIZE_MSG.
Requirements
| Header | rndis.h |
| Windows Embedded CE | Windows CE .NET 4.0 and later |
See Also
Reference
Remote NDIS Messages
REMOTE_NDIS_INITIALIZE_MSG
RNDIS_STATUS
RNDIS_REQUEST_ID
RNDIS_MEDIUM