This documentation is archived and is not being maintained.

OID_TAPI_NEGOTIATE_EXT_VERSION

The OID_TAPI_NEGOTIATE_EXT_VERSION OID 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.

This request uses an NDIS_TAPI_NEGOTIATE_EXT_VERSION structure, defined as follows:



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


The members of this structure contain the following information:

ulRequestID

Reserved.

ulDeviceID

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

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

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

Specifies the miniport driver's extension version within the range specified by ulLowVersion and ulHighVersion. The most significant two bytes specifiy 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.

The MiniportQueryInformationfunction 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

 

 

Send comments about this topic to Microsoft

Show: