OID_RECEIVE_FILTER_GLOBAL_PARAMETERS

Overlying drivers issue OID query requests of OID_RECEIVE_FILTER_GLOBAL_PARAMETERS to obtain the global receive filtering parameters of a network adapter.

After a successful return from the OID query request, the InformationBuffer member of the NDIS_OID_REQUEST structure contains a pointer to an NDIS_RECEIVE_FILTER_GLOBAL_PARAMETERS structure.

Remarks

NDIS receive filters are used in the following NDIS interfaces:

Starting with NDIS 6.20, protocol drivers use OID_RECEIVE_FILTER_GLOBAL_PARAMETERS to query the current global configuration parameters for receive filtering on a network adapter. For example, protocol drivers can use this OID to determine whether types of receive filters or receive queues are enabled or disabled.

Return status codes

NDIS handles the OID query request of OID_RECEIVE_FILTER_GLOBAL_PARAMETERS for miniport drivers, and returns one of the following status codes:

NDIS_STATUS_SUCCESS

The request completed successfully.

NDIS_STATUS_PENDING

The request is pending completion. NDIS passes the final status code and results to the OID request completion handler of the caller after the request is complete.

NDIS_STATUS_INVALID_LENGTH

The information buffer was too short. NDIS set the DATA.QUERY_INFORMATION.BytesNeeded member in the NDIS_OID_REQUEST structure to the minimum buffer size that is required.

NDIS_STATUS_INVALID_PARAMETER

The request failed because it tried to enable a capability that the underlying network adapter does not support.

NDIS_STATUS_FAILURE

The request failed for other reasons.

Requirements

Version

Supported in NDIS 6.20 and later.

Header

Ntddndis.h (include Ndis.h)

See also

NDIS_OID_REQUEST
NDIS_RECEIVE_FILTER_GLOBAL_PARAMETERS

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft