This documentation is archived and is not being maintained.

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

Show: