Handling Queries in an NDIS WAN Miniport Driver (NDIS 5.1)
Note NDIS 5. x has been deprecated and is superseded by NDIS 6. x. For new NDIS driver development, see Network Drivers Starting with Windows Vista. For information about porting NDIS 5. x drivers to NDIS 6. x, see Porting NDIS 5.x Drivers to NDIS 6.0.
An upper-layer driver calls NdisRequestwith a query request to determine WAN-specific capabilities and current status of an NDIS WAN miniport driver and the miniport driver's NIC. The NDISWAN intermediate driver forwards the query request, which causes NDIS to call the WAN miniport driver's MiniportQueryInformationfunction. In an NDIS WAN miniport driver, this function is the same as in a non-WAN connectionless miniport driver, except that the WAN miniport driver recognizes standard WAN OIDs. For more information about standard WAN OIDs, see Standard WAN Objects.
If the WAN miniport driver completes MiniportQueryInformationasynchronously by returning a status of NDIS_STATUS_PENDING, it must complete the query later by calling NdisMQueryInformationComplete.
An NDIS WAN miniport driver must handle standard WAN OIDs. The standard WAN query OIDs are summarized in the following table.
Name | Optional or Required |
---|---|
OID_WAN_PERMANENT_ADDRESS Permanent station address | Required |
OID_WAN_CURRENT_ADDRESS Current station address | Required |
OID_WAN_MEDIUM_SUBTYPE Medium subtype | Required |
OID_WAN_GET_INFO Get information | Required |
OID_WAN_GET_LINK_INFO Get link information | Required |
OID_WAN_GET_STATS_INFO Get statistics information | Optional |
In addition to handling the standard WAN OIDs, an NDIS WAN miniport driver handles queries to the NDIS General Objects. For more information about querying miniport drivers, see Querying a Connectionless Miniport Driver.