Skip to content

Latest commit

 

History

History
71 lines (54 loc) · 2.82 KB

nf-ndis-net_buffer_list_receive_queue_id.md

File metadata and controls

71 lines (54 loc) · 2.82 KB
UID title description tech.root ms.date keywords ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.lib req.dll req.irql req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library targetos f1_keywords topic_type api_type api_location api_name
NF:ndis.NET_BUFFER_LIST_RECEIVE_QUEUE_ID
NET_BUFFER_LIST_RECEIVE_QUEUE_ID macro (ndis.h)
The NET_BUFFER_LIST_RECEIVE_QUEUE_ID macro sets or gets the identifier of a virtual machine queue (VMQ) or single root I/O virtualization (SR-IOV) receive queue identifier within the out-of-band (OOB) data of a NET_BUFFER_LIST structure.
netvista
04/13/2018
NET_BUFFER_LIST_RECEIVE_QUEUE_ID macro
NET_BUFFER_LIST_RECEIVE_QUEUE_ID
ndis.h
Universal
Supported in NDIS 6.20 and later.
Windows
NET_BUFFER_LIST_RECEIVE_QUEUE_ID
ndis/NET_BUFFER_LIST_RECEIVE_QUEUE_ID
apiref
HeaderDef
ndis.h
NET_BUFFER_LIST_RECEIVE_QUEUE_ID

NET_BUFFER_LIST_RECEIVE_QUEUE_ID macro

-description

The NET_BUFFER_LIST_RECEIVE_QUEUE_ID macro sets or gets the identifier of a virtual machine queue (VMQ) or single root I/O virtualization (SR-IOV) receive queue identifier within the out-of-band (OOB) data of a NET_BUFFER_LIST structure.

For the SR-IOV interface, the receive queue is created on a default or nondefault virtual port (VPort). Starting with Windows Server 2012, only the default receive queue of a VPort is supported.

-parameters

-param _NBL

A pointer to a NET_BUFFER_LIST structure.

-returns

NET_BUFFER_LIST_RECEIVE_QUEUE_ID returns a USHORT value for a receive queue identifier.

-remarks

Any NDIS 6.20 or later driver can use NET_BUFFER_LIST_RECEIVE_QUEUE_ID to set or get the receive queue identifier from a NET_BUFFER_LIST structure. NET_BUFFER_LIST_RECEIVE_QUEUE_ID accesses the receive queue identifier from the QueueId member of the NDIS_NET_BUFFER_LIST_FILTERING_INFO structure.

Note

When a VMQ is deleted (for example, during VM live migration), it is possible for the miniport driver to receive an NBL that contains an invalid QueueId value. If this happens, the miniport should ignore the invalid queue ID and use 0 (the default queue) instead. The QueueId is found in the NetBufferListFilteringInfo portion of the NBL's OOB data, and is retrieved by using the NET_BUFFER_LIST_RECEIVE_QUEUE_ID macro.

-see-also

NET_BUFFER_LIST

NDIS_NET_BUFFER_LIST_FILTERING_INFO