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:
NDIS Packet Coalescing. For more information about how to use receive filters in this interface, see Managing Packet Coalescing Receive Filters.
Single Root I/O Virtualization (SR-IOV). For more information about how to use receive filters in this interface, see Setting a Receive Filter on a Virtual Port.
Virtual Machine Queue (VMQ). For more information about how to use receive filters in this interface, see Setting and Clearing VMQ Filters.
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) |