Share via

REMOTE_NDIS_SET_MSG

  • Article

This message is sent by the host to a Remote NDIS device when it needs to set the value of some operational parameter on the device. The specific parameter being set is identified by means of an object identifier (OID), and the value it is to be set to is contained in an information buffer sent along with the message. The host may send REMOTE_NDIS_SET_MSG to the device through the control channel at any time that the device is in either the rndis-initialized or rndis-data-initialized state. The Remote NDIS device will respond to this message by sending a REMOTE_NDIS_SET_CMPLT to the host.

REMOTE_NDIS_SET_MSG
(UINT32) NdisMessageType;
(UINT32) MessageLength;
(RNDIS_REQUEST_ID) RequestId;
(RNDIS_OID) Oid;
(UINT32) InformationBufferLength;
(UINT32) InformationBufferOffset;
(RNDIS_HANDLE) DeviceVcHandle;

Parameters

  • NdisMessageType
    Specifies the RNDIS message type, which is set to REMOTE_NDIS_SET_MSG.
  • 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.
  • Oid
    Specifies the NDIS object identifier that identifies the parameter being set.
  • InformationBufferLength
    Specifies, in bytes, the length of the input data for the request.
  • InformationBufferOffset
    Specifies the byte offset, from the beginning of the RequestId field, at which input data for the request is located.
  • DeviceVcHandle
    Set 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.

Requirements

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

See Also

REMOTE_NDIS_SET_CMPLT | RNDIS_REQUEST_ID | RNDIS_OID

 Last updated on Tuesday, May 18, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.