structure NDIS__CAPABILITIES (ntddndis.h)
Cette structure indique les fonctionnalités d’un fournisseur.
Syntaxe
typedef struct _NDIS_PD_CAPABILITIES {
NDIS_OBJECT_HEADER Header;
ULONG Flags;
ULONG MaximumTxPartialBufferCount;
ULONG MaximumRxPartialBufferCount;
UCHAR RxFilterContextWidth;
ULONG CapabilityFlags;
ULONG MaxNumberOfRxQueues;
ULONG MaxNumberOfTxQueues;
ULONG MaxNumberOfRxQueuesForDefaultVport;
ULONG MaxNumberOfTxQueuesForDefaultVport;
ULONG MaxNumberOfRxQueuesPerNonDefaultVport;
ULONG MaxNumberOfTxQueuesPerNonDefaultVport;
ULONG ExactMatchProfileArrayOffset;
ULONG ExactMatchProfileArrayNumElements;
ULONG ExactMatchProfileArrayElementSize;
ULONG WildcardMatchProfileArrayOffset;
ULONG WildcardMatchProfileArrayNumElements;
ULONG WildcardMatchProfileArrayElementSize;
ULONG MinimumModerationInterval;
ULONG MaximumModerationInterval;
ULONG ModerationIntervalGranularity;
ULONG MaxRxQueueSize;
ULONG MaxTxQueueSize;
} NDIS_PD_CAPABILITIES;
Membres
Header
Structure NDIS_OBJECT_HEADER pour la structure NDIS__CAPABILITIES. Définissez les membres de cette structure comme suit :
- type = NDIS_OBJECT_TYPE_DEFAULT
- révision = NDIS__CAPABILITIES_REVISION_1
- taille = NDIS_SIZEOF__CAPABILITIES_REVISION_1
Flags
Ce membre est réservé et doit être défini sur 0.
MaximumTxPartialBufferCount
La transmission partielle maximale _BUFFER longueurs de chaîne prises en charge par le fournisseur.
MaximumRxPartialBufferCount
La réception partielle maximale _BUFFER longueurs de chaîne prises en charge par le fournisseur.
RxFilterContextWidth
Largeur du contexte de filtre prise en charge par le fournisseur. Un fournisseur peut prendre en charge jusqu’à 64 bits de largeur.
CapabilityFlags
Indicateurs qui contiennent des fonctionnalités supplémentaires prises en charge par le fournisseur.
| Drapeau | Description |
|---|---|
| NDIS_PD_CAPS_RECEIVE_FILTER_COUNTERS_SUPPORTED | Cet indicateur indique que le fournisseur prend en charge la création de compteurs avec le type PDCounterTypeReceiveFilter qui fait partie de l’énumération NDIS__COUNTER |
MaxNumberOfRxQueues
Nombre maximal de files d’attente de réception que le fournisseur prend en charge. Cela concerne uniquement les files d’attente créées par la routine NdisPDAllocateQueue, par conséquent, ce nombre n’est pas exact pour le client, car des files d’attente RSS préexistantes supplémentaires (que le client peut demander l’accès en mode à l’aide de la routine NdisPDOnRssReceiveQueues) ne sont pas prises en compte dans la routine NdisPDAllocateQueue.
Il est possible que les fournisseurs définissent cette valeur sur 0, s’il prend uniquement en charge les clients pour placer des files d’attente RSS préexistantes en mode à l’aide de la routine NdisPDOnRssReceiveQueues routine.
MaxNumberOfTxQueues
Le nombre maximal de files d’attente de transmission que le fournisseur peut créer à l’aide de la routine NdisPDAllocateQueue. Le fournisseur ne doit pas définir cette valeur sur 0.
MaxNumberOfRxQueuesForDefaultVport
Nombre maximal de files d’attente de réception que le fournisseur prend en charge pour le port virtuel par défaut.
MaxNumberOfTxQueuesForDefaultVport
Nombre maximal de files d’attente de transmission que le fournisseur prend en charge pour le port virtuel par défaut.
MaxNumberOfRxQueuesPerNonDefaultVport
Nombre maximal de files d’attente de réception que le fournisseur prend en charge pour les ports virtuels non par défaut.
MaxNumberOfTxQueuesPerNonDefaultVport
Nombre maximal de files d’attente de transmission que le fournisseur prend en charge pour les ports virtuels non par défaut.
ExactMatchProfileArrayOffset
Décalage de tableau pour un tableau de structures NDIS_GFP_EXACT_MATCH_PROFILE.
ExactMatchProfileArrayNumElements
Nombre d’éléments pour un tableau de structures NDIS_GFP_EXACT_MATCH_PROFILE.
ExactMatchProfileArrayElementSize
Nombre d’éléments pour un tableau de structures NDIS_GFP_EXACT_MATCH_PROFILE.
WildcardMatchProfileArrayOffset
Décalage de tableau pour un tableau de structures NDIS_GFP_WILDCARD_MATCH_PROFILE.
WildcardMatchProfileArrayNumElements
Nombre d’éléments pour un tableau de structures NDIS_GFP_WILDCARD_MATCH_PROFILE.
WildcardMatchProfileArrayElementSize
Nombre d’éléments pour un tableau de structures NDIS_GFP_WILDCARD_MATCH_PROFILE.
MinimumModerationInterval
MaximumModerationInterval
ModerationIntervalGranularity
MaxRxQueueSize
MaxTxQueueSize
Remarques
Cette structure doit être alignée sur une limite de 8 octets.
Si le fournisseur a une implémentation flexible où il prend en charge un nombre maximal de files d’attente N, où toute file d’attente peut être utilisée de manière flexible comme file d’attente Rx ou Tx, le fournisseur doit publier ~N/2 pour les valeurs MaxNumberOfRxQueues et MaxNumberOfTxQueues, car les clients créent généralement un nombre correspondant de files d’attente Rx et Tx.
Si un fournisseur peut partitionner des files d’attente Rx ou Tx de manière flexible entre les ports virtuels, il peut utiliser NDIS__QUEUE_COUNT_DYNAMIC pour le nombre maximal de ports virtuels spécifiques.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 10 |
| serveur minimum pris en charge | Windows Server 2016 |
| d’en-tête | ntddndis.h (include Ndis.h) |