REMOTE_NDIS_QUERY_MSG (Windows Embedded CE 6.0)

1/6/2010

This message is sent to a Remote NDIS device from a host when it needs to query the device for its characteristics, statistics information, or status. The parameter or statistics counter being queried for is identified by means of an NDIS Object Identifier (OID). The host may send REMOTE_NDIS_QUERY_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_QUERY_CMPLT to the host.

Syntax

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

Parameters

• NdisMessageType
  Set to 0x80000004. Specifies the RNDIS message type, which is set to REMOTE_NDIS_QUERY_MSG.

• MessageLength
  Specifies the total length of this RNDIS message in bytes.

• RequestId
  Specifies the Remote NDIS message ID value. This value is used to match messages sent by the host with device responses.

• Oid
  Specifies the NDIS object identifier that identifies the parameter being queried.

• InformationBufferLength
  Set to 0 when no information buffer is used. Specifies the length in bytes of the information buffer for the query.

• InformationBufferOffset
  Set to 0 if there is no response data. Specifies the byte offset from the beginning of the RequestId parameter at which the information buffer for the query is located.

• DeviceVcHandle
  Set to 0. Reserved for connection-oriented devices.

Return Value

None.

Remarks

None.

Requirements

See Also

Reference

Remote NDIS Messages
REMOTE_NDIS_QUERY_CMPLT
RNDIS_REQUEST_ID
RNDIS_OID