REMOTE_NDIS_QUERY_MSG

  • Article

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.

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 Values

None.

Remarks

None.

Requirements

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

See Also

REMOTE_NDIS_QUERY_CMPLT | RNDIS_REQUEST_ID | RNDIS_OID

 Last updated on Tuesday, May 18, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.