OID_TAPI_SET_MEDIA_MODE

The OID_TAPI_SET_MEDIA_MODE OID requests the miniport driver to change a call's media mode as stored in the LINE_CALL_INFO structure for that call. For information about the declaration of LINE_CALL_INFO, see ndistapi.h.

Support for this request is mandatory.

This request uses an NDIS_TAPI_SET_MEDIA_MODE structure, defined as follows:

typedef struct _NDIS_TAPI_SET_MEDIA_MODE {         
         IN ULONG ulRequestID;
         IN HDRV_CALL hdCall;
         IN ULONG ulMediaMode;
 } NDIS_TAPI_SET_MEDIA_MODE, *PNDIS_TAPI_SET_MEDIA_MODE;

The members of this structure contain the following information:

  • ulRequestID
    Reserved.

  • hdCall
    Specifies the miniport driver's handle to the call for which it should change the media mode.

  • ulMediaMode
    Specifies the new media mode(s) for the call as one or more of the LINEMEDIAMODE_XXX flags.

    If the LINEMEDIAMODE_UNKNOWN flag is set, other media mode flags also can be set. Such a combination of flags specifies that the call's media mode is not fully determined, but that it has been narrowed down to a subset of possible media modes. If the LINEMEDIAMODE_UNKNOWN flag is clear, only a single media mode can be specified.

The MiniportSetInformationfunction can return one of the following:

NDIS_STATUS_SUCCESS

NDIS_STATUS_PENDING

NDIS_STATUS_TAPI_INVALCALLHANDLE

NDIS_STATUS_TAPI_INVALMEDIAMODE

NDIS_STATUS_TAPI_RESOURCEUNAVAIL

NDIS_STATUS_FAILURE

 

 

Send comments about this topic to Microsoft