OID_RECEIVE_FILTER_ENUM_QUEUES

Overlying drivers and user-mode applications issue object identifier (OID) query requests of OID_RECEIVE_FILTER_ENUM_QUEUES to obtain a list of all the receive queues that are allocated on 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_QUEUE_INFO_ARRAY structure that is followed by an NDIS_RECEIVE_QUEUE_INFO structure for each filter.

Remarks

NDIS obtained the information from an internal cache of the data that it received from the OID_RECEIVE_FILTER_ALLOCATE_QUEUE and OID_RECEIVE_FILTER_QUEUE_PARAMETERS OID requests.

Overlying drivers and user-mode applications issue OID query requests of OID_RECEIVE_FILTER_ENUM_QUEUES to enumerate the receive queues on a network adapter.

If a protocol driver issues the request, the request type inside the NDIS_OID_REQUEST structure is set to NdisRequestQueryInformation and this OID returns an array of all the receive queues that the protocol driver allocated on the network adapter. If a user-mode application issued the request, the request type inside the NDIS_OID_REQUEST structure is set to NdisRequestQueryStatistics, and this OID returns an array of information for all the receive queues on the network adapter.

Return Status Codes

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

Status code Description

NDIS_STATUS_SUCCESS

The request completed successfully. The InformationBuffer points to an NDIS_RECEIVE_QUEUE_INFO_ARRAY structure.

NDIS_STATUS_PENDING

The request is pending completion. NDIS will pass the final status code and results to the OID request completion handler of the caller after the request has completed.

NDIS_STATUS_INVALID_LENGTH

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

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_QUEUE_INFO

NDIS_RECEIVE_QUEUE_INFO_ARRAY

OID_RECEIVE_FILTER_ALLOCATE_QUEUE

OID_RECEIVE_FILTER_QUEUE_PARAMETERS


Send comments about this topic to Microsoft