Share via

REMOTE_NDIS_INITIALIZE_CMPLT

  • Article

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.

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 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 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.

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

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

See Also

REMOTE_NDIS_INITIALIZE_MSG | RNDIS_STATUS | RNDIS_REQUEST_ID | RNDIS Status Values | RNDIS_MEDIUM

 Last updated on Tuesday, May 18, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.