NDIS_TAPI_NEGOTIATE_EXT_VERSION (Windows Embedded CE 6.0)

  • Article

1/6/2010

The NDIS_TAPI_NEGOTIATE_EXT_VERSION structure is used by OID_TAPI_NEGOTIATE_EXT_VERSION when it requests the miniport driver to return the highest version extension number the miniport driver is willing to operate under for this device, given the range of possible extension versions.

Support for this request is optional.

Syntax

typedef struct _NDIS_TAPI_NEGOTIATE_EXT_VERSION { 
  ULONG ulRequestID; 
  ULONG ulDeviceID; 
  ULONG ulLowVersion; 
  ULONG ulHighVersion; 
  OUT ULONG ulExtVersion; 
} NDIS_TAPI_NEGOTIATE_EXT_VERSION, *PNDIS_TAPI_NEGOTIATE_EXT_VERSION;

Members

  • ulRequestID
    [in] Reserved.
  • ulDeviceID
    [in] Specifies the link or data channel for which the extension version negotiation is to be performed. The value INITIALIZE_NEGOTIATION cannot be used. This was set up in a preceding OID_TAPI_GET_ID request.
  • ulLowVersion
    [in] Specifies the lowest extension version under which NDISTAPI or its client application will operate. The most significant two bytes specify the major version and the least significant two bytes specify the minor version. The value of this member is not validated by NDISTAPI when this request is made.
  • ulHighVersion
    [in] Specifies the highest extension version under which NDISTAPI or its client application will operate. The most significant two bytes specify the major version and the least significant two bytes specify the minor version. The value of this member is not validated by NDISTAPI when this request is made.

  • ulExtVersion
    [out] Specifies the miniport driver's extension version within the range specified by ulLowVersion and ulHighVersion. The most significant two bytes specify the major version and the least significant two bytes specify the minor version.

    The miniport driver fills this member with the highest extension version number, within the range requested by the caller, under which it is willing to operate to complete this request successfully.

    If the requested range specified in ulLowVersion and ulHighVersion does not overlap the range supported by the miniport driver, it returns NDIS_STATUS_TAPI_INCOMPATIBLEEXTVERSION.

Remarks

The MiniportQueryInformation function can return one of the following:

  • NDIS_STATUS_SUCCESS
  • NDIS_STATUS_PENDING
  • NDIS_STATUS_TAPI_INCOMPATIBLEEXTVERSION
  • NDIS_STATUS_TAPI_NODRIVER
  • NDIS_STATUS_TAPI_RESOURCEUNAVAIL
  • NDIS_STATUS_FAILURE

Requirements

Header ndistapi.h, ntddndis.h
Windows Embedded CE Windows CE .NET 4.0 and later

See Also

Reference

NDIS Structures
OID_TAPI_NEGOTIATE_EXT_VERSION
OID_TAPI_GET_ID
MiniportQueryInformation