Partager via

REMOTE_NDIS_QUERY_MSG (Compact 2013)

  • Article

3/26/2014

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

Header

rndis.h

See Also

Reference

Remote NDIS Messages
REMOTE_NDIS_QUERY_CMPLT
RNDIS_REQUEST_ID
RNDIS_OID