OID_RECEIVE_FILTER_ENUM_QUEUES
Le dépassement des pilotes et des applications en mode utilisateur émet des requêtes d’identificateur d’objet (OID) de OID_RECEIVE_FILTER_ENUM_QUEUES pour obtenir la liste de toutes les files d’attente de réception allouées sur une carte réseau.
Après un retour réussi de la requête OID, le membre InformationBuffer de la structure NDIS_OID_REQUEST contient un pointeur vers une structure NDIS_RECEIVE_QUEUE_INFO_ARRAY suivie d’une structure NDIS_RECEIVE_QUEUE_INFO pour chaque filtre.
Remarques
NDIS a obtenu les informations d’un cache interne des données qu’il a reçues de la OID_RECEIVE_FILTER_ALLOCATE_QUEUE et OID_RECEIVE_FILTER_QUEUE_PARAMETERS demandes OID.
Le dépassement des pilotes et des applications en mode utilisateur émet des requêtes OID de OID_RECEIVE_FILTER_ENUM_QUEUES pour énumérer les files d’attente de réception sur une carte réseau.
Si un pilote de protocole émet la requête, le type de requête à l’intérieur de la structure NDIS_OID_REQUEST est défini sur NdisRequestQueryInformation et cet OID retourne un tableau de toutes les files d’attente de réception allouées par le pilote de protocole sur la carte réseau. Si une application en mode utilisateur a émis la requête, le type de requête à l’intérieur de la structure NDIS_OID_REQUEST est défini sur NdisRequestQueryStatistics, et cet OID retourne un tableau d’informations pour toutes les files d’attente de réception sur la carte réseau.
Codes d’état de retour
NDIS gère la requête de requête OID de OID_RECEIVE_FILTER_ENUM_QUEUES pour les pilotes miniports et retourne l’un des codes d’état suivants.
| Code d’état | Description |
|---|---|
NDIS_STATUS_SUCCESS |
La demande s’est terminée avec succès. Le InformationBuffer pointe vers une structure NDIS_RECEIVE_QUEUE_INFO_ARRAY. |
NDIS_STATUS_PENDING |
La requête est en attente d’achèvement. NDIS transmet le code d’état final et les résultats au gestionnaire d’achèvement de la demande OID de l’appelant une fois la demande terminée. |
NDIS_STATUS_INVALID_LENGTH |
La mémoire tampon d’informations était trop courte. NDIS définit le DATA.METHOD_INFORMATION.membre BytesNeededed dans la structure NDIS_OID_REQUEST à la taille minimale de mémoire tampon requise. |
NDIS_STATUS_FAILURE |
La demande a échoué pour d’autres raisons. |
Exigences
Version |
Pris en charge dans NDIS 6.20 et versions ultérieures. |
En-tête |
Ntddndis.h (include Ndis.h) |