REMOTE_NDIS_SET_MSG (Windows CE 5.0)
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
Send Feedback on this topic to the authors