Previous Next

TdiQueryInformation

The TdiQueryInformation function is called through the TdiQueryInformationEntry pointer in the TdiDispatchTable structure.

TDI_STATUS
  TdiQueryInformation( PTDI_REQUEST Request, 
    uint  QueryType, 
    PNDIS_BUFFER  Buffer, 
    uint  *BufferSize, 
    uint  IsConn
    );

Parameters

QueryType
Indicates which information is being queried. The following values are supported.
Value Description
TDI_QUERY_PROVIDER_INFO Queries the transport about provider information. A structure of type TDI_PROVIDER_INFO (see TDI.H) will be copied into the buffer chain pointed to by Buffer.
TDI_QUERY_ADDRESS_INFO Queries the transport about the local transport of an address object or connection. The query is for a connection if IsConn is TRUE (nonzero), and for an address object if IsConn is FALSE (zero). The address object or connection being queried is specified by Request->Handle. A structure of type TDI_ADDRESS_INFO (see TDI.H) will be copied into the buffer chain pointed to by Buffer.
TDI_QUERY_CONNECTION_INFO Queries MSTCP for information about the connection identified by Request->Handle.ConnectionContext. A structure of type TDI_CONNECTION_INFO (see TDI.H) will be copied into the buffer chain pointed to by Buffer.
TDI_QUERY_PROVIDER_STATISTICS Queries the transport for certain statistics. Not all the defined statistics are kept by MSTCP. A structure of type TDI_PROVIDER_STATISTICS (see TDI.H) will be copied into the buffer chain pointed to by Buffer.

Buffer
Points to an NDIS_BUFFER chain into which the information is copied.
BufferSize
Points to the size of the input buffer chain in bytes. On return, BufferSize is set to the size of the information copied into Buffer. If the NDIS_BUFFER chain pointed to by Buffer is too small to contain the requested data, only the amount that fits is copied and TDI_BUFFER_OVERFLOW is returned.
IsConn
Boolean used to provide additional information for the TDI_QUERY_ADDRESS_INFO call. If IsConn is nonzero, than information about a connection is returned. If IsConn is zero, information about an address object is returned.