NDIS_TAPI_CONDITIONAL_MEDIA_DETECTION (Windows Embedded CE 6.0)

1/6/2010

The NDIS_TAPI_CONDITIONAL_MEDIA_DETECTION structure is used by NDISTAPI when it makes an OID_TAPI_CONDITIONAL_MEDIA_DETECTION request to the WAN protocol driver. The WAN protocol driver passes the request to WAN miniport drivers whenever a client application uses LINEMAPPER as the dwDeviceID in the lineOpen function to request that lines be scanned to find one that supports the desired media mode(s) and call parameters.

NDISTAPI scans based on the union of the desired media modes and the other media modes currently being monitored on the line, to give each WAN miniport driver the opportunity to indicate whether it can simultaneously monitor for all of the requested media modes.

Support for this request is mandatory.

Syntax

typedef struct _NDIS_TAPI_CONDITIONAL_MEDIA_DETECTION { 
  ULONG ulRequestID; 
  HDRV_LINE hdLine; 
  ULONG ulMediaModes; 
  LINE_CALL_PARAMS LineCallParams; 
} NDIS_TAPI_CONDITIONAL_MEDIA_DETECTION, 
*PNDIS_TAPI_CONDITIONAL_MEDIA_DETECTION; 

Members

• ulRequestID
  [in] Reserved.

• hdLine
  [in] Specifies the miniport driver's handle to the line on which media monitoring and parameter capabilities are to be set.

• ulMediaModes
  [in] Specifies the media mode(s) currently of interest to the calling application. This parameter uses the LINEMEDIAMODE constants.

• LineCallParams
  [in] The LINE_CALL_PARAMS structure specifies information that the line device should provide. The only relevant members for the purpose of this request are the following:

  • ULONG ulBearerMode
  • ULONG ulMinRate
  • ULONG ulMaxRate
  • ULONG ulMediaMode
  • ULONG ulCallParamFlags
  • ULONG ulAddressMode

  If the value of ulAddressMode is LINEADDRESSMODE_ADDRESSID, any address on the line is acceptable. Otherwise, the value of ulAddressMode is LINEADDRESSMODE_DIALABLEADDR, indicating either that the miniport driver should search for a specific originating address (phone number), or, if it is a provider-specific extension, the ulOrigAddressSize/Offset and the ulDevSpecificSize/Offset values are also relevant. All other members of the LINE_CALL_PARAMS structure are irrelevant to this object identifier request.

Remarks

The MiniportSetInformation function can return one of the following:

• NDIS_STATUS_SUCCESS
• NDIS_STATUS_PENDING
• NDIS_STATUS_TAPI_INVALLINEHANDLE
• NDIS_STATUS_TAPI_NODRIVER
• NDIS_STATUS_TAPI_RESOURCEUNAVAIL
• NDIS_STATUS_TAPI_INVALMEDIAMODE
• NDIS_STATUS_FAILURE

If a miniport driver can monitor for the specified set of media modes and support the capabilities specified in CallParams, it completes the request with NDIS_STATUS_SUCCESS, but it leaves the active media monitoring modes for the line unchanged.

Requirements

See Also

Reference

NDIS Structures
OID_TAPI_CONDITIONAL_MEDIA_DETECTION
MiniportSetInformation