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) |