NDIS_TAPI_NEGOTIATE_EXT_VERSION (Windows CE 5.0)
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.
typedef struct _NDIS_TAPI_NEGOTIATE_EXT_VERSION { ULONGulRequestID;ULONGulDeviceID;ULONGulLowVersion;ULONGulHighVersion;OUT ULONGulExtVersion;} 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
OS Versions: Windows CE .NET 4.0 and later.
Header: Ntddndis.h and Ndistapi.h.
See Also
OID_TAPI_NEGOTIATE_EXT_VERSION | OID_TAPI_GET_ID | MiniportQueryInformation
Send Feedback on this topic to the authors