OID_TAPI_SET_CALL_PARAMS

The OID_TAPI_SET_CALL_PARAMS OID requests the miniport driver to set certain call parameters for an existing call.

Support for this request is mandatory.

This request uses an NDIS_TAPI_SET_CALL_PARAMS structure, defined as follows:

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

The members of this structure contain the following information:

• ulRequestID
  Reserved.

• hdCall
  Specifies the miniport driver's handle to the call for which the following parameters are to be changed.

• ulBearerMode
  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
  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
  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
  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
  This structure specifies the new dial parameters for the call. For more information, see ndistapi.h.

The MiniportSetInformationfunction 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

 

 

Send comments about this topic to Microsoft