Share via

NDIS_TAPI_SET_CALL_PARAMS (Compact 2013)

  • Article

3/26/2014

The NDIS_TAPI_SET_CALL_PARAMS structure is used by OID_TAPI_SET_CALL_PARAMS when it requests the miniport driver to set certain call parameters for an existing call.

Support for this request is mandatory.

Syntax

typedef struct _NDIS_TAPI_SET_CALL_PARAMS { 
  ULONG ulRequestID; 
  HDRV_CALL hdCall; 
  ULONG ulBearerMode; 
  ULONG ulMinRate; 
  ULONG ulMaxRate; 
  BOOLEAN bSetLineDialParams; 
  LINE_DIAL_PARAMS LineDialParams; 
} NDIS_TAPI_SET_CALL_PARAMS, *PNDIS_TAPI_SET_CALL_PARAMS;

Members

  • ulRequestID
    [in] Reserved.
  • hdCall
    [in] Specifies the miniport driver's handle to the call for which the remaining parameters are to be changed.

  • ulBearerMode
    [in] Specifies the new bearer mode for the call. This member can have only one of the following LINEBEARERMODE flags set:

    • LINEBEARERMODE_VOICE
    • LINEBEARERMODE_SPEECH
    • LINEBEARERMODE_MULTIUSE
    • LINEBEARERMODE_DATA
    • LINEBEARERMODE_ALTSPEECHDATA
    • LINEBEARERMODE_NONCALLSIGNALING

  • ulMinRate
    [in] Specifies a lower bound for the call's new data rate. The value of this member is not validated by NDISTAPI before the miniport driver is called.

    This value indicates that the caller is willing to accept a new rate as low as this one.

  • ulMaxRate
    [in] Specifies an upper bound for the call's new data rate. The value of this member is not validated by NDISTAPI before the miniport driver is called.

    This value indicates the maximum data rate the caller would like.

    Equal values for the ulMinRate and ulMaxRate members indicate that the caller requires an exact rate.

  • bSetLineDialParams
    [in] Specifies whether the following dialing parameters should be used for the call. If this member is FALSE, the call's current dialing parameters should be used and the next member should be ignored.
  • LineDialParams
    [in] This structure specifies the new dial parameters for the call.

Remarks

The MiniportSetInformation function can return one of the following:

  • NDIS_STATUS_SUCCESS
  • NDIS_STATUS_PENDING
  • NDIS_STATUS_TAPI_INVALCALLHANDLE
  • NDIS_STATUS_TAPI_INVALCALLSTATE
  • NDIS_STATUS_TAPI_INVALBEARERMODE
  • NDIS_STATUS_TAPI_BEARERMODEUNAVAIL
  • NDIS_STATUS_TAPI_INVALRATE
  • NDIS_STATUS_TAPI_RATEUNAVAIL
  • NDIS_STATUS_TAPI_RESOURCEUNAVAIL
  • NDIS_STATUS_FAILURE

Requirements

Header

ndistapi.h,
ntddndis.h

See Also

Reference

NDIS 5.x Legacy Structures
OID_TAPI_SET_CALL_PARAMS
MiniportSetInformation