NDIS_RECEIVE_QUEUE_INFO Struktur (ntddndis.h)
Die NDIS_RECEIVE_QUEUE_INFO-Struktur enthält Informationen zu einer Empfangswarteschlange auf einem Netzwerkadapter.
typedef struct _NDIS_RECEIVE_QUEUE_INFO {
NDIS_OBJECT_HEADER Header;
ULONG Flags;
NDIS_RECEIVE_QUEUE_TYPE QueueType;
NDIS_RECEIVE_QUEUE_ID QueueId;
NDIS_RECEIVE_QUEUE_GROUP_ID QueueGroupId;
NDIS_RECEIVE_QUEUE_OPERATIONAL_STATE QueueState;
GROUP_AFFINITY ProcessorAffinity;
ULONG NumSuggestedReceiveBuffers;
ULONG MSIXTableEntry;
ULONG LookaheadSize;
NDIS_VM_NAME VmName;
NDIS_QUEUE_NAME QueueName;
ULONG NumFilters;
ULONG InterruptCoalescingDomainId;
} NDIS_RECEIVE_QUEUE_INFO, *PNDIS_RECEIVE_QUEUE_INFO;
Header
Der Typ, die Überarbeitung und die Größe der NDIS_RECEIVE_QUEUE_INFO Struktur. Dieses Element ist als NDIS_OBJECT_HEADER Struktur formatiert.
Der Miniporttreiber muss den Type Member von Header- auf NDIS_OBJECT_TYPE_DEFAULT festlegen. Um die Version der NDIS_RECEIVE_QUEUE_INFO-Struktur anzugeben, muss der Treiber das element RevisionHeader- auf einen der folgenden Werte festlegen:
Zusätzliche Mitglieder für NDIS 6.30 hinzugefügt.
Legen Sie das element Size auf NDIS_SIZEOF_RECEIVE_QUEUE_INFO_REVISION_2fest.
Originalversion für NDIS 6.20.
Legen Sie das Size Member auf NDIS_SIZEOF_RECEIVE_QUEUE_INFO_REVISION_1fest.
Flags
Ein ULONG--Wert, der ein bitweises ODER- von Flags enthält. Dieses Mitglied ist für NDIS reserviert.
QueueType
Ein NDIS_RECEIVE_QUEUE_TYPE Enumerationswert, der den Typ der Empfangswarteschlange angibt.
QueueId
Ein NDIS_RECEIVE_QUEUE_ID Typwert, der einen Empfangswarteschlangenbezeichner enthält. Dieser Bezeichner ist ein ganzzahliger Wert zwischen Null und der Anzahl der Warteschlangen, die der Netzwerkadapter unterstützt. Ein Wert von NDIS_DEFAULT_RECEIVE_QUEUE_ID gibt die Standard-Empfangswarteschlange an.
QueueGroupId
Dieses Mitglied ist für NDIS reserviert.
QueueState
Ein NDIS_RECEIVE_QUEUE_OPERATIONAL_STATE Enumerationswert, der den Betriebszustand der Empfangswarteschlange angibt.
ProcessorAffinity
Eine GROUP_AFFINITY Bitmap, die die CPU angibt, mit der die Warteschlange Affinität hat. Das Festlegen von Bit 0 gibt beispielsweise an, dass CPU 0 verwendet wird, das Festlegen von Bit 1 angibt, dass CPU 1 verwendet wird usw. Da eine VM-Warteschlange einer CPU zugeordnet ist, werden alle Empfangsanzeigen für die Warteschlange auf diesem Prozessor behandelt.
NumSuggestedReceiveBuffers
Ein ULONG- Wert, der einen vorgeschlagenen Wert für die Anzahl der Empfangspuffer enthält, die der Netzwerkadapter zur Unterstützung der Warteschlange verwenden soll. Diese Zahl kann relativ zu den Ressourcen angepasst werden, die der Miniporttreiber verfügbar hat, oder proportional zur Anzahl, die der Netzwerkadapter für andere Warteschlangen verwendet. Die tatsächliche Anzahl der Empfangspuffer kann z. B. doppelt oder die Hälfte dieses vorgeschlagenen Werts sein.
MSIXTableEntry
Ein ULONG--Wert, der den MSI-X Tabelleneintragsindex für die Warteschlange enthält.
LookaheadSize
Ein ULONG- Wert für die Größe der Suchkopfgröße in Byte für diese Warteschlange. Ein Netzwerkadapter, der Lookahead in VM-Warteschlangen unterstützt, teilt ein empfangenes Paket an einem Offset, der der angeforderten Lookaheadgröße entspricht oder größer ist, und verwendet DMA, um die Lookahead-Daten und die Daten nach dem Lookahead in separate freigegebene Speichersegmente zu übertragen.
VmName
Ein NDIS_VM_NAME Wert, der die benutzerfreundliche Beschreibung des virtuellen Computers enthält.
QueueName
Ein NDIS_QUEUE_NAME Wert, der die benutzerfreundliche Beschreibung der Warteschlange enthält.
NumFilters
Ein ULONG-Wert, der die Anzahl der Empfangenfilter angibt, die auf dem Netzwerkadapter konfiguriert wurden.
InterruptCoalescingDomainId
Ein ULONG-Wert, der für die Verwendung durch NDIS reserviert ist. Dieser Wert wird für Informationszwecke vom Miniporttreiber verwendet.
Die NDIS_RECEIVE_QUEUE_INFO-Struktur wird mit der NDIS_RECEIVE_QUEUE_INFO_ARRAY Struktur für die OID_RECEIVE_FILTER_ENUM_QUEUES OID, das Empfangswarteschlangen auf einem Netzwerkadapter aufzählt.
Mit einer erfolgreichen Rückgabe vom OID_RECEIVE_FILTER_ENUM_QUEUESstellt NDIS eine NDIS_RECEIVE_QUEUE_INFO_ARRAY Struktur bereit, die die Eigenschaften des Empfangswarteschlangenarrays definiert. Jedes Element im Array ist eine NDIS_RECEIVE_QUEUE_INFO Struktur.
Anforderung | Wert |
---|---|
mindestens unterstützte Client- | Unterstützt in NDIS 6.20 und höher. |
Header- | ntddndis.h (include Ndis.h) |
OID_RECEIVE_FILTER_CLEAR_FILTER