MacQueryGlobalStatistics

MacQueryGlobalStatistics

NDIS_STATUS
   MacQueryGlobalStatistics(
       IN NDIS_HANDLE MacAdapterContext,
       IN PNDIS_REQUEST NdisRequest
       );

MacQueryGlobalStatistics is called by NDIS to query current NIC driver statistics in the MIB that the network interface card supports.

Parameters

MacAdapterContext

Specifies the context that the driver associates with its NIC.

NdisRequest

Points to a request structure that defines the query.

Return Value

MacQueryGlobalStatistics can return the following status codes:

NDIS_STATUS_INVALID_LENGTH
NDIS_STATUS_INVALID_OID
NDIS_STATUS_PENDING
NDIS_STATUS_SUCCESS

Comments

MacQueryGlobalStatistics allows the NDIS library to make calls on behalf of a network-management entity instead of a particular protocol driver bound to the network interface card.

Calls to MacQueryGlobalStatistics use the same OIDs as calls to MacRequest for the corresponding local query. For global queries, the OIDs identify the MIB. For a complete description of NDIS OIDs, see Part I.

MacQueryGlobalStatistics cannot call NdisCompleteRequest because a global statistics query is not specific to any particular bound protocol driver.

If MacQueryGlobalStatistics returns NDIS_STATUS_PENDING, it is asynchronous and the statistics query requires postprocessing. To initiate this postprocessing, the NIC driver later calls NdisCompleteQueryStatistics.

MacQueryGlobalStatistics runs at IRQL <= DISPATCH_LEVEL, usually at PASSIVE_LEVEL during initialization.